ProximityDevice class

Enables you to publish messages to proximate devices or subscribe to messages from proximate devices.

Syntax

var proximityDevice = Windows.Networking.Proximity.ProximityDevice;

Attributes

DualApiPartitionAttribute()

MarshalingBehaviorAttribute(Agile)

StaticAttribute(Windows.Networking.Proximity.IProximityDeviceStatics, NTDDI_WIN8)

ThreadingAttribute(Both)

VersionAttribute(NTDDI_WIN8)

Members

The ProximityDevice class has these types of members:

• Events
• Methods
• Properties

Events

The ProximityDevice class has these events.

Methods

The ProximityDevice class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.

Properties

The ProximityDevice class has these properties.

Remarks

The ProximityDevice class enables applications to communicate with running applications on devices, typically within a range of 3 centimeters to4 centimeters.

You can create an instance of ProximityDeviceby using the GetDefault or FromId static method.

The ProximityDevice class uses publish/subscribe semantics and is useful for advertising and receiving small blocks of data. For larger amounts of data, or for persistent communications, use the PeerFinder and StreamSocket classes. For Windows Store apps, publications and subscriptions are active only if the calling app is in the foreground.

Examples

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

Requirements

See also

Proximity and Tapping (JavaScript)

Proximity and Tapping (C#/VB/C++)

Samples

Proximity sample

Build date: 2/25/2013