ProximityDevice Class

Ermöglicht das Weitergeben von Nachrichten an umliegende Geräte oder das Abonnieren von Nachrichten von umliegenden Geräten.

Syntax


var proximityDevice = Windows.Networking.Proximity.ProximityDevice;

Attribute

[DualApiPartition()]
[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

Member

ProximityDeviceKlasse hat diese Membertypen:

Ereignisse

ProximityDeviceKlasse hat diese Ereignisse.

EreignisBeschreibung
DeviceArrived Occurs when a device enters the proximate range.
DeviceDeparted Occurs when a device leaves the proximate range.

 

Methoden

The ProximityDevice Klasse hat diese Methoden. Mit C#, Visual Basic und C++ erbt es auch Methoden aus Object Klasse.

MethodeBeschreibung
FromId Creates an instance of a ProximityDevice class and activates the specified proximity device interface.
GetDefault Creates an instance of a ProximityDevice class and activates the default proximity provider.
GetDeviceSelector Returns the class selection string that you can use to enumerate proximity devices.
PublishBinaryMessage(String, IBuffer) Publishes a message that contains binary data to subscribers of the specified message type.
PublishBinaryMessage(String, IBuffer, MessageTransmittedHandler) Publishes a message that contains binary data to subscribers of the specified message type. The specified handler is called when the message has been transmitted.
PublishMessage(String, String) Publishes a message to subscribers of the specified message type.
PublishMessage(String, String, MessageTransmittedHandler) Publishes a message to subscribers of the specified message type. The specified handler is called when the message has been transmitted.
PublishUriMessage(Uri) Publishes a Uniform Resource Identifier (URI) to a proximate device.
PublishUriMessage(Uri, MessageTransmittedHandler) Publishes a Uniform Resource Identifier (URI) to a proximate device. The specified handler is called when the message has been transmitted.
StopPublishingMessage Stops publishing a message.
StopSubscribingForMessage Cancels a message subscription.
SubscribeForMessage Creates a subscription for a specified message type.

 

Eigenschaften

Der ProximityDeviceKlasse hat diese Eigenschaften.

EigenschaftZugriffstypBeschreibung

BitsPerSecond

SchreibgeschütztGets the transfer rate of a proximity device.

DeviceId

SchreibgeschütztGets the DeviceInformation Id for a proximity device.

MaxMessageBytes

SchreibgeschütztGets the maximum size of a published message that this proximity device supports.

 

Hinweise

Die Klasse ProximityDevice ermöglicht Anwendungen die Kommunikation mit ausgeführten Anwendungen auf Geräten, typischerweise in einem Abstand von 3 bis 4 cm.

Sie können eine Instanz der ProximityDevice-Klasse erstellen, indem Sie die statische GetDefault- oder FromId-Methode verwenden.

Die Klasse ProximityDevice verwendet Semantik zu Publizieren und Abonnieren und ist nützlich zum Übertragen und Empfangen kleiner Datenblöcke. Für größere Datenmengen oder für dauerhafte Kommunikation sollten Sie die Klassen PeerFinder und StreamSocket verwenden. Für Windows Store-Apps sind Veröffentlichungen und Abonnements nur aktiv, wenn sich die aufrufende App im Vordergrund befindet.

Wichtig  

Die Proximity-APIs bieten keine Authentifizierung, Verschlüsselung oder Nachrichtenintegrität. Verwenden Sie keine Nahverbindungen, um vertrauliche Benutzerinformationen wie Kennwörter, Finanzdaten, Textmeldungen, E-Mails, Fotos oder Personalausweisnummern auszutauschen.

Beispiele


function id(elementId) {
    return document.getElementById(elementId);
}

var proximityDevice;

function initializeProximityDevice() {
    proximityDevice = Windows.Networking.Proximity.ProximityDevice.getDefault();

    if (proximityDevice) {
        proximityDevice.addEventListener("devicearrived", proximityDeviceArrived);
        proximityDevice.addEventListener("devicedeparted", proximityDeviceDeparted);

        id("messageDiv").innerHTML += "Proximity device initialized.<br />";
    }
    else {
        id("messageDiv").innerHTML += "Failed to initialized proximity device.<br />";
    }
}

function proximityDeviceArrived(device) {
    id("messageDiv").innerHTML += "Proximate device arrived. id = " + device.deviceId + "<br />";
}

function proximityDeviceDeparted(device) {
    id("messageDiv").innerHTML += "Proximate device departed. id = " + device.deviceId + "<br />";
}


Anforderungen

Mindestens unterstützter Client

Windows 8 [Windows Store-Apps, Desktop-Apps]

Mindestens unterstützter Server

Windows Server 2012 [Windows Store-Apps, Desktop-Apps]

Mindestens unterstütztes Telefon

Windows Phone 8

Namespace

Windows.Networking.Proximity
Windows::Networking::Proximity [C++]

Metadaten

Windows.winmd

Capabilities

proximity
ID_CAP_PROXIMITY [Windows Phone]

Siehe auch

Nähe und Tippen (JavaScript)
Nähe und Tippen (C#/VB/C++)
Beispiele
Nähebeispiel

 

 

Anzeigen:
© 2014 Microsoft