Windows.Networking.Proximity Namespace

Referenz

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Enthält Klassen, die Verbindungen zwischen Geräten unterstützen, die sich im Nahbereich befinden.

Klassen

ConnectionRequestedEventArgs	Enthält Eigenschaften, die mit dem ConnectionRequested-Ereignis an eine Anwendung übergeben werden.
PeerFinder	Ermöglicht es Ihnen, andere Instanzen Ihrer App auf Geräten in der Nähe zu ermitteln und eine Socketverbindung zwischen den Peer-Apps herzustellen, indem Sie eine Tippen-Geste verwenden oder durchsuchen. Verwenden Sie zum Erstellen von Bluetooth-Socketverbindungen auf Windows 8.1 und höher stattdessen Windows.Devices.Bluetooth.Rfcomm.
PeerInformation	Enthält Informationen, die einen Peer identifizieren.
PeerWatcher	Ermittelt dynamisch Peer-Apps innerhalb des drahtlosen Bereichs.
ProximityDevice	Ermöglicht ihnen das Veröffentlichen von Nachrichten auf geräten oder das Abonnieren von Nachrichten von proximate-Geräten.
ProximityMessage	Stellt eine Nachricht dar, die von einem Abonnement empfangen wird.
TriggeredConnectionStateChangedEventArgs	Enthält Eigenschaften, die das TriggeredConnectionStateChanged-Ereignis an eine Anwendung übergibt.

Enumerationen

PeerDiscoveryTypes	Gibt an, welche Ermittlungsoptionen für die PeerFinder-Klasse verfügbar sind.
PeerRole	Beschreibt die Rolle der Peer-App, wenn eine Verbindung mit mehreren Peers besteht.
PeerWatcherStatus	Beschreibt die status eines PeerWatcher-Objekts.
TriggeredConnectState	Gibt den aktuellen Zustand einer Verbindung mit einer Peeranwendung an.

Delegaten

DeviceArrivedEventHandler	Beschreibt die Methode, die das DeviceArrived-Ereignis behandelt.
DeviceDepartedEventHandler	Beschreibt die -Methode, die das DeviceDeparted-Ereignis behandelt.
MessageReceivedHandler	Beschreibt die Methode, die das Ereignis behandelt, das ausgelöst wird, wenn eine Nachricht empfangen wurde, die abonniert wurde.
MessageTransmittedHandler	Beschreibt die Methode, die das Ereignis behandelt, das ausgelöst wird, wenn eine veröffentlichte Nachricht übertragen wurde.

Beispiele

In diesem Beispiel wird gezeigt, wie Sie die ProximityDevice-Klasse verwenden können, um zu bestimmen, wann ein Gerät in die Nähe eintritt und diese verlässt.

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

Hinweise

Sie können die Näherung verwenden, um Computer mithilfe einer einfachen Tippengeste zu verbinden. Wenn zwei Computer innerhalb von 3 Zentimetern bis 4 Zentimeter voneinander entfernt sind oder zusammengetippt werden, erkennt das Betriebssystem jedes Computers den anderen Computer. Anschließend können Sie die beiden Computer verbinden, um Inhalte zu teilen oder Nachrichten zu veröffentlichen und zu abonnieren. Näherung unterstützt auch die Ermittlung von Peergeräten über Wi-Fi Direct.

Wichtig

Die Näherungs-APIs bieten keine Authentifizierung, Verschlüsselung oder Nachrichtenintegrität. Verwenden Sie die Nähe nicht, um vertrauliche Benutzerinformationen wie Kennwörter, Finanzdaten, TEXTnachrichten, E-Mails, Fotos oder Behörden-ID-Nummern auszutauschen.