智能家居 TransControl 特征架构
action.devices.traits.TransportControl
- 此特征用于能够控制媒体播放的设备(例如,在暂停时继续播放音乐)。
设备属性
具有此特征的设备可能会在 SYNC
操作中报告以下属性。如需详细了解如何处理 SYNC
intent,请参阅 intent 执行方式。
属性 | 类型 | 说明 |
---|---|---|
transportControlSupportedCommands |
数组 |
必填。 描述此设备支持的传输控制命令的字符串列表。 |
[item, ...] |
String |
支持的命令。 支持的值:
|
示例
支持播放命令的设备
{ "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 |
整数 |
必填。 要跳转的正向(正整数)或向后(负整数)毫秒。 |
示例
快进 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 |
整数 |
必填。 要搜索的绝对位置(以毫秒为单位)。 |
示例
跳转到 30 秒
{ "command": "action.devices.commands.mediaSeekToPosition", "params": { "absPositionMs": 30000 } }
action.devices.commands.mediaRepeatMode
设置重复播放模式。
此命令需要以下特性:{ "transportControlSupportedCommands": [ "SET_REPEAT" ] }
参数
参数 | 类型 | 说明 |
---|---|---|
isOn |
Boolean |
必填。 True 表示启用重复模式,值为 false 表示关闭重复模式。 |
isSingle |
Boolean |
(默认值: 如果指定,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": {} }