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

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

action.devices.traits.StartStop - このトレイトは、オペレーションの開始と停止をサポートするデバイスに属します。

デバイスの起動と停止は、オン / オフに似た機能を提供します。このトレイトを継承するデバイスは、起動時と起動時で異なる働きをします。たとえば、洗濯機の中には、実際に動作を開始する前に電源を入れて設定を変更できるものがあります。

単にオンとオフの状態を持つデバイスとは異なり、起動と停止を行うことができるデバイスの中には、動作中に一時停止できるものもあります。一時停止できるデバイスは動作を停止しますが、再開すると一時停止したときと同じ状態が続きます。一時停止解除は、デバイスの現在の状態に関係のない、起動 / 再起動とは異なります。こちらは最初から動作を開始します。

一部のデバイスは特定ゾーンでの実行をサポートしています。たとえばスプリンクラーには複数の散水ゾーンがあり、特定のゾーンに別々に散水する機能をサポートできますが、掃除機は特定の部屋の清掃をサポートできます。

デバイスの属性

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

属性 タイプ 説明
pausable ブール値

(デフォルト: false

動作中にデバイスを一時停止できるかどうかを示します。

availableZones 配列

サポートされているゾーン名を示します。文字列はユーザーが設定したとおりにローカライズする必要があります。このリストはすべてを網羅しているわけではなく、任意の名前を報告することもできます。

[item, ...] 文字列

開始デバイスがサポートされているゾーンの名前。

一時停止可能で、複数のゾーンで動作するデバイス。

{
  "pausable": true,
  "availableZones": [
    "kitchen",
    "living room",
    "office",
    "bedroom"
  ]
}

デバイスのステータス

このトレイトを持つデバイスは、QUERY オペレーションの一環として次の状態をレポートできます。QUERY インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。

状態 タイプ 説明
isRunning ブール値

必須。

デバイスが現在動作中かどうかを示します。

isPaused ブール値

デバイスが明示的に一時停止されているかどうかを示します。この値が true の場合、isRunning が false であることを意味しますが、再開できます。

activeZones 配列

availableZones のリストから、デバイスが現在実行されているゾーンを示します。

[item, ...] 文字列

ゾーン名。

デバイスは一時停止中ですか?

{
  "isRunning": false,
  "isPaused": true
}

デバイスは一時停止中ですか?

{
  "isRunning": true,
  "isPaused": false
}

デバイスは動作していますか?

{
  "isRunning": true,
  "isPaused": false,
  "activeZones": [
    "kitchen",
    "living room"
  ]
}

デバイスのコマンド

このトレイトを持つデバイスは、EXECUTE オペレーションの一環として次のコマンドに応答できます。EXECUTE インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。

action.devices.commands.StartStop

デバイスを起動または停止します。

パラメータ

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

必須。

デバイスの操作を開始する場合は True、停止する場合は False。

zone 文字列

実行を開始するゾーンを示します。

multipleZones 配列

実行を開始する 2 つ以上のゾーンを示します。zone parameter. の代わりに設定されます

[item, ...] 文字列

デバイスを起動するゾーンの名前。

デバイスを起動します。

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true
  }
}

デバイスを停止します。

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": false
  }
}

オフィスでデバイスを起動する。

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "zone": "office"
  }
}

キッチン、ダイニング ルーム、リビングルームでデバイスを起動。

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "multipleZones": [
      "kitchen",
      "dining room",
      "living room"
    ]
  }
}

action.devices.commands.PauseUnpause

デバイスの操作の一時停止または一時停止解除を行います。

このコマンドには、次の属性が必要です。
{
  "pausable": true
}

パラメータ

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

必須。

true で一時停止、false で一時停止解除。

デバイスを一時停止する。

{
  "command": "action.devices.commands.PauseUnpause",
  "params": {
    "pause": true
  }
}

ユーザーがデバイスを一時停止しようとしたが、デバイスが一時停止できない状態になっている。

サポートされている値:

unpausableState

サンプル音声

de-DE

  • Bitte Starte den Staubsauger im Wohnzimmer .
  • Geschirrspüler wieder anstellen
  • Staubsauger Abchalten
  • Staubsauger pausieren
  • ビュッテ スタート die Waschmaschine

en-US

  • 私の roomba を広告掲載を始めるには デン
  • 一時停止 乾燥機 今すぐ
  • 乾燥機 今すぐ
  • 食器洗浄機
  • 食器洗浄機を停止

es-ES

  • parar la lavadora
  • pon el aspirador en el dormitorio principal
  • pon el lavavajillas en pausa
  • quiero usar el friegaplatos
  • vuelve a encender la aspiradora

fr-FR

  • Allumer l'aspirateur dans le salon .
  • 続き l'aspirateur .
  • arrête l'aspirateur
  • lance la machine à laver
  • meets l'aspirateur 一時停止中

デバイスエラー

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