스마트 홈 ArmDisarm 트레잇 스키마

action.devices.traits.ArmDisarm - 이 트레잇은 보안 시스템과 같이 사용되는 경보 설정 및 해제를 지원합니다.

보안 수준이 여러 개인 기기의 경우 이러한 수준을 availableArmLevels 속성으로 보고해야 합니다.

기기 속성

이 트레잇이 있는 기기는 SYNC 작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

속성 유형 설명
availableArmLevels 객체

기기에서 지원되는 보안 수준을 설명합니다. 이 속성이 보고되지 않으면 기기는 하나의 수준만 지원합니다.
levels 배열

필수사항.

기기에서 지원하는 사용 가능한 보안 수준 목록입니다.
[item, ...] 객체

보안 수준
level_name String

필수사항.

명령어와 상태에 사용되는 보안 수준의 내부 이름입니다. 이 이름은 사용자 친화적이지 않을 수 있으며 모든 언어로 공유됩니다.
level_values 배열

필수사항.

level_synonym 및 lang를 포함합니다.
[item, ...] 객체

특정 언어의 수준 동의어입니다.
level_synonym 배열

필수사항.

지원되는 각 언어의 등급에 대한 사용자 친화적인 이름입니다. 첫 번째 항목은 표준 이름으로 처리됩니다.
[item, ...] String

동의어 이름입니다.
lang String

필수사항.

등급 동의어의 언어 코드입니다. 지원되는 언어를 참고하세요.
ordered Boolean

필수사항.

true로 설정하면 증가/감소 로직의 추가 문법이 levels 배열의 순서대로 적용됩니다. 예를 들어 'Hey Google, 보안 수준 1단계 올려 줘'라고 말하면 어시스턴트가 현재 보안 수준을 확인한 후 보안 수준을 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 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

주 유형 설명
isArmed Boolean

필수사항.

기기가 현재 경보 시스템이 설정되어 있는지 여부를 나타냅니다.
currentArmLevel String

필수사항.

availableArmLevels 속성이 지정된 경우 필수입니다. 보안 수준이 여러 개인 경우 현재 보안 수준의 이름을 나타냅니다.
exitAllowance 정수

currentArmLevel이 적용되기 전에 사용자가 앱을 종료해야 하는 시간(초)을 나타냅니다.

예

고유한 경보 설정 수준을 보고하는 보안 시스템

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

기기 명령어

이 트레잇이 있는 기기는 EXECUTE 작업의 일부로 다음 명령어에 응답할 수 있습니다. EXECUTE 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

action.devices.commands.ArmDisarm

이 기기의 알람 수준을 설정합니다.

매개변수

페이로드에는 다음 중 하나가 포함됩니다.

경보 시스템 설정 또는 해제 작업 취소

매개변수 유형 설명
followUpToken String

후속 응답을 위해 Google에서 제공한 토큰입니다.
arm Boolean

필수사항.

명령어가 무장하는 경우 true입니다. False: 무장 해제
cancel Boolean

필수사항.

명령어가 arm 값을 취소하는 경우 true입니다.

보안 수준(선택사항)을 사용하여 기기를 설정 또는 해제합니다.

매개변수 유형 설명
followUpToken String

후속 응답을 위해 Google에서 제공한 토큰입니다.
arm Boolean

필수사항.

명령어가 무장하는 경우 true입니다. False: 무장 해제
armLevel String

경보를 설정할 level_name입니다.

예

시스템 설정

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "followUpToken": "123"
  }
}

시스템을 경보 수준 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

기기 오류

오류 및 예외의 전체 목록을 참고하세요.