ProximityDevice.DeviceId | deviceId property

Applies to Windows and Windows Phone

Gets the DeviceInformation Id for a proximity device.

Syntax


var deviceId = proximityDevice.deviceId;

Property value

Type: String [JavaScript] | System.String [.NET] | Platform::String [C++]

The DeviceInformation Id for a proximity device.

Remarks

If your computer supports Proximity and has an NFC device installed, which is commonly the case, then the GetDefault method will return the device that supports NFC. You can also determine whether your computer has an NFC device installed by querying the device information for the property "{FB3842CD-9E2A-4F83-8FCC-4B0761139AE9} 2". In the DeviceInformation.Properties object returned from the query the value for the "{FB3842CD-9E2A-4F83-8FCC-4B0761139AE9} 2" key contains and array of strings that describe the capabilities of the proximity device. If one of the strings is "StandardNfc", then the device supports NFC protocols such as NDEF. For more information on how to query for the properties of a device, see How to retrieve additional properties for a device or PnP object.

Examples


function queryDeviceProperties() {
    // Include the proximity properties key
    var propertiesToRetrieve = new Array();
    propertiesToRetrieve.push("{FB3842CD-9E2A-4F83-8FCC-4B0761139AE9} 2");

    var defaultProximityDevice =
        Windows.Networking.Proximity.ProximityDevice.getDefault();

    if (defaultProximityDevice) {
        Windows.Devices.Enumeration.DeviceInformation.createFromIdAsync(
            defaultProximityDevice.deviceId, propertiesToRetrieve).done(
            function (devInfo) {
                if (devInfo.properties.hasKey("{FB3842CD-9E2A-4F83-8FCC-4B0761139AE9} 2")) {
                    var proximityCapabilities = new Array();
                    proximityCapabilities = devInfo.properties["{FB3842CD-9E2A-4F83-8FCC-4B0761139AE9} 2"];
                    for (var i = 0; i < proximityCapabilities.length; i++) {
                        if (proximityCapabilities[i] == "StandardNfc") {
                            // This proximity device supports NFC
                        }
                    };
                }
            });
    }
}


Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8

Namespace

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

Metadata

Windows.winmd

Capabilities

proximity
ID_CAP_PROXIMITY [Windows Phone]

See also

ProximityDevice
Proximity and Tapping (JavaScript)
Proximity and Tapping (C#/VB/C++)
Samples
Proximity sample

 

 

Show:
© 2014 Microsoft