欢迎使用 Google Home 开发者中心,您可以在这里学习有关如何开发智能家居 Action 的新平台。注意:你将继续在 Actions 控制台中构建操作。
使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

智能家居频道特征架构

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

在同步期间,应通过 availableChannels 属性以列表形式针对每个用户或设备分享可用渠道。此列表应包含用户或设备订阅的所有热门或热门频道。为了确保查询延迟时间较短,我们建议您将频道列表保持在较小的范围(最多 30 个频道)。

设备属性

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

属性 类型 说明
availableChannels 数组

必填。

描述此特定设备可用媒体通道的对象列表。每一项都描述了用户可以在此设备上选择的渠道。

[item, ...] 对象

可用的媒体渠道。

key String

必填。

此渠道的唯一标识符。未向用户显示。

names 数组

必填。

此频道的用户可见名称列表。

[item, ...] String

频道名称。

number String

此渠道的可选数字标识符。

commandOnlyChannels Boolean

(默认值: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 String

必填。

所请求渠道的唯一标识符,与其中一个 availableChannels 匹配。

channelName String

所请求渠道的名称,方便用户使用。

channelNumber String

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

按编号选择频道

参数 类型 说明
channelNumber String

必填。

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

示例

更改为 KTVU

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

转到第三频道

{
  "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

设备出错

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