智能家居渠道特征架构

action.devices.traits.Channel - 此特征属于支持媒体设备上的电视频道的设备。

在 SYNC 期间，应通过 availableChannels 属性按用户或设备共享可用频道列表。此列表应包含用户或设备订阅的所有热门频道。为确保查询延迟时间较短，我们建议您将频道列表保持较小（不超过 30 个频道）。

设备属性

具有此特征的设备可能会报告以下 属性作为 SYNC 操作的一部分。如需详细了解如何处理 SYNC intent，请参阅 intent 执行方式。

属性 类型 说明
availableChannels 数组

必填。

描述此特定设备的可用媒体频道的对象列表。每个条目都描述了用户可以在此设备上选择的频道。
[item, ...] 对象

可用媒体渠道。
key 字符串

必填。

此频道的唯一标识符。不会向用户公开。
names 数组

必填。

此频道的用户可见名称列表。
[item, ...] 字符串

频道名称。
number 字符串

此频道的可选数字标识符。
commandOnlyChannels 布尔值

（默认值：false）

指示设备是否支持使用单向 (true) 或双向 (false) 通信。如果设备无法响应此特征的 QUERY intent 或报告状态，请将此属性设置为 true。

示例

支持两个频道的设备。

{
  "availableChannels": [
    {
      "key": "ktvu2",
      "names": [
        "Fox",
        "KTVU"
      ],
      "number": "2"
    },
    {
      "key": "abc1",
      "names": [
        "ABC",
        "ABC East"
      ],
      "number": "4-11"
    }
  ]
}

设备状态

无。

设备命令

具有此特征的设备可能会响应以下 命令作为 EXECUTE 操作的一部分。如需详细了解如何处理 EXECUTE intent，请参阅 intent 执行方式。

action.devices.commands.selectChannel

将当前频道设置为特定值。

参数

有效负载包含以下其中一项：

按 ID 选择频道

参数 类型 说明
channelCode 字符串

必填。

所请求频道的唯一标识符，与 availableChannels 中的一个标识符匹配。
channelName 字符串

所请求频道的直观易懂的名称。
channelNumber 字符串

所请求频道的数字标识符。

按编号选择频道

参数 类型 说明
channelNumber 字符串

必填。

所请求频道的数字标识符。

示例

切换到 KTVU

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelCode": "ktvu2",
    "channelName": "KTVU"
  }
}

转到频道 3。

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelNumber": "3"
  }
}

在设备上选择新频道时发生错误。

支持的值：

noAvailableChannel
noChannelSubscription
channelSwitchFailed

action.devices.commands.relativeChannel

按相对量调整当前频道。

参数

参数 类型 说明
relativeChannelChange 整数

必填。

要增加或减少的频道数。

示例

切换到下一个频道

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": 1
  }
}

切换到上一个频道

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": -1
  }
}

调整设备的频道时发生错误。

支持的值：

channelSwitchFailed

action.devices.commands.returnChannel

返回到用户上次/之前使用的频道。

参数

参数 类型 说明

没有属性

示例

返回到上一个频道

{
  "command": "action.devices.commands.returnChannel",
  "params": {}
}

返回到设备的上一个频道时发生错误。

支持的值：

channelSwitchFailed

设备错误

查看错误和异常的完整列表。