ProximityDevice Class

Permet de publier des messages sur les périphériques proches ou de s'abonner aux messages auprès des périphériques proches.

Syntaxe


var proximityDevice = Windows.Networking.Proximity.ProximityDevice;

Attributs

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

Membres

ProximityDeviceClasse possède ces types de membres :

Événements

ProximityDeviceClasse possède ces événements.

ÉvénementDescription
DeviceArrived Occurs when a device enters the proximate range.
DeviceDeparted Occurs when a device leaves the proximate range.

 

Méthodes

The ProximityDevice Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
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.

 

Propriétés

Le ProximityDeviceClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

BitsPerSecond

En lecture seuleGets the transfer rate of a proximity device.

DeviceId

En lecture seuleGets the DeviceInformation Id for a proximity device.

MaxMessageBytes

En lecture seuleGets the maximum size of a published message that this proximity device supports.

 

Remarques

La classe ProximityDevice permet aux applications de communiquer avec des applications actives sur les périphériques, généralement dans une portée de 3 à 4 centimètres.

Vous pouvez créer une instance de ProximityDevice à l'aide de la méthode statique GetDefault ou FromId.

La classe ProximityDevice utilise la sémantique publication/abonnement et est utile pour publier et recevoir de petits blocs de données. Pour de grandes quantités de texte, ou pour les communications permanentes, utilisez les classes PeerFinder et StreamSocket. Pour les applications Windows Store, les publications et les abonnements sont actifs uniquement si l'application appelante est au premier plan.

Important  

Les API de proximité ne fournissent pas l'authentification, le chiffrement ni l'intégrité des messages. N'utilisez pas la proximité pour échanger des informations utilisateur sensibles telles que des mots de passe, des données financières, des messages texte, des courriers électroniques, des photos ou des numéros d'identification.

Exemples


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 />";
}


Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store, applications de bureau]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store, applications de bureau]

Téléphone minimal pris en charge

Windows Phone 8

Espace de noms

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

Métadonnées

Windows.winmd

Capabilities

proximity
ID_CAP_PROXIMITY [Windows Phone]

Voir aussi

Proximité et geste tactile (JavaScript)
Proximité et geste tactile (C#/VB/C++)
Exemples
Exemple de proximité

 

 

Afficher:
© 2014 Microsoft