devices.types.media_device.tv

A device for viewing video content. You can change the volume and switch channels on the device.

devices.types.media_device.tv-on

devices.types.media_device.tv-off

Examples of devices

Smart TV, IR TV remote control, media set-top box, receiver.

Device control phrases

Each device type has a specific set of phrases. The user can control the device using these phrases without specifying the device name.

Phrases

Алиса, включи телевизор.

Translation: Alice, turn on the TV.
Алиса, выключи телек.

Translation: Alice, turn off the TV.
Алиса, сделай телевизор погромче.

Translation: Alice, turn up the TV.
Алиса, выключи звук на телевизоре.

Translation: Alice, mute the TV.
Алиса, включи на телеке пятый канал.

Translation: Alice, turn on channel five on TV.

Where can I find all voice commands?

To open the full list of voice commands:

Open the Home with Alice app.
Select the desired device in the list of devices.
Go to the Voice commands section at the bottom of the page.
Tap More commands.

Recommended capabilities

The table of capabilities is based on popular device functions in a given category. It provides general recommendations for describing devices. Yandex Smart Home does not restrict the provider to the specified list. You can combine capabilities and devices as you wish based on your awareness of the device features.

Capability	Instances and values
devices.capabilities.on_off	Functions and values are not applicable.
devices.capabilities.mode	Function: `input_source`. Values: `one`, `two`, `three`, `four`, `five`, `six`, `seven`, `eight`, `nine`, `ten`.
devices.capabilities.range	Function: `channel`. Values: not supported.
devices.capabilities.range	Function: `volume`. Values: not supported.
devices.capabilities.toggle	Function: `backlight`. Values: not supported.
devices.capabilities.toggle	Function: `controls_locked`. Values: not supported.
devices.capabilities.toggle	Function: `mute`. Values: not supported.
devices.capabilities.toggle	Function: `pause`. Values: not supported.

Examples of capability and property descriptions

These structures are sent in response to the device list request.

An IR TV remote control that changes the volume, sets any channel, and mutes sound.

Note

The IR remote is agnostic of its current state. This is indicated by the "retrievable": false parameter in each of the capabilities. It is also agnostic of its range of volume and channels.

{
 "capabilities": [{
   "type": "devices.capabilities.on_off",
   "retrievable": false
  },
  {
   "type": "devices.capabilities.toggle",
   "retrievable": false,
   "parameters": {
    "instance": "mute"
   }
  },
  {
   "type": "devices.capabilities.range",
   "retrievable": false,
   "parameters": {
    "instance": "volume",
    "random_access": false
   }
  },
  {
   "parameters": {
    "instance": "channel",
    "random_access": true
   },
   "retrievable": false,
   "type": "devices.capabilities.range"
  }
 ],
 "properties": []
}

Smart TV that changes the volume, sets any channel, mutes the sound, pauses playback, and has three signal sources to choose from

{
 "capabilities": [{
   "type": "devices.capabilities.on_off",
   "retrievable": true
  },
  {
   "type": "devices.capabilities.toggle",
   "retrievable": true,
   "parameters": {
    "instance": "mute"
   }
  },
  {
   "type": "devices.capabilities.toggle",
   "retrievable": true,
   "parameters": {
    "instance": "pause"
   }
  },
  {
   "type": "devices.capabilities.mode",
   "retrievable": true,
   "parameters": {
    "instance": "input_source",
    "modes": [{
      "value": "one"
     },
     {
      "value": "two"
     },
     {
      "value": "three"
     }
    ]
   }
  },
  {
   "type": "devices.capabilities.range",
   "retrievable": true,
   "parameters": {
    "instance": "volume",
    "random_access": true,
    "range": {
     "max": 100,
     "min": 1,
     "precision": 1
    },
    "unit": "unit.percent"
   }
  },
  {
   "type": "devices.capabilities.range",
   "retrievable": true,
   "parameters": {
    "instance": "channel",
    "random_access": true,
    "range": {
     "max": 999,
     "min": 1,
     "precision": 1
    }
   }
  }
 ],
 "properties": []
}

Smart TV that changes the volume, sets any channel, mutes the sound, and has a built-in backlight and kids mode

{
 "capabilities": [{
   "type": "devices.capabilities.on_off",
   "retrievable": true
  },
  {
   "type": "devices.capabilities.toggle",
   "retrievable": true,
   "parameters": {
    "instance": "controls_locked"
   }
  },
  {
   "type": "devices.capabilities.toggle",
   "retrievable": true,
   "parameters": {
    "instance": "backlight"
   }
  },
  {
   "type": "devices.capabilities.toggle",
   "retrievable": true,
   "parameters": {
    "instance": "mute"
   }
  },
  {
   "type": "devices.capabilities.range",
   "retrievable": true,
   "parameters": {
    "instance": "volume",
    "random_access": true,
    "range": {
     "max": 100,
     "min": 1,
     "precision": 1
    },
    "unit": "unit.percent"
   }
  },
  {
   "type": "devices.capabilities.range",
   "retrievable": true,
   "parameters": {
    "instance": "channel",
    "random_access": true,
    "range": {
     "max": 999,
     "min": 1,
     "precision": 1
    }
   }
  }
 ],
 "properties": []
}

Was the article helpful?

media_device.receiver

media_device.tv_box