智慧型住宅 TransportControl Trait 結構定義

action.devices.traits.TransportControl - 這項設定代表裝置可以控制媒體播放 (例如在暫停播放時繼續播放音樂)。

裝置屬性

具此特性的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖，請參閱意圖執行要求。

屬性 類型 說明
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 意圖，請參閱意圖執行要求。

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 布林

必要。

True 開啟重複模式，設為 false 即可關閉重複模式。
isSingle 布林

(預設值：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": {}
}

裝置 ERRORS

請參閱錯誤和例外狀況的完整清單。