智能家居 ARMDisarm 特征架构
action.devices.traits.ArmDisarm
- 此特征支持报警器和报警器等,例如安防系统。
对于具有多个安全级别的设备,应使用 availableArmLevels
属性报告这些级别。
设备属性
具有此特征的设备可能会在 SYNC
操作中报告以下属性。如需详细了解如何处理 SYNC
intent,请参阅 intent 执行方式。
属性 | 类型 | 说明 |
---|---|---|
availableArmLevels |
对象 |
描述设备支持的安全级别。如果未报告此属性,则表示设备仅支持一个级别。 |
levels |
数组 |
必填。 设备支持的可用安全等级列表。 |
[item, ...] |
对象 |
安全级别。 |
level_name |
String |
必填。 在命令和状态中使用的安全等级的内部名称。此名称可能不适合用户使用,并且适用于所有语言。 |
level_values |
数组 |
必填。 包含 |
[item, ...] |
对象 |
给定语言的同义词。 |
level_synonym |
数组 |
必填。 关卡支持的语言名称均采用方便用户使用的语言。第一项被视为规范名称。 |
[item, ...] |
String |
同义词名称。 |
lang |
String |
必填。 级别同义词的语言代码。请参阅支持的语言。 |
ordered |
Boolean |
必填。 如果设置为 true,则会按照级别数组的顺序应用有关递增/递减逻辑的其他语法。例如,说“Ok Google,把我的安全等级提高 1”后,Google 助理会确定当前安全等级,然后将该安全等级提高 1。如果此值设置为 false,则不支持用于增加/减少逻辑的额外语法。 |
示例
具有两个不同分支级别的安全系统
{ "availableArmLevels": { "levels": [ { "level_name": "L1", "level_values": [ { "level_synonym": [ "Home and Guarding", "SL1" ], "lang": "en" }, { "level_synonym": [ "Zuhause und Bewachen", "SL1" ], "lang": "de" } ] }, { "level_name": "L2", "level_values": [ { "level_synonym": [ "Away and Guarding", "SL2" ], "lang": "en" }, { "level_synonym": [ "Weg und Bewachen", "SL2" ], "lang": "de" } ] } ], "ordered": true } }
设备状态
具有此特征的实体可能会在 QUERY
操作中报告以下状态。如需详细了解如何处理 QUERY
intent,请参阅 intent 执行方式。
州 | 类型 | 说明 |
---|---|---|
isArmed |
Boolean |
必填。 指示设备当前是否已开启报警器。 |
currentArmLevel |
String |
必填。 如果指定了 |
exitAllowance |
整数 |
表示用户必须在 |
示例
用于报告不同实验组的安防系统
{ "isArmed": true, "currentArmLevel": "L1" }
设备命令
具有此特征的设备可能会在 EXECUTE
操作中响应以下命令。如需详细了解如何处理 EXECUTE
intent,请参阅 intent 执行方式。
action.devices.commands.ArmDisarm
设置此设备的闹钟级别。
参数
载荷包含以下其中一项:
取消实验组或解除停用操作
参数 | 类型 | 说明 |
---|---|---|
followUpToken |
String |
Google 提供的用于跟进响应的令牌。 |
arm |
Boolean |
必填。 当命令是武器时,值为 true。如果关闭,则关闭报警器。 |
cancel |
Boolean |
必填。 当命令是取消 |
开启/关闭设备报警器,可以选择设置安全等级。
参数 | 类型 | 说明 |
---|---|---|
followUpToken |
String |
Google 提供的用于跟进响应的令牌。 |
arm |
Boolean |
必填。 当命令是武器时,值为 true。如果关闭,则关闭报警器。 |
armLevel |
String |
要武装的 |
示例
开启系统报警器
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "followUpToken": "123" } }
将系统设置为 ARM 级别 L1
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "armLevel": "L1", "followUpToken": "456" } }
取消报警器操作
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "cancel": true } }
相关错误
开启或关闭设备时出错。
支持的值:
alreadyInState
deviceTampered
passphraseIncorrect
pinIncorrect
securityRestriction
tooManyFailedAttempts
userCancelled