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 abschalten
  • Staubsauger pausieren
  • bitte starte die Waschmaschine
  • ist die Waschmaschine fertig

en-US

  • I need my roomba to start running in the den
  • is the vacuum running
  • pause the dryer now
  • start the dryer now
  • stop the dishwasher
  • unpause the dishwasher

es-ES

  • dime si ha acabado el lavavajillas
  • parar la lavadora
  • pon el lavavajillas en pausa
  • quiero usar el friegaplatos
  • vuelve a encender la aspiradora

fr-FR

  • Allumer l'aspirateur dans le salon .
  • Continuer l'aspirateur .
  • arrête l'aspirateur
  • est-ce que l'aspirateur est en marche
  • lance la machine à laver
  • mets l'aspirateur en pause

hi-IN

  • कमरे में वैक्यूम चलाओगी
  • क्या वैक्यूम चल रहा है?
  • डिशवॉशर को कुछ देर रोको
  • वैक्यूम को अनपॉज़ करो
  • वैक्यूम को चालू कर दो
  • वैक्यूम को बंद कर दो

it-IT

  • Mi accendi l'aspirapolvere in cucina ?
  • fa' partire aspirapolvere
  • fai ripartire l'aspirapolvere
  • la lavatrice è in funzione
  • metti in pausa l'aspirapolvere
  • stoppa l'aspirapolvere

ja-JP

  • お掃除ロボット を リビング で動かして
  • 台所の食洗機 を一時停止してください
  • 掃除機 は作動してる
  • 掃除機 を停止して
  • 掃除機 を再開してください
  • 洗濯機 をスタートさせて

ko-KR

  • 거실 에서 청소기 돌려
  • 건조기 돌아가고 있나
  • 세탁기 좀 돌려 줘
  • 식기 세척기 다시 시작해
  • 청소기 일시 정지
  • 청소기 작동 멈춰 줘

nl-NL

  • De schoonmaakrobot inschakelen in de keuken .
  • Is de stofzuiger klaar
  • hervat de stofzuiger
  • pauzeer de stofzuiger
  • start mijn stofzuiger
  • stop de stofzuiger

pt-BR

  • Inicia o aspersor no jardim
  • Iniciar o aspirador de pó na sala .
  • iniciar a máquina de lavar
  • o aspirador está parado?
  • parar a pausa na máquina de lavar roupa
  • parar o aspirador de pó
  • pausar o aspirador de pó

sv-SE

  • Kör igång sprinklern på gräsmattan .
  • har dammsugaren i vardagsrummet startat?
  • kör igång dammsugaren igen
  • pausa dammsugaren
  • starta tvättmaskinen
  • stoppa dammsugaren

デバイスエラー

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