Skip to main content

Dedicated Devices

A dedicated device belongs to your organization alone. Nobody outside your organization can start a session on it.

Dedicated devices are a paid add-on, not part of a standard plan. Contact [email protected] to add dedicated devices to your organization.

Finding your dedicated devices​

Open the device catalog and select the Dedicated tab. Each row shows the device's model, platform, serial number, and current state (Available, In session, In maintenance, or Unavailable). If another user on your team has a session open, hover the state badge to see who and since when.

Some dedicated devices carry tags — for example, everything reserved for a beta program. Click a tag on a device row to filter the list down to devices with that tag, or use the tag filter above the list. Starting a session from the catalog includes any required tags for you automatically; targeting the same device directly from Appium does not, so carry them over into your tvlabs:constraints as shown below.

If your organization has no dedicated devices, this tab is hidden.

Targeting a dedicated device from Appium​

Target a specific dedicated device by serial number:

const capabilities = {
  'tvlabs:constraints': {
    platform_key: 'tv_os',
    serial_number: '07C9123OC1E123456',
  },
};

If the device carries tags, include them too, or the request won't match it:

const capabilities = {
  'tvlabs:constraints': {
    platform_key: 'tv_os',
    serial_number: '07C9123OC1E123456',
    tags: ['test-flight'],
  },
};

Each dedicated device row has a copy button next to its serial number that copies a ready-to-use capabilities object, tags included.

serial_number only works with the legacy key-value constraints format, not KQL query strings.