スマートホームの OpenClose トレイトのスキーマ
action.devices.traits.OpenClose
- このトレイトは、開始と終了(場合によっては複数の方向の開閉)をサポートするデバイスを対象としています。
デバイスの属性
この特性を持つデバイスは、SYNC
オペレーションの一部として次の属性を報告する可能性があります。SYNC
インテントの処理の詳細については、インテント フルフィルメントをご覧ください。
属性 | タイプ | 説明 |
---|---|---|
discreteOnlyOpenClose |
ブール値 |
(デフォルト: true に設定すると、デバイスは完全に開いているか、完全に閉じている必要があります(0 ~ 100% の値はサポートされません)。 |
openDirection |
配列 |
デバイスで開く、または閉じることができるサポートされている方向のリスト。デバイスが複数の方向の開閉に対応している場合は、この属性を使用します。 |
[item, ...] |
文字列 |
サポートされている方向。 サポートされている値:
|
commandOnlyOpenClose |
ブール値 |
(デフォルト: デバイスが一方向(True)または双方向(False)の通信をサポートしているかどうかを示します。デバイスがこのトレイトの QUERY インテントまたは Report State に応答できない場合は、この属性を true に設定します。 |
queryOnlyOpenClose |
ブール値 |
(デフォルト: デバイスにクエリできるのは状態情報のみであり、制御できないかどうかを示します。開いている状態のみを報告できるセンサーは、このフィールドを true に設定する必要があります。 |
例
シンプルな開閉デバイス。
{ "discreteOnlyOpenClose": true }
トップダウンのボトムアップ デバイス。どちらの方向にも開くことができます。
{ "openDirection": [ "UP", "DOWN" ] }
コマンドのみのデバイス。
{ "commandOnlyOpenClose": false }
デバイスのステータス
この特性を持つエンティティは、QUERY
オペレーションの一部として次の状態をレポートできます。QUERY
インテントの処理の詳細については、インテント フルフィルメントをご覧ください。
ペイロードには次のいずれかが含まれています。
一方向で開閉する
状態 | タイプ | 説明 |
---|---|---|
openPercent |
Number |
必須。 デバイスが開いている割合です。0 は閉じており、100 は完全に開いています。 |
多方向開閉
状態 | タイプ | 説明 |
---|---|---|
openState |
配列 |
必須。 サポートされている各オープン方向の状態のリスト。 |
[item, ...] |
オブジェクト |
指定されたオープン方向の現在の状態。 |
openPercent |
Number |
必須。 デバイスが開いている割合です。0 は閉じており、100 は完全に開いています。 |
openDirection |
文字列 |
必須。 デバイスが開いている方向。 サポートされている値:
|
例
シンプルな開閉デバイス。
{ "openPercent": 100 }
デバイスを下方向に 30%、上方向に 50% 開いてください。
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] }
デバイスのコマンド
この特性を持つデバイスは、EXECUTE
オペレーションの一部として次のコマンドに応答できます。EXECUTE
インテントの処理の詳細については、インテント フルフィルメントをご覧ください。
action.devices.commands.OpenClose
デバイスの開閉状態を設定します。
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
openPercent |
Number |
必須。 デバイスが開いている割合です。0 は閉じており、100 は完全に開いています。 |
openDirection |
文字列 |
開く方向。 サポートされている値:
|
followUpToken |
文字列 |
フォローアップ レスポンス用の Google 提供のトークン。 |
例
デバイスを開きます。
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 100, "followUpToken": "123" } }
デバイスを 50% 下で開きます。
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 50, "openDirection": "DOWN", "followUpToken": "456" } }
関連エラー
デバイスの開閉状態の設定中にエラーが発生しました。
サポートされている値:
lockedState
deviceJammingDetected
フォローアップの回答
この特性を持つデバイスは、EXECUTE
オペレーションの一部として次のフォローアップ レスポンス ペイロードを返すことがあります。フォローアップ レスポンスの実装の詳細については、スマートホーム アクションの通知をご覧ください。
ペイロードには次のいずれかが含まれています。
成功
フィールド | タイプ | 説明 |
---|---|---|
followUpToken |
文字列 |
必須。 元の EXECUTE リクエストで提供されたトークン。 |
status |
文字列 |
必須。 リクエストの結果。 サポートされている値:
|
openPercent |
Number |
必須。 デバイスが開いているパーセンテージを示します。0 は閉じているが、100 は完全に開いています。 |
失敗
フィールド | タイプ | 説明 |
---|---|---|
followUpToken |
文字列 |
必須。 元の EXECUTE リクエストで提供されたトークン。 |
status |
文字列 |
必須。 リクエストの結果。 サポートされている値:
|
errorCode |
文字列 |
必須。 この値には、任意のトレイトのエラーコード(例: |
例
車庫のドアを開けます。(成功例に対するフォローアップの回答)
{ "OpenClose": { "priority": 0, "followUpResponse": { "openPercent": 100, "status": "SUCCESS", "followUpToken": "1234" } } }
車庫のドアを開けます。(障害が発生した場合のフォローアップ レスポンス)。
{ "OpenClose": { "priority": 0, "followUpResponse": { "errorCode": "lockedState", "status": "FAILURE", "followUpToken": "1234" } } }
action.devices.commands.OpenCloseRelative
現在の状態を基準にしてデバイスの開閉状態を調整します。このコマンドは、commandOnlyOpenClose
が false
に設定されている場合にのみ使用できます。
{ "commandOnlyOpenClose": false }
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
openRelativePercent |
Number |
必須。 開閉状態を変更する正確な割合。あいまいな相対コマンドは、正確な割合パラメータに変換されます(たとえば、「ブラインドをもう少し開いて」と「ブラインドを 5% 開けて」)。 |
openDirection |
文字列 |
開く方向。 サポートされている値:
|
例
デバイスをもう少し開いてください。
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 5 } }
デバイスをあと 10% 閉じる
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": -10 } }
デバイスを下に 50% 開いてください。
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 50, "openDirection": "DOWN" } }
関連エラー
デバイスの開閉状態の設定中にエラーが発生しました。
サポートされている値:
lockedState
deviceJammingDetected
サンプル音声
de-DE
-
Bitte öffne
die Jalousien auf30% -
Fensterläden um25 % schliessen -
Ist
die Jalousie zu? -
Mach
den Rollladen zu -
Mach
die Rollos auf -
schließe
die Rollläden ein bisschen mehr -
Öffne
die Jalousien um25%
en-US
-
Are
the blinds in the kitchen open -
Close
the blinds 25% inmy room -
Close
the door more -
Just close
the front door -
open
the blinds in my room -
open
the blinds to25% -
open
the door by25%
es-ES
-
abre
la ventana del salón -
cerrar
persianas del dormitorio un20% -
cierra
la cortina del salón -
cierra
mucho másla ventana -
está abierta
la puerta -
quiero que subas
la persiana al25% -
sube un
20% las persianas
fr-FR
-
baisse
les stores de10% -
est-ce que
la porte d'entrée est ouverte -
ferme
les stores -
ferme
un peu les stores -
ouvre
les stores -
ouvre
les stores de la chambre de25% -
ouvre
les stores à25%
hi-IN
-
कृपया
25% पर्दे को खुला रखो -
क्या मैंने
सामने वाला दरवाजा खुला छोड दिया? -
पर्दे को25% बंद करोगे -
पर्दे खोलो -
ब्लाइंड 25% खुले पर सेट कर दीजिए -
ब्लाइंड कोथोड़ा और बंद कर दिजिए -
ब्लाइंड बंद करें
it-IT
-
abbassa
un po' di piùle tapparelle -
apri
la serranda -
apri
la tapparella al30% -
apri
le serrande del30% -
chiudi
le serrande -
chiudi
le tende del25% -
è aperta
la porta d'ingresso
ja-JP
-
25% にブラインド を開けて -
25% ブラインド を閉めてください -
25% ブラインド 開けて -
ブラインド 閉めて -
ブラインド 開けて -
少し ブラインド を閉じて -
玄関のドア は開いてますか
ko-KR
-
문 살짝만 닫아 줘 -
블라인드 25% 열어 줘 -
블라인드 25% 까지 열어 줘 -
블라인드 30프로 닫아 -
블라인드 닫아 줘 -
블라인드 열어 줘 -
안방 문 열렸어
nl-NL
-
doe
de gordijnen 25% open -
doe
de jaloezieën voor25% dicht -
doe
het raam ietsje meer dicht -
is
de voordeur open -
open
de gordijnen -
sluit
het gordijn -
zet
de luxaflex voor50% open
pt-BR
-
Abrir
janela 50% -
As cortinas estão abertas? -
Fecha
a persiana toda -
Fechar
a janela 10% -
a cortina do quarto está aberta? -
abra
a persiana até30% -
abre
as cortinas -
abre
as cortinas a50% -
abrir
as cortinas -
abrir
as cortinas na sala em30% -
fecha
a persiana por favor -
fecha
um bocado a janela -
fechar
as cortinas em25% -
fechar
um pouco maisas cortinas
sv-SE
-
Dra
upp persiennerna -
Dra
upp
persiennerna till25% -
stäng
persiennen i mitt rum 25% -
stäng
persiennerna -
är
ytterdörren öppen? -
öppna
persiennerna med25%