Smart Home OpenClose Trait 結構定義
action.devices.traits.OpenClose
- 此屬性屬於支援開場及關合裝置,有時可能是部分方向的開放和關閉,或有可能橫跨多個方向。
裝置屬性
具有此特性的裝置可能會在 SYNC
作業中回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱意圖執行要求一文。
屬性 | 類型 | 說明 |
---|---|---|
discreteOnlyOpenClose |
布林 |
(預設: 如果設為 true,表示裝置必須完全開啟或完全關閉 (亦即不支援 0% 到 100% 之間的值)。 |
openDirection |
陣列 |
支援可開啟或關閉的支援路線清單。如果裝置支援在多個方向開啟和關閉,請加入這個屬性。 |
[item, ...] |
字串 |
支援的方向。 支援的值:
|
commandOnlyOpenClose |
布林 |
(預設: 指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法回應此特徵的 QUERY 意圖或報告狀態,請將此屬性設為 true。 |
queryOnlyOpenClose |
布林 |
(預設: 指出裝置是否只能查詢狀態資訊,而且無法控制。如果感應器只能回報開放狀態,則應將這個欄位設為 true。 |
範例
簡單的開放式裝置。
{ "discreteOnlyOpenClose": true }
由下而下的裝置。方向不限。
{ "openDirection": [ "UP", "DOWN" ] }
使用「僅限指令」的裝置。
{ "commandOnlyOpenClose": false }
裝置狀態:STATE
具有此特性的實體可能會在 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%