Freigeben über


Windows.Networking.Proximity Namespace

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.

Weitere Informationen