Contains classes that support connections between devices that are within close range.
The Windows.Networking.Proximity namespace has these types of members:
The Windows.Networking.Proximity namespace has these classes.
|ConnectionRequestedEventArgs||Contains properties that are passed to an application with the ConnectionRequested event.|
|PeerFinder||Enables you to discover other instances of your app on nearby devices and create a socket connection between the peer apps by using a tap gesture or by browsing.|
|PeerInformation||Contains information that identifies a peer.|
|PeerWatcher||Dynamically discovers peer apps within wireless range.|
|ProximityDevice||Enables you to publish messages to proximate devices or subscribe to messages from proximate devices.|
|ProximityMessage||Represents a message that's received from a subscription.|
|TriggeredConnectionStateChangedEventArgs||Contains properties that the TriggeredConnectionStateChanged event passes to an application.|
The Windows.Networking.Proximity namespace has these delegates.
|DeviceArrivedEventHandler||Describes the method that handles the DeviceArrived event.|
|DeviceDepartedEventHandler||Describes the method that handles the DeviceDeparted event.|
|MessageReceivedHandler||Describes the method that will handle the event that's fired when a message that has been subscribed to has been received.|
|MessageTransmittedHandler||Describes the method that will handle the event that's fired when a published message has been transmitted.|
The Windows.Networking.Proximity namespace has these enumerations.
|PeerDiscoveryTypes||Indicates which discovery options are available to use with the PeerFinder class.|
|PeerRole||Describes the role of the peer app when connected to multiple peers.|
|PeerWatcherStatus||Describes the status of a PeerWatcher object.|
|TriggeredConnectState||Indicates the current state of a connection to a peer application.|
You can use proximity to connect computers by using a simple tap gesture. If two computers come within 3 centimeters to 4 centimeters of each other, or are tapped together, the operating system of each computer detects the other computer. You can then connect the two computers to share content or publish and subscribe to messages. Proximity also supports discovery of peer devices via Wi-Fi Direct.
The proximity APIs do not provide authentication, encryption, or message integrity. Do not use proximity to exchange user sensitive information such as passwords, financial data, text messages, email, photographs, or government id numbers.
This example shows how you can use the ProximityDevice class to determine when a device enters and leaves proximity.
Dim proximityDevice As Windows.Networking.Proximity.ProximityDevice Private Sub InitializeProximityDevice() proximityDevice = Windows.Networking.Proximity.ProximityDevice.GetDefault() If proximityDevice IsNot Nothing Then AddHandler proximityDevice.DeviceArrived, AddressOf ProximityDeviceArrived AddHandler proximityDevice.DeviceDeparted, AddressOf ProximityDeviceDeparted WriteMessageText("Proximity device initialized." & vbTab) Else WriteMessageText("Failed to initialized proximity device." & vbTab) End If End Sub Private Sub ProximityDeviceArrived(device As Windows.Networking.Proximity.ProximityDevice) WriteMessageText("Proximate device arrived. id = " & device.DeviceId & vbTab) End Sub Private Sub ProximityDeviceDeparted(device As Windows.Networking.Proximity.ProximityDevice) WriteMessageText("Proximate device departed. id = " & device.DeviceId & vbTab) End Sub ' Write a message to MessageBlock on the UI thread. Private Async Sub WriteMessageText(message As String, Optional overwrite As Boolean = False) Await Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, Sub() If overwrite Then MessageBlock.Text = message Else MessageBlock.Text &= message End If End Sub) End Sub
Minimum supported client
Minimum supported server
|Windows Server 2012|
Minimum supported phone
|Windows Phone 8|