스마트 홈 장면 특성 스키마

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

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

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

  • 파티 모드를 시작합니다.
  • 자정 장면을 활성화합니다.

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

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

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

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

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

기기 ATTRIBUTES

이 특성이 있는 기기는 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
  }
}

기기 오류

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