スマートホームの 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 gräsmattan .
  • har dammsugaren i vardagsrummet startat?
  • kör igång dammsugaren igen
  • pausa dammsugaren
  • starta tvättmaskinen
  • stoppa dammsugaren

デバイスエラー

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