스마트 홈 작업을 개발하는 방법을 알아볼 수 있는 새로운 공간인 Google Home 개발자 센터에 오신 것을 환영합니다. 참고: Actions 콘솔에서 작업을 계속 만들 수 있습니다.
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

스마트 홈 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
  }
}

기기 상태

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

상태 유형 설명
isArmed Boolean

필수사항.

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

currentArmLevel String

필수사항.

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

exitAllowance 정수

currentArmLevel가 적용되기 전에 사용자가 떠날 시간을 초 단위로 나타냅니다.

별도의 경보 수준 수준을 보고하는 보안 시스템

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

기기 명령어

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

action.devices.commands.ArmDisarm

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

매개변수

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

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

매개변수 유형 설명
followUpToken String

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

arm Boolean

필수사항.

arm을 설정하는 경우 true입니다. 경보 시스템을 해제하려면 거짓입니다.

cancel Boolean

필수사항.

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

보안 수준(선택사항)으로 기기를 경보 시스템을 설정하거나 해제합니다.

매개변수 유형 설명
followUpToken String

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

arm Boolean

필수사항.

arm을 설정하는 경우 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

기기 오류

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