Google Home デベロッパー センターにようこそ。スマートホーム アクションの開発方法を学ぶことができます。注: アクションの作成は、引き続き Actions Console で行います。
コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

スマートホームの TransportControl トレイトのスキーマ

action.devices.traits.TransportControl - このトレイトは、メディアの再生を操作できる（一時停止中に音楽を再開するなど）デバイスに使用します。

デバイスの属性

この特性を持つデバイスは、SYNC オペレーションの一部として次の属性を報告する可能性があります。SYNC インテントの処理の詳細については、インテント フルフィルメントをご覧ください。

属性 タイプ 説明
transportControlSupportedCommands 配列

必須。

このデバイスでサポートされているトランスポート制御コマンドを記述する文字列のリスト。
[item, ...] 文字列

サポートされているコマンド。

サポートされている値:

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 Integer

必須。

シーク再生する順（正の整数）または後方（負の整数）のミリ秒。

例

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 Integer

必須。

シークする絶対位置のミリ秒。

例

30 秒までシーク

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

action.devices.commands.mediaRepeatMode

リピート再生モードを設定します。

このコマンドには次の属性が必要です。 
{
  "transportControlSupportedCommands": [
    "SET_REPEAT"
  ]
}

パラメータ

パラメータ タイプ 説明
isOn ブール値

必須。

リピート モードをオンにする場合は true、繰り返しモードをオフにする場合は false です。
isSingle ブール値

（デフォルト: false）

指定した場合、true はアイテムの繰り返しモードを有効にすることを意味し、false は通常の繰り返しモード（再生リストなど）をオンにすることを意味します。

例

繰り返す間隔

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

リピート: オフ

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

1 つのトラックを繰り返す

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

デバイスエラー

エラーと例外のリストをご覧ください。