스마트 홈 ArmDisarm 특성 스키마

action.devices.traits.ArmDisarm - 이 특성은 보안 시스템 등에서 사용되는 무장 및 무장 해제를 지원합니다.

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

기기 속성

이 특성이 있는 기기는 SYNC 작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC 인텐트 처리에 대해 자세히 알아보려면 인텐트 처리를 참고하세요.

속성 유형 설명
availableArmLevels 객체

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

필수사항.

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

보안 수준입니다.
level_name String

필수사항.

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

필수사항.

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

특정 언어의 레벨 동의어입니다. 언어 대체 기능을 제공하려면 lang 값이 en인 항목이 하나 이상 필요합니다.
level_synonym 배열

필수사항.

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

동의어 이름입니다. 언어 대체 기능을 제공하려면 lang 값이 en인 항목이 하나 이상 필요합니다.
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
  }
}

기기 상태

이 특성이 있는 엔티티는 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입니다. 무장 해제할 수 없습니다.
cancel Boolean

필수사항.

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

선택적 보안 수준으로 기기를 설정하거나 해제합니다.

매개변수 유형 설명
followUpToken String

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

필수사항.

명령어가 무장인 경우 true입니다. 무장 해제할 수 없습니다.
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

기기 오류

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