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

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

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

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

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

デバイスの属性

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

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

（デフォルト: false）

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

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

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

例

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

{
  "pausable": true,
  "availableZones": [
    "Kitchen",
    "Living room",
    "Office",
    "Bedroom"
  ]
}

デバイスのステータス

このトレイトを使用するエンティティは、QUERY オペレーションの一部として次の状態を報告できます。QUERY インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。

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

必須。

デバイスが現在動作中かどうかを示します。
isPaused ブール値

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

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

ゾーン名。

例

デバイスは一時停止していますか？

{
  "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 String

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

実行を開始する複数のゾーンを示します。zone parameter. の代わりに設定されます
[item, ...] String

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

例

デバイスを起動します。

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

デバイスエラー

エラーと例外の全一覧をご覧ください。