# 电视频道
以下这些消息类型,用于设置电视节目信息。
- SelectChannelRequest
- SelectChannelConfirmation
# SelectChannelRequest
示例语句: “小微,{设备名}播放中央五套” 目的:请求播放指定的频道。
Header
属性 | 值 |
---|---|
name | SelectChannelRequest |
namespace | SmartHome.Control |
Payload
属性 | 描述 | 是否必需 |
---|---|---|
accessToken | 与客户的设备云账户相关的访问令牌。 | 是 |
appliance object | 执行操作的设备。 | 是 |
appliance.applianceID | 设备标识符。 标识符在技术适配器的域内的最终用户拥有的所有设备上必须是唯一的。 此外,标识符需要在同一设备的多个发现请求之间保持一致。 标识符可以包含任何字母或数字和以下特殊字符:_ - = # ; : ? @ &。 该值不能超过256个字符。 | 是 |
appliance.additionalApplianceDetails | 提供关于技能适配器使用的设备的附加信息的字符串名称/值对。 该属性的内容不能超过5000字节。 而且,Smart Home Skill API即不理解也不使用这些数据。 | 是,但列表可以为空。 |
channelName | 要看的频道 | 是 |
SelectChannelRequest示例:
{
"header": {
"messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
"name": " SelectChannelRequest",
"namespace": "SmartHome.Control",
"payloadVersion":"2"
},
"payload": {
"accessToken": "[OAuth token here]",
"appliance": {
"additionalApplianceDetails": {},
"applianceId": "[Device ID]"
},
"channelName": {
"value": "中央五台"
}
}
}
# SelectChannelConfirmation
**小微响应示例:“好的”
目的:表示设备已成功设置播放频道。 这是对SelectChannelRequest的预期响应,并从技能适配器发送到Smart Home Skill API。
Header
属性 | 值 |
---|---|
name | SelectChannelConfirmation |
namespace | SmartHome.Control |
Payload
属性 | 描述 | 是否必需 |
---|---|---|
status 对象 | 调整了频道后设备的状态。 | 是 |
status.channel | 当前设备的频道。 | 是 |
SelectChannelConfirmation示例:
{
"header": {
"messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
"name": "SelectChannelConfirmation",
"namespace": "SmartHome.Control",
"payloadVersion":"2"
},
"payload": {
"status": {
"channelName": "中央四套"
}
}
}