此页面由 Cloud Translation API 翻译。

Switch to English

智能家居 TransControl 特征架构

action.devices.traits.TransportControl - 此特征用于能够控制媒体播放的设备（例如，在暂停时继续播放音乐）。

设备属性

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

属性类型说明

属性	类型	说明
`transportControlSupportedCommands`	数组	必填。描述此设备支持的传输控制命令的字符串列表。
`[item, ...]`	String	支持的命令。支持的值： `CAPTION_CONTROL` `NEXT` `PAUSE` `PREVIOUS` `RESUME` `SEEK_RELATIVE` `SEEK_TO_POSITION` `SET_REPEAT` `SHUFFLE` `STOP`

transportControlSupportedCommands

数组

必填。

描述此设备支持的传输控制命令的字符串列表。

[item, ...]

String

支持的命令。

支持的值：

CAPTION_CONTROL
NEXT
PAUSE
PREVIOUS
RESUME
SEEK_RELATIVE
SEEK_TO_POSITION
SET_REPEAT
SHUFFLE
STOP

示例

支持播放命令的设备

{
  "transportControlSupportedCommands": [
    "NEXT",
    "PREVIOUS",
    "PAUSE",
    "STOP",
    "RESUME"
  ]
}

设备状态

无。

设备命令

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

`action.devices.commands.mediaStop`

暂停媒体播放。

此命令需要以下特性：

{
  "transportControlSupportedCommands": [
    "STOP"
  ]
}

参数

参数	类型	说明
没有属性

示例

无参数

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

`action.devices.commands.mediaNext`

跳至下一个媒体项。

此命令需要以下特性：

{
  "transportControlSupportedCommands": [
    "NEXT"
  ]
}

参数

参数	类型	说明
没有属性

示例

无参数

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

`action.devices.commands.mediaPrevious`

跳至上一个媒体项。

此命令需要以下特性：

{
  "transportControlSupportedCommands": [
    "PREVIOUS"
  ]
}

参数

参数	类型	说明
没有属性

示例

无参数

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

`action.devices.commands.mediaPause`

暂停媒体播放。

此命令需要以下特性：

{
  "transportControlSupportedCommands": [
    "PAUSE"
  ]
}

参数

参数	类型	说明
没有属性

示例

无参数

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

`action.devices.commands.mediaResume`

继续播放媒体。

此命令需要以下特性：

{
  "transportControlSupportedCommands": [
    "RESUME"
  ]
}

参数

参数	类型	说明
没有属性

示例

无参数

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

`action.devices.commands.mediaSeekRelative`

跳转到相对位置。

此命令需要以下特性：

{
  "transportControlSupportedCommands": [
    "SEEK_RELATIVE"
  ]
}

参数

参数类型说明

参数	类型	说明
`relativePositionMs`	整数	必填。要跳转的正向（正整数）或向后（负整数）毫秒。

relativePositionMs

整数

必填。

要跳转的正向（正整数）或向后（负整数）毫秒。

示例

快进 10 秒

{
  "command": "action.devices.commands.mediaSeekRelative",
  "params": {
    "relativePositionMs": 10000
  }
}

快退 10 秒

{
  "command": "action.devices.commands.mediaSeekRelative",
  "params": {
    "relativePositionMs": -10000
  }
}

`action.devices.commands.mediaSeekToPosition`

跳转到绝对位置。

此命令需要以下特性：

{
  "transportControlSupportedCommands": [
    "SEEK_TO_POSITION"
  ]
}

参数

参数类型说明

参数	类型	说明
`absPositionMs`	整数	必填。要搜索的绝对位置（以毫秒为单位）。

absPositionMs

整数

必填。

要搜索的绝对位置（以毫秒为单位）。

示例

跳转到 30 秒

{
  "command": "action.devices.commands.mediaSeekToPosition",
  "params": {
    "absPositionMs": 30000
  }
}

`action.devices.commands.mediaRepeatMode`

设置重复播放模式。

此命令需要以下特性：

{
  "transportControlSupportedCommands": [
    "SET_REPEAT"
  ]
}

参数

参数类型说明

参数	类型	说明
`isOn`	Boolean	必填。 True 表示启用重复模式，值为 false 表示关闭重复模式。
`isSingle`	Boolean	（默认值：`false`）如果指定，true 表示启用单项重复模式，false 表示启用常规重复模式（例如播放列表）。

isOn

Boolean

必填。

True 表示启用重复模式，值为 false 表示关闭重复模式。

isSingle

Boolean

（默认值：false）

如果指定，true 表示启用单项重复模式，false 表示启用常规重复模式（例如播放列表）。

示例

重复播放

{
  "command": "action.devices.commands.mediaRepeatMode",
  "params": {
    "isOn": true
  }
}

关闭重复播放功能

{
  "command": "action.devices.commands.mediaRepeatMode",
  "params": {
    "isOn": false
  }
}

重复单个曲目

{
  "command": "action.devices.commands.mediaRepeatMode",
  "params": {
    "isOn": true,
    "isSingle": true
  }
}

`action.devices.commands.mediaShuffle`

随机播放当前播放列表。

此命令需要以下特性：

{
  "transportControlSupportedCommands": [
    "SHUFFLE"
  ]
}

参数

参数	类型	说明
没有属性

示例

无参数

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

`action.devices.commands.mediaClosedCaptioningOn`

开启字幕。

此命令需要以下特性：

{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

参数

参数	类型	说明
`closedCaptioningLanguage`	String	字幕的语言或语言区域。
`userQueryLanguage`	String	用户查询的语言或语言区域。

示例

开启英文字幕

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "en"
  }
}

开启韩语字幕

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "ko-KR"
  }
}

在用户查询美式英语时，开启韩语字幕

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "ko-KR",
    "userQueryLanguage": "en-US"
  }
}

`action.devices.commands.mediaClosedCaptioningOff`

关闭字幕。

此命令需要以下特性：

{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

参数

参数	类型	说明
没有属性

示例

关闭字幕

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

设备出错

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