devices.types.media_device

Audio, video, multimedia equipment. Devices that can play audio and video.

Examples of devices

DVD player and other media devices. We recommend that you use individual device types: devices.types.media_device.tv for a TV,devices.types.media_device.tv_box for a smart set-top box, and devices.types.media_device.receiver for a receiver.

Recommended capabilities

The table of capabilities is based on popular device functions in a given category. It provides general recommendations for describing devices. Yango 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: `mute`. Values: not supported.
devices.capabilities.toggle	Function: `pause`. Values: not supported.


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: `mute`. Values: not supported.
devices.capabilities.toggle	Function: `pause`. Values: not supported.

Examples of descriptions of capabilities and properties

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

An IR remote for a media player 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 media player that changes the volume, sets any channel, mutes the sound, pauses playback, and has three signal inputs 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": []
}