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

스마트 홈 장면 특성 스키마

action.devices.traits.Scene: 이 기능은 SCENE 기기 유형과 함께 가상 기기를 구현하는 데 사용됩니다.

자세한 내용은 장면 유형 가이드를 참고하세요.

예를 들어 기기에서 사용자가 원터치 그룹화 구성(조명을 특정 색상으로 설정, 다양한 보안 기능 시퀀싱 또는 기타 활동 조합)을 할 수 있도록 허용하는 경우 SYNC를 통해 이름이 지정된 장면으로 이 구성을 노출할 수 있고 어시스턴트는 간단한 활성화 문법을 통해 이러한 장면을 사용자에게 제공할 수 있습니다.

  • 파티 모드 시작.
  • 미드나이트 장면 활성화

가상 객체인 경우 명확성을 위해 장면 (관련 있는 경우)에 장면을 배치할 수 있습니다.

  • 주방에서 파티 시간을 시작하세요.
  • 침실에서 야간 모드를 활성화합니다.

장면과 물리적 타겟의 한 가지 차이점은 어시스턴트가 장면 명령어에 복수 효과를 자동으로 적용하여 사용자가 여러 파트너에서 장면을 트리거할 수 있다는 점입니다. 예를 들어 2명의 다른 파트너, 즉 보안과 조명에 각각 '파티 모드' 장면이 있는 사용자가 있는 경우 파티 모드 활성화 장면이 모두 트리거됩니다.

장면은 맞춤 문법을 위해 예정된 개인 작업과 잘 상호작용합니다(예: 파티 모드 활성화 -> 파티 시작).

장면에는 항상 사용자가 제공한 이름과 기본 'BobCo 장면'을 지정해야 합니다. 각 장면은 이름이 지정된 자체 가상 기기입니다. 사용자 제공 이름은 SYNC에서 가져올 수 있습니다.

기기 속성

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

속성 유형 설명
sceneReversible Boolean

(기본값: false)

이 장면을 취소할 수 있음을 나타냅니다. 이 속성은 상태를 수정하고 이전 상태를 기억하는 장면과만 관련이 있습니다. 기기는 deactivate 매개변수가 true인 ActivateScene 명령어를 지원합니다.

가역 장면을 지원하는 기기

{
  "sceneReversible": true
}

기기 상태

없음.

기기 명령어

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

action.devices.commands.ActivateScene

장면을 활성화 또는 비활성화합니다.

매개변수

매개변수 유형 설명
deactivate Boolean

필수.

가역인 경우 true를 true로 설정하고 장면을 활성화하려면 false로 설정합니다.

이름별로 장면을 활성화합니다.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": false
  }
}

이름별로 장면을 비활성화합니다.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": true
  }
}

기기 오류

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