スマートホームの 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 |
番号 |
必須。 デバイスが開いているパーセンテージを示します。0 は閉じた状態、100 は完全に開いた状態です。 |
多方向開閉
状態 | タイプ | 説明 |
---|---|---|
openState |
配列 |
必須。 サポートされている各オープン方向の状態のリスト。 |
[item, ...] |
温度計 |
指定された開通方向の現在の状態。 |
openPercent |
番号 |
必須。 デバイスが開いているパーセンテージを示します。0 は閉じた状態、100 は完全に開いた状態です。 |
openDirection |
文字列 |
必須。 デバイスが開いている方向。 サポートされている値:
|
例
シンプルな開閉デバイス。
{ "openPercent": 100 }
デバイスを下に 30%、上方向に 50% 開けます。
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] }
デバイスのコマンド
このトレイトを持つデバイスは、EXECUTE
オペレーションの一部として次のコマンドに応答できます。EXECUTE
インテントの処理方法については、インテントのフルフィルメントをご覧ください。
action.devices.commands.OpenClose
デバイスの開閉状態を設定します。
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
openPercent |
番号 |
必須。 デバイスが開いているパーセンテージを示します。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 |
番号 |
必須。 デバイスが開いているパーセンテージを示します。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 |
番号 |
必須。 開閉状態を変更する正確な割合。あいまいな相対コマンドは、正確なパーセンテージ パラメータに変換されます(たとえば、「ブラインドを少し開けて」と「ブラインドを 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 auf 30%
- Fensterläden um 25 % schliessen
- Ist die Jalousie zu?
- Mach den Rollladen zu
- Mach die Rollos auf
- schließe die Rollläden ein bisschen mehr
- Öffne die Jalousien um 25%
en-US
- Are the blinds in the kitchen open
- Close the blinds 25% in my room
- Close the door more
- Just close the front door
- open the blinds in my room
- open the blinds to 25%
- open the door by 25%
es-ES
- abre la ventana del salón
- cerrar persianas del dormitorio un 20%
- cierra la cortina del salón
- cierra mucho más la ventana
- está abierta la puerta
- quiero que subas la persiana al 25%
- sube un 20% las persianas
fr-FR
- baisse les stores de 10%
- 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 de 25%
- ouvre les stores à 25%
hi-IN
- कृपया 25% पर्दे को खुला रखो
- क्या मैंने सामने वाला दरवाजा खुला छोड दिया?
- पर्दे को 25% बंद करोगे
- पर्दे खोलो
- ब्लाइंड 25% खुले पर सेट कर दीजिए
- ब्लाइंड को थोड़ा और बंद कर दिजिए
- ब्लाइंड बंद करें
it-IT
- abbassa un po' di più le tapparelle
- apri la serranda
- apri la tapparella al 30%
- apri le serrande del 30%
- chiudi le serrande
- chiudi le tende del 25%
- è 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 voor 25% dicht
- doe het raam ietsje meer dicht
- is de voordeur open
- open de gordijnen
- sluit het gordijn
- zet de luxaflex voor 50% 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 a 50%
- abrir as cortinas
- abrir as cortinas na sala em 30%
- fecha a persiana por favor
- fecha um bocado a janela
- fechar as cortinas em 25%
- fechar um pouco mais as cortinas
sv-SE
- Dra upp persiennerna
- Dra upp persiennerna till 25%
- stäng persiennen i mitt rum 25%
- stäng persiennerna
- är ytterdörren öppen?
- öppna persiennerna med 25%