Windows.Networking.Proximity Espace de noms

Référence

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Contient des classes qui prennent en charge les connexions entre les appareils qui se trouvent dans une plage proche.

Classes

ConnectionRequestedEventArgs	Contient des propriétés transmises à une application avec l’événement ConnectionRequested .
PeerFinder	Vous permet de découvrir d’autres instances de votre application sur les appareils à proximité et de créer une connexion de socket entre les applications homologues à l’aide d’un mouvement d’appui ou d’une navigation. Pour créer des connexions de socket Bluetooth sur Windows 8.1 et versions ultérieures, utilisez plutôt Windows.Devices.Bluetooth.Rfcomm.
PeerInformation	Contient des informations qui identifient un homologue.
PeerWatcher	Détecte dynamiquement les applications homologues dans la plage sans fil.
ProximityDevice	Vous permet de publier des messages sur des appareils proches ou de vous abonner à des messages provenant d’appareils proximaux.
ProximityMessage	Représente un message reçu d’un abonnement.
TriggeredConnectionStateChangedEventArgs	Contient les propriétés que l’événement TriggeredConnectionStateChanged transmet à une application.

Énumérations

PeerDiscoveryTypes	Indique les options de découverte disponibles à utiliser avec la classe PeerFinder .
PeerRole	Décrit le rôle de l’application homologue lorsqu’elle est connectée à plusieurs homologues.
PeerWatcherStatus	Décrit la status d’un objet PeerWatcher.
TriggeredConnectState	Indique l’état actuel d’une connexion à une application homologue.

Délégués

DeviceArrivedEventHandler	Décrit la méthode qui gère l’événement DeviceArrived .
DeviceDepartedEventHandler	Décrit la méthode qui gère l’événement DeviceDeparted .
MessageReceivedHandler	Décrit la méthode qui gère l’événement déclenché lorsqu’un message abonné a été reçu.
MessageTransmittedHandler	Décrit la méthode qui gère l’événement déclenché lorsqu’un message publié a été transmis.

Exemples

Cet exemple montre comment utiliser la classe ProximityDevice pour déterminer quand un appareil entre et quitte la proximité.

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

Remarques

Vous pouvez utiliser la proximité pour connecter des ordinateurs à l’aide d’un simple mouvement d’appui. Si deux ordinateurs se trouvent à moins de 3 centimètres à 4 centimètres l’un de l’autre ou sont exploités ensemble, le système d’exploitation de chaque ordinateur détecte l’autre ordinateur. Vous pouvez ensuite connecter les deux ordinateurs pour partager du contenu ou publier et vous abonner à des messages. La proximité prend également en charge la découverte d’appareils homologues via Wi-Fi Direct.

Important

Les API de proximité ne fournissent pas d’authentification, de chiffrement ou d’intégrité des messages. N’utilisez pas la proximité pour échanger des informations sensibles sur les utilisateurs, telles que des mots de passe, des données financières, des messages texte, des e-mails, des photographies ou des numéros d’identification gouvernementaux.