スマートホームの StartStop トレイトのスキーマ
action.devices.traits.StartStop
- このトレイトは、オペレーションの開始と停止をサポートするデバイスに属します。
デバイスの起動と停止は、オン / オフと同様の機能を提供します。このトレイトを継承するデバイスは、電源をオン / 始動すると動作が異なります。たとえば、洗濯機の中には、実際に動作を開始する前に電源を入れて設定を変更できるものがあります。
単にオンとオフの状態を持つデバイスとは異なり、起動と停止を行うことができるデバイスの中には、動作中に一時停止できるものもあります。一時停止できるデバイスは動作を停止しますが、再開すると一時停止したときと同じ状態が続きます。一時停止解除は、デバイスの現在の状態に関係のない、起動 / 再起動とは異なります。こちらは最初から動作を開始します。
一部のデバイスは特定ゾーンでの実行をサポートしています。たとえばスプリンクラーには複数の散水ゾーンがあり、特定のゾーンに別々に散水する機能をサポートできますが、掃除機は特定の部屋の清掃をサポートできます。
デバイスの属性
この特性を持つデバイスは、SYNC
オペレーションの一部として次の属性を報告する可能性があります。SYNC
インテントの処理の詳細については、インテント フルフィルメントをご覧ください。
属性 | タイプ | 説明 |
---|---|---|
pausable |
ブール値 |
(デフォルト: 動作中にデバイスを一時停止できるかどうかを示します。 |
availableZones |
配列 |
サポートされているゾーン名を示します。文字列は、ユーザーが設定したとおりにローカライズする必要があります。このリストはすべてを網羅しているわけではありません。ユーザーは任意の名前を報告できます。 |
[item, ...] |
文字列 |
開始デバイスがサポートされているゾーンの名前。 |
例
一時停止可能で、複数のゾーンで動作するデバイス。
{ "pausable": true, "availableZones": [ "Kitchen", "Living room", "Office", "Bedroom" ] }
デバイスのステータス
この特性を持つエンティティは、QUERY
オペレーションの一部として次の状態をレポートできます。QUERY
インテントの処理の詳細については、インテント フルフィルメントをご覧ください。
状態 | タイプ | 説明 |
---|---|---|
isRunning |
ブール値 |
必須。 デバイスが現在動作中かどうかを示します。 |
isPaused |
ブール値 |
デバイスが明示的に一時停止されているかどうかを示します。この値が true の場合、 |
activeZones |
配列 |
|
[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 つ以上のゾーンを示します。 |
[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 inthe 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 dansle 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 inde keuken . -
Is
de stofzuiger klaar -
hervat
de stofzuiger -
pauzeer
de stofzuiger -
start
mijn stofzuiger -
stop
de stofzuiger
pt-BR
-
Inicia
o aspersor nojardim -
Iniciar
o aspirador de pó nasala . -
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