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

스마트 홈 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로 설정하면 수준 배열에 따라 증가/감소 로직의 추가 문법이 적용됩니다. 예를 들어 "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"
  }
}

시스템을 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

기기 오류

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