Compartir a través de


Windows.Networking.Proximity Espacio de nombres

Contiene clases que admiten conexiones entre dispositivos que están dentro del intervalo de cierre.

Clases

ConnectionRequestedEventArgs

Contiene propiedades que se pasan a una aplicación con el evento ConnectionRequested .

PeerFinder

Permite detectar otras instancias de la aplicación en dispositivos cercanos y crear una conexión de socket entre las aplicaciones del mismo nivel mediante un gesto de pulsación o mediante la exploración. Para crear conexiones de socket Bluetooth en Windows 8.1 y versiones posteriores, use Windows.Devices.Bluetooth.Rfcomm en su lugar.

PeerInformation

Contiene información que identifica un elemento del mismo nivel.

PeerWatcher

Detecta dinámicamente las aplicaciones del mismo nivel dentro del intervalo inalámbrico.

ProximityDevice

Permite publicar mensajes en dispositivos proxy o suscribirse a mensajes de dispositivos proxy.

ProximityMessage

Representa un mensaje recibido de una suscripción.

TriggeredConnectionStateChangedEventArgs

Contiene propiedades que el evento TriggeredConnectionStateChanged pasa a una aplicación.

Enumeraciones

PeerDiscoveryTypes

Indica qué opciones de detección están disponibles para usarse con la clase PeerFinder .

PeerRole

Describe el rol de la aplicación del mismo nivel cuando se conecta a varios sistemas del mismo nivel.

PeerWatcherStatus

Describe el estado de un objeto PeerWatcher .

TriggeredConnectState

Indica el estado actual de una conexión a una aplicación del mismo nivel.

Delegados

DeviceArrivedEventHandler

Describe el método que controla el evento DeviceArrived .

DeviceDepartedEventHandler

Describe el método que controla el evento DeviceDeparted .

MessageReceivedHandler

Describe el método que controlará el evento que se desencadena cuando se ha recibido un mensaje al que se ha suscrito.

MessageTransmittedHandler

Describe el método que controlará el evento que se desencadena cuando se transmite un mensaje publicado.

Ejemplos

En este ejemplo se muestra cómo se puede usar la clase ProximityDevice para determinar cuándo un dispositivo entra y sale de la proximidad.

Windows.Networking.Proximity.ProximityDevice proximityDevice;

private void InitializeProximityDevice()
{
    proximityDevice = Windows.Networking.Proximity.ProximityDevice.GetDefault();

    if (proximityDevice != null) {
        proximityDevice.DeviceArrived += ProximityDeviceArrived;
        proximityDevice.DeviceDeparted += ProximityDeviceDeparted;

        WriteMessageText("Proximity device initialized.\n");
    }
    else
    {
        WriteMessageText("Failed to initialized proximity device.\n");
    }
}

private void ProximityDeviceArrived(Windows.Networking.Proximity.ProximityDevice device)
{
    WriteMessageText("Proximate device arrived. id = " + device.DeviceId + "\n");
}

private void ProximityDeviceDeparted(Windows.Networking.Proximity.ProximityDevice device)
{
    WriteMessageText("Proximate device departed. id = " + device.DeviceId + "\n");
}

// Write a message to MessageBlock on the UI thread.
private Windows.UI.Core.CoreDispatcher messageDispatcher = Window.Current.CoreWindow.Dispatcher;

async private void WriteMessageText(string message, bool overwrite = false)
{
    await messageDispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal,
        () =>
        {
            if (overwrite)
                MessageBlock.Text = message;
            else
                MessageBlock.Text += message;
        });
}
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

Comentarios

Puede usar la proximidad para conectar equipos mediante un simple gesto de pulsación. Si dos equipos vienen dentro de 3 centímetros a 4 centímetros entre sí, o se pulsan juntos, el sistema operativo de cada equipo detecta el otro equipo. Después, puede conectar los dos equipos para compartir contenido o publicar y suscribirse a mensajes. La proximidad también admite la detección de dispositivos del mismo nivel a través de Wi-Fi Direct.

Importante

Las API de proximidad no proporcionan autenticación, cifrado ni integridad de mensajes. No use la proximidad para intercambiar información confidencial del usuario, como contraseñas, datos financieros, mensajes de texto, correo electrónico, fotografías o números de identificación gubernamentales.

Consulte también