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

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
  }
}

기기 오류

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