智慧型住宅傳輸控制特性結構定義
action.devices.traits.TransportControl
- 此屬性可用於能夠控制媒體播放的裝置 (例如在暫停時繼續播放音樂)。
裝置屬性
具有此特性的裝置可能會在 SYNC
作業中回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱意圖執行要求一文。
屬性 | 類型 | 說明 |
---|---|---|
transportControlSupportedCommands |
陣列 |
必填。 這個字串列出了此裝置上支援的傳輸控制指令。 |
[item, ...] |
字串 |
支援的指令。 支援的值:
|
範例
支援播放指令的裝置
{ "transportControlSupportedCommands": [ "NEXT", "PREVIOUS", "PAUSE", "STOP", "RESUME" ] }
裝置狀態:STATE
無。
裝置指令
具有此特性的裝置可能會在 EXECUTE
作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE
意圖,請參閱意圖執行要求一文。
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 |
整數 |
必填。 要跳轉 (正整數) 或反向 (負 int) 金額的毫秒數。 |
範例
快轉 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 |
布林 |
必填。 設為 True 可開啟重複模式;設為 False 可關閉重複模式。 |
isSingle |
布林 |
(預設: 如果指定,值為 True 表示開啟單一項目重複模式;否表示啟用一般重複播放模式 (例如播放清單)。 |
範例
重複播放
{ "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 |
字串 |
隱藏式輔助字幕的語言或語言代碼。 |
userQueryLanguage |
字串 |
使用者查詢的語言或語言代碼。 |
範例
開啟英文的隱藏式輔助字幕
{ "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": {} }