스마트 홈 장면 트레잇 스키마

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

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

예를 들어 기기에서 사용자가 원터치 명령어 그룹화를 구성할 수 있도록 허용하는 경우(예: 조명을 특정 색상으로 설정하거나, 다양한 보안 기능 또는 다른 모든 활동 조합) 이 구성은 SYNC를 통해 이름이 지정된 장면으로 노출될 수 있으며 어시스턴트는 간단한 활성화를 통해 사용자가 이러한 장면을 사용할 수 있도록 합니다.

  • 파티 모드를 시작합니다.
  • 자정 테마를 활성화합니다.

장면은 가상 물체이므로 구분을 위해 방에 배치할 수 있습니다(해당하는 경우).

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

장면과 물리적 대상의 한 가지 차이점은 어시스턴트가 장면 명령어에 복수 효과를 자동으로 적용하여 사용자가 여러 파트너에 걸쳐 장면을 트리거할 수 있다는 것입니다. 예를 들어 사용자가 보안용 파트너와 조명용 파트너 등 두 파트너에 '파티 모드' 장면을 설정했다면 파티 모드 활성화를 실행하면 두 장면이 모두 트리거됩니다.

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

장면에는 항상 사용자가 제공한 이름이 있어야 하며 기본 'BobCo Scene' 이름을 사용해서는 안 됩니다. 각 장면은 고유한 이름을 가진 자체 가상 기기입니다. 사용자가 제공한 이름은 SYNC에서 가져올 수 있습니다.

기기 속성

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

속성 유형 설명
sceneReversible Boolean

(기본값: false)

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

예

역전 가능한 장면을 지원하는 기기

{
  "sceneReversible": true
}

기기 상태

없음

기기 명령어

이 트레잇이 있는 기기는 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
  }
}

기기 오류

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