tv
TV.
Available device functions
The device can have all the functions listed below or some of them. E.g. if the TV does not support switching to the previous and next channels, there is no need in including the channel function in its model description.
The device has two mandatory functions: online, on_off. All TV must have them.
| Function | Mandatory? | Description |
| channel | Switching on the previous or next channel | |
| channel_int | The channel number | |
| custom_key | The button pressed on the control panel | |
| direction | Moving the cursor in the desired direction | |
| mute | The mute mode | |
| number | The digital button pressed on the remote control | |
| source | The signal source | |
| volume | Make it quieter or louder | |
| volume_int | The volume level | |
| on_off | ✔︎ | Turning the device on and off remotely |
| online | ✔︎ | Device availability: offline or online |
TV model description example
The model shall be described in accordance with the model structure. The example describes a TV equipped with all functions.
Besides, allowed values for the source function (the signal source) of the model are changed: this TV does not support the ScreenCast function. So it is excluded.
{
"id": "QWERTY124",
"manufacturer": "Xiaqara",
"model": "SM1123456789",
"hw_version": "3.1",
"sw_version": "5.6",
"description": "Smart TV Xiaqara",
"category": "tv",
"features": [
"channel",
"channel_int",
"custom_key",
"direction",
"mute",
"number",
"source",
"volume",
"volume_int",
"on_off",
"online"
],
"allowed_values": {
"source": {
"type": "ENUM",
"enum_values": {
"values": [
"hdmi1",
"hdmi2",
"hdmi3",
"tv",
"av",
"content",
"+",
"-"
]
}
}
}
}
User's TV description example
The device shall be describe in accordance with the device structure. The example contains no TV model description as we believe that models are described independently and the model ID will be enough (in this case, QWERTY124).
{
"id": "ABCD_004",
"name": "My TV",
"default_name": "Smart TV",
"nicknames": ["Clever TV", "TV with an assistant"],
"home": "My home",
"room": "Living room",
"groups": ["Video equipment", "Electrical appliances"],
"model_id": "QWERTY124",
"hw_version": "3.1",
"sw_version": "5.6",
"partner_meta": {
"internal-id": 1234,
"specificity": "microchip 2A"
},
}