智能家居 ARMDisarm 特征架构

action.devices.traits.ArmDisarm - 此特征支持报警器和报警器等，例如安防系统。

对于具有多个安全级别的设备，应使用 availableArmLevels 属性报告这些级别。

设备属性

具有此特征的设备可能会在 SYNC 操作中报告以下属性。如需详细了解如何处理 SYNC intent，请参阅 intent 执行方式。

属性	类型	说明
availableArmLevels	对象	描述设备支持的安全级别。如果未报告此属性，则表示设备仅支持一个级别。
levels	数组	必填。 设备支持的可用安全等级列表。
[item, ...]	对象	安全级别。
level_name	String	必填。 在命令和状态中使用的安全等级的内部名称。此名称可能不适合用户使用，并且适用于所有语言。
level_values	数组	必填。 包含 level_synonym 和 lang。
[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	必填。 如果指定了 availableArmLevels 属性，则必须提供此属性。如果存在多个安全级别，则表示当前安全级别的名称。
exitAllowance	整数	表示用户必须在 currentArmLevel之前离开的时间（以秒为单位）。

示例

用于报告不同实验组的安防系统

{
  "isArmed": true,
  "currentArmLevel": "L1"
}

设备命令

具有此特征的设备可能会在 EXECUTE 操作中响应以下命令。如需详细了解如何处理 EXECUTE intent，请参阅 intent 执行方式。

action.devices.commands.ArmDisarm

设置此设备的闹钟级别。

参数

载荷包含以下其中一项：

取消实验组或解除停用操作

参数	类型	说明
followUpToken	String	Google 提供的用于跟进响应的令牌。
arm	Boolean	必填。 当命令是武器时，值为 true。如果关闭，则关闭报警器。
cancel	Boolean	必填。 当命令是取消 arm 值时，为 true。

开启/关闭设备报警器，可以选择设置安全等级。

参数	类型	说明
followUpToken	String	Google 提供的用于跟进响应的令牌。
arm	Boolean	必填。 当命令是武器时，值为 true。如果关闭，则关闭报警器。
armLevel	String	要武装的 level_name。

示例

开启系统报警器

{
  "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

设备出错

查看错误和异常的完整列表。