Class DeviceDescriptor

Object
   |
   +--DeviceDescriptor

class DeviceDescriptor

Metadata about a device

A device is most commonly a computer, but can also be cell phones, media centre consoles and the likes. Objects of this class give you access to meta information about the device, such as a name and description and the URL the device is exposed on.

Devices are exposed in a DeviceList object through the opera.nearbyDevices property.

Each device can run zero or more services, exposed in a ServiceList object in the services property.

Field Detail

description

String description

Human-readable description of this device. Readonly.

id

String id

Unique identifier of this device. Readonly.

name

String name

Human-readable name of this device. Readonly.

OFFLINE

int OFFLINE

Constant for whether a device is offline. The value of this constant is 0.

ONLINE

int ONLINE

Constant for whether a device is online. The value of this constant is 1.

services

ServiceList services

Services running on this device. Readonly.

If this device is not running any services, the list is empty.

Example:

for ( i = 0, service; device.services[i] i++ )
{
    li = list.appendChild(document.createElement('li'));
    a = li.appendChild(document.createElement(a));
    a.href = service.url;
    a.textContent = service.name;
}

status

int status

The availability status of this device. Readonly.

Typically whether the device is on- or offline. The value of this property is one of ONLINE or OFFLINE. The list of constants expanded may be included in the future to include statuses like "Busy".

Example:

if ( device.status == device.OFFLINE )
{
    widget.showNotification(device.name + ' has been been switched off.');
}

uniteDeviceName

String uniteDeviceName

Opera Unite device name for this device. Readonly. If the owner of this device is not an Opera Unite user, this property will be null.

uniteUser

String uniteUser

Opera Unite username of the owner of this device. Readonly. If the owner of this device is not an Opera Unite user, this property will be null.

url

String url

URL this device is exposed on. Readonly. This URL points to the root of the device. Use it to generate links to the device, or to generate URLs in XHR calls to it.

Example:

a = document.createElement('a');
a.href = device.url;
a.textContent = device.name

DeviceDescriptor

DeviceDescriptor()

This class has no public constructor.