스마트 홈 장면 장면 스키마

action.devices.traits.Scene - 이 특성은 가상 기기 및 장면 기기 유형을 구현하는 데 사용됩니다.

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

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

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

명확성을 위해 (해당하는 경우) 가상 장면으로 장면을 장면에 배치할 수 있습니다.

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

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

장면은 커스텀 문법을 위해 예정된 개인 작업과 잘 상호작용합니다(예: Activate Party Mode -> 시작하기).

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

기기 속성

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

속성 유형 설명
sceneReversible Boolean

(기본값: false)

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

예시

되돌릴 수 있는 장면을 지원하는 기기입니다.

{
  "sceneReversible": true
}

기기 상태: STATES

없음

기기 COMMANDS

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

action.devices.commands.ActivateScene

장면을 활성화하거나 비활성화합니다.

매개변수

매개변수 유형 설명
deactivate Boolean

필수.

되돌릴 수 있는 경우 장면을 취소하려면 True로, 장면을 활성화하려면 False로 설정합니다.

예시

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

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

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

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

기기 ERRORS

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