Share via

Windows.Networking.Proximity Namespace

  • Referência
Editar

Contém classes que dão suporte a conexões entre dispositivos que estão ao alcance próximo.

Classes

ConnectionRequestedEventArgs

Contém propriedades que são passadas para um aplicativo com o evento ConnectionRequested .
PeerFinder

Permite descobrir outras instâncias do aplicativo em dispositivos próximos e criar uma conexão de soquete entre os aplicativos pares usando um gesto de toque ou navegando. Para criar conexões de soquete Bluetooth em Windows 8.1 e posteriores, use Windows.Devices.Bluetooth.Rfcomm.
PeerInformation

Contém informações que identificam um par.
PeerWatcher

Descobre dinamicamente aplicativos pares dentro do intervalo sem fio.
ProximityDevice

Permite que você publique mensagens para aproximar dispositivos ou assinar mensagens de dispositivos próximos.
ProximityMessage

Representa uma mensagem recebida de uma assinatura.
TriggeredConnectionStateChangedEventArgs

Contém propriedades que o evento TriggeredConnectionStateChanged passa para um aplicativo.

Enumerações

PeerDiscoveryTypes

Indica quais opções de descoberta estão disponíveis para uso com a classe PeerFinder .
PeerRole

Descreve a função do aplicativo par quando conectado a vários pares.
PeerWatcherStatus

Descreve o status de um objeto PeerWatcher.
TriggeredConnectState

Indica o estado atual de uma conexão com um aplicativo par.

Delegados

DeviceArrivedEventHandler

Descreve o método que manipula o evento DeviceArrived .
DeviceDepartedEventHandler

Descreve o método que manipula o evento DeviceDeparted .
MessageReceivedHandler

Descreve o método que manipulará o evento que é disparado quando uma mensagem que foi assinada foi recebida.
MessageTransmittedHandler

Descreve o método que manipulará o evento que é disparado quando uma mensagem publicada é transmitida.

Exemplos

Este exemplo mostra como você pode usar a classe ProximityDevice para determinar quando um dispositivo entra e deixa a proximidade.

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

Comentários

Você pode usar a proximidade para conectar computadores usando um gesto de toque simples. Se dois computadores estiverem dentro de 3 centímetros a 4 centímetros um do outro ou forem tocados juntos, o sistema operacional de cada computador detectará o outro computador. Em seguida, você pode conectar os dois computadores para compartilhar conteúdo ou publicar e assinar mensagens. A proximidade também dá suporte à descoberta de dispositivos pares por meio do Wi-Fi Direct.

Importante

As APIs de proximidade não fornecem autenticação, criptografia ou integridade da mensagem. Não use proximidade para trocar informações confidenciais do usuário, como senhas, dados financeiros, mensagens de texto, email, fotografias ou números de ID do governo.

Confira também