스마트 홈 ArmDisarm 특성 스키마

action.devices.traits.ArmDisarm - 이 특성은 보안 시스템과 같이 경보 시스템을 설정하고 해제할 수 있습니다.

여러 수준의 보안 수준이 있는 기기의 경우 availableArmLevels 수준으로 이러한 수준을 보고해야 합니다.

기기 속성

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

속성 유형 설명
availableArmLevels 객체

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

levels 배열

필수.

기기에서 지원하는 보안 수준 목록

[item, ...] 객체

보안 수준.

level_name String

필수.

명령어와 상태에서 사용되는 보안 수준의 내부 이름입니다. 이 이름은 사용자 친화적이지 않고 모든 언어에서 공유됩니다.

level_values 배열

필수.

level_synonymlang 포함

[item, ...] 객체

지정된 언어의 등급 동의어입니다.

level_synonym 배열

필수.

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

[item, ...] String

동의어 이름입니다.

lang String

필수.

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

ordered Boolean

필수.

true로 설정하면 레벨 배열 순서에 따라 증가/감소 로직에 대한 추가 문법이 적용됩니다. 예를 들어 "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
  }
}

기기 상태: STATES

이 특성이 있는 항목은 QUERY 작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

상태 유형 설명
isArmed Boolean

필수.

기기가 현재 설정되어 있는지 나타냅니다.

currentArmLevel String

필수.

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

exitAllowance 정수

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

예시

개별 버전 수준을 보고하는 보안 시스템

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

기기 COMMANDS

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

action.devices.commands.ArmDisarm

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

매개변수

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

경보 시스템 설정 또는 해제 해제

매개변수 유형 설명
followUpToken String

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

arm Boolean

필수.

명령어가 ARM인 경우 참입니다. 경보를 해제하려면 거짓입니다.

cancel Boolean

필수.

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

선택적 보안 수준으로 기기의 경보 시스템을 설정하거나 해제합니다.

매개변수 유형 설명
followUpToken String

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

arm Boolean

필수.

명령어가 ARM인 경우 참입니다. 경보를 해제하려면 거짓입니다.

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

기기 ERRORS

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