/// <summary> /// Starts receiving presence events. /// </summary> /// <since_tizen> 3 </since_tizen> /// <remarks> /// <para>Sends request to receive presence to an interested server's resource with resourceType. /// If succeeded, <see cref="PresenceReceived"/> event handler will be triggered when the server sends presence. /// A server sends presence events when adds / removes / alters a resource or start / stop presence.</para> /// <para><paramref name="hostAddress" /> could be <see cref="MulticastAddress"/> for IPv4 multicast. /// The length of <paramref name="resourceType" /> should be less than or equal to 61. /// The <paramref name="resourceType" /> must start with a lowercase alphabetic character, followed by a sequence /// of lowercase alphabetic, numeric, ".", or "-" characters, and contains no white space.</para> /// </remarks> /// <privilege>http://tizen.org/privilege/internet</privilege> /// <privlevel>public</privlevel> /// <param name="hostAddress">The address or addressable name of the server.</param> /// <param name="resourceType">A resource type that a client is interested in.</param> /// <returns>PresenceId - An identifier for this request.</returns> /// <feature>http://tizen.org/feature/iot.ocf</feature> /// <pre>Initialize() should be called to initialize.</pre> /// <post> /// When the resource receive presence, <see cref="PresenceReceived"/> event handler will be invoked.<br/> /// You must destroy presence by calling StopReceivingPresence() if presence event is no longer needed. /// </post> /// <seealso cref="IoTConnectivityServerManager.StartSendingPresence(uint)"/> /// <seealso cref="IoTConnectivityServerManager.StopSendingPresence()"/> /// <seealso cref="StopReceivingPresence(int)"/> /// <seealso cref="PresenceReceived"/> /// <exception cref="NotSupportedException">Thrown when the iotcon is not supported.</exception> /// <exception cref="ArgumentException">Thrown when there is an invalid parameter.</exception> /// <exception cref="InvalidOperationException">Thrown when the operation is invalid.</exception> /// <exception cref="UnauthorizedAccessException">Thrown when an application does not have privilege to access.</exception> /// <exception cref="OutOfMemoryException">Thrown when there is not enough memory.</exception> /// <example><code><![CDATA[ /// EventHandler<PresenceReceivedEventArgs> handler = (sender, e) => { /// Console.Log("PresenceReceived, presence id :" + e.PresenceId); /// } /// EventHandler<FindingErrorOccurredEventArgs> errorHandler = (sender, e) => { /// Console.Log("Found error :" + e.Error.Message); /// } /// IoTConnectivityClientManager.PresenceReceived += handler; /// IoTConnectivityClientManager.FindingErrorOccurred += errorHandler; /// // Do not forget to remove these event handlers when they are not required any more. /// int id = IoTConnectivityClientManager.StartReceivingPresence(IoTConnectivityClientManager.MulticastAddress, "oic.iot.door"); /// ]]></code></example> public static int StartReceivingPresence(string hostAddress, string resourceType) { Interop.IoTConnectivity.Client.RemoteResource.ConnectivityType connectivityType = Interop.IoTConnectivity.Client.RemoteResource.ConnectivityType.Ip; if (resourceType != null && !ResourceTypes.IsValid(resourceType)) { Log.Error(IoTConnectivityErrorFactory.LogTag, "Invalid type"); throw new ArgumentException("Invalid type"); } IntPtr id = IntPtr.Zero; lock (s_presenceCallbacksMap) { id = (IntPtr)s_presenceListenerId++; } s_presenceCallbacksMap[id] = (IntPtr presence, int result, IntPtr presenceResponseHandle, IntPtr userData) => { int presenceId = (int)userData; if (result == (int)IoTConnectivityError.None) { if (presenceResponseHandle != IntPtr.Zero) { PresenceReceivedEventArgs e = GetPresenceReceivedEventArgs(presenceId, presenceResponseHandle); if (e == null) { Log.Error(IoTConnectivityErrorFactory.LogTag, "Can't get PresenceReceivedEventArgs"); return; } PresenceReceived?.Invoke(null, e); } else { Log.Error(IoTConnectivityErrorFactory.LogTag, "Handle is null"); return; } } else { FindingErrorOccurredEventArgs e = GetFindingErrorOccurredEventArgs(presenceId, result); FindingErrorOccurred?.Invoke(null, e); } }; IntPtr presenceHandle; int errorCode = Interop.IoTConnectivity.Client.Presence.AddPresenceCb(hostAddress, (int)connectivityType, resourceType, s_presenceCallbacksMap[id], id, out presenceHandle); if (errorCode != (int)IoTConnectivityError.None) { Log.Error(IoTConnectivityErrorFactory.LogTag, "Failed to register presence event handler"); lock (s_presenceCallbacksMap) { s_presenceCallbacksMap.Remove(id); } throw IoTConnectivityErrorFactory.GetException(errorCode); } lock (s_presenceHandlesMap) { s_presenceHandlesMap[id] = presenceHandle; } return((int)id); }
/// <summary> /// Creates a remote resource instance. /// </summary> /// <since_tizen> 3 </since_tizen> /// <remarks> /// <para>To use this API, you should provide all the details required to correctly contact and /// observe the object.</para> /// <para>If not, you should discover the resource object manually.</para> /// <para>The <paramref name="policy" /> can contain multiple policies like <c>ResourcePolicy.Discoverable | ResourcePolicy.Observable</c>.</para> /// </remarks> /// <param name="hostAddress">The host address of the resource.</param> /// <param name="uriPath">The URI path of the resource.</param> /// <param name="policy">The policies of the resource.</param> /// <param name="resourceTypes">The resource types of the resource.</param> /// <param name="resourceInterfaces">The resource interfaces of the resource.</param> /// <feature>http://tizen.org/feature/iot.ocf</feature> /// <exception cref="NotSupportedException">Thrown when the iotcon is not supported.</exception> /// <exception cref="OutOfMemoryException">Thrown when there is not enough memory.</exception> /// <exception cref="ArgumentException">Thrown when there is an invalid parameter.</exception> public RemoteResource(string hostAddress, string uriPath, ResourcePolicy policy, ResourceTypes resourceTypes, ResourceInterfaces resourceInterfaces) { if (hostAddress == null || uriPath == null || resourceTypes == null || resourceInterfaces == null) { Log.Error(IoTConnectivityErrorFactory.LogTag, "Invalid parameters"); throw new ArgumentException("Invalid parameter"); } HostAddress = hostAddress; UriPath = uriPath; Policy = policy; Types = new List <string>(resourceTypes); Interfaces = new List <string>(resourceInterfaces); DeviceId = null; CreateRemoteResource(resourceTypes._resourceTypeHandle, resourceInterfaces.ResourceInterfacesHandle); }