智能家居 OpenClose 特征架构
action.devices.traits.OpenClose
- 此特征属于支持打开和关闭,以及在某些情况下打开或关闭多个方向的设备。
设备属性
具有此特征的设备可能会在 SYNC
操作中报告以下属性。如需详细了解如何处理 SYNC
intent,请参阅 intent 执行方式。
属性 | 类型 | 说明 |
---|---|---|
discreteOnlyOpenClose |
Boolean |
(默认值: 如果设置为 true,则表示设备必须处于完全打开或完全关闭的状态(即,不支持 0% 到 100% 之间的值)。 |
openDirection |
数组 |
设备可在其中打开或关闭的受支持路线列表。如果设备支持在多个方向上开启和关闭,请添加此属性。 |
[item, ...] |
String |
支持的方向。 支持的值:
|
commandOnlyOpenClose |
Boolean |
(默认值: 指明设备是否支持单向 (true) 或双向 (false) 通信。如果设备无法响应此特征的 QUERY intent 或报告状态,请将此属性设为 true。 |
queryOnlyOpenClose |
Boolean |
(默认值: 指示是否只能查询设备的状态信息,而无法控制设备。只能报告打开状态的传感器应将此字段设置为 true。 |
示例
简单的开合设备。
{ "discreteOnlyOpenClose": true }
自下而上的自下而上设备。可向任一方向打开。
{ "openDirection": [ "UP", "DOWN" ] }
纯命令设备。
{ "commandOnlyOpenClose": false }
设备状态
具有此特征的实体可能会在 QUERY
操作中报告以下状态。如需详细了解如何处理 QUERY
intent,请参阅 intent 执行方式。
载荷包含以下其中一项:
单向开合
州 | 类型 | 说明 |
---|---|---|
openPercent |
编号 |
必填。 表示设备已打开的百分比,其中 0 表示关闭,100 表示完全打开。 |
多方向开/关
州 | 类型 | 说明 |
---|---|---|
openState |
数组 |
必填。 每个支持的打开方向的状态列表。 |
[item, ...] |
对象 |
给定打开方向的当前状态。 |
openPercent |
编号 |
必填。 表示设备已打开的百分比,其中 0 表示关闭,100 表示完全打开。 |
openDirection |
String |
必填。 设备的打开方向。 支持的值:
|
示例
简单的开合设备。
{ "openPercent": 100 }
以 30% 的向下方向打开设备,以 50% 的向上方向打开设备。
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] }
设备命令
具有此特征的设备可能会在 EXECUTE
操作中响应以下命令。如需详细了解如何处理 EXECUTE
intent,请参阅 intent 执行方式。
action.devices.commands.OpenClose
设置设备的开/关状态。
参数
参数 | 类型 | 说明 |
---|---|---|
openPercent |
编号 |
必填。 表示设备已打开的百分比,其中 0 表示关闭,100 表示完全打开。 |
openDirection |
String |
打开方向。仅当设备支持多条路线(如 支持的值:
|
followUpToken |
String |
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
操作中返回以下后续响应载荷。如需详细了解如何实现后续响应,请参阅智能家居 Action 通知。
载荷包含以下其中一项:
成功
字段 | 类型 | 说明 |
---|---|---|
followUpToken |
String |
必填。 原始 EXECUTE 请求中提供的令牌。 |
status |
String |
必填。 请求的结果。 支持的值:
|
openPercent |
编号 |
必填。 表示设备已打开且设备关闭 0 而完全打开 100 的百分比。 |
失败
字段 | 类型 | 说明 |
---|---|---|
followUpToken |
String |
必填。 原始 EXECUTE 请求中提供的令牌。 |
status |
String |
必填。 请求的结果。 支持的值:
|
errorCode |
String |
必填。 该值可以是此特征的任何错误代码,例如 |
示例
打开车库门。(成功案例的跟进回复)
{ "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 |
String |
打开方向。仅当设备支持多条路线(如 支持的值:
|
示例
稍微打开设备
{ "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%