특성

SDM API의 트레잇은 필드, 명령어, 이벤트로 구성됩니다.

필드

필드는 숫자, 문자열과 같이 일반적인 데이터 유형을 포함하는 값입니다. 예를 들어 필드에 Google Nest Thermostat의 현재 모드나 주변 습도가 포함될 수 있습니다.

특성과 필드는 원하는 API 엔드포인트에 대한 GET 호출을 통해 볼 수 있습니다.

GET /enterprises/project-id/devices/device-id
{
  "name" : "enterprises/project-id/devices/device-id",
  "type" : "sdm.devices.types.device-type",
  "traits" : { ... },
  "parentRelations" : [
    {
      "parent" : "enterprises/project-id/structures/structure-id/rooms/room-id",
      "displayName" : "Lobby"
    }
  ]
}

기기 유형

SDM API에서 반환된 sdm.devices.types.device-type는 할당된 실제 기기의 기능을 추론하거나 추론하는 데 사용하면 안 됩니다. SDM API에 더 많은 기능이 추가됨에 따라 기기 유형이 특정 기기에서 안정적으로 유지된다는 보장은 없습니다. 대신, 기기에 반환된 trait을 사용하세요.

parentRelations

parentRelations 객체는 현재 리소스의 상위 리소스(구조 또는 방)를 나타냅니다. 표시 이름은 상위 요소가 있는 기기의 경우정보 특성 또는 상위 요소가 있는 기기의RoomInfo 트레잇 에 해당합니다.

명령어

명령어는 특성과 연결된 요청입니다. Google Nest Thermostat의 현재 모드 또는 온도 설정값을 변경하는 경우가 그 예에 해당합니다.

명령어는 executeCommand API 호출로 전송됩니다.

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "command-name",
  "params" : {
    "field" : "value"
  }
}

명령어에 대한 응답은 대부분 단순한 성공 또는 실패입니다. 구체적인 명령어 사용 예는 개별 특성 가이드를 참조하세요.

이벤트

이벤트는 비동기식이며 Project ID당 단일 주제에서 Google Cloud Pub/Sub에 의해 관리됩니다.

trait 필드의 값이 변경되면 이벤트가 기본적으로 전송됩니다. 특정 기기 작업이나 리소스 할당 변경에 관한 응답으로 전송될 수도 있습니다. 자세한 내용은 이벤트를 참고하세요.

특성 카테고리

구조

특성
정보	sdm.structures.traits.Info 이 특성은 구조 관련 정보의 모든 구조에 속합니다.
RoomInfo	sdm.structures.traits.RoomInfo 이 특성은 모든 방에 해당되며 방 관련 정보를 얻을 수 있습니다.

기기

특성
연결	sdm.devices.traits.Connectivity 이 특성은 연결 정보가 있는 모든 기기에 속합니다.
팬	sdm.devices.traits.Fan 이 특성은 팬 제어 시스템 기능이 있는 모든 기기에 속합니다.
습도	sdm.devices.traits.Humidity 이 특성은 습도를 측정하는 센서가 있는 모든 기기에 속합니다.
정보	sdm.devices.traits.Info 이 특성은 모든 기기에 속하는 기기 관련 정보입니다.
설정	sdm.devices.traits.Settings 이 특성은 기기 관련 설정 정보에 관한 모든 기기에 속합니다.
온도	sdm.devices.traits.Temperature 이 특성은 온도를 측정하는 센서가 있는 모든 기기에 속합니다.

온도 조절기

특성
ThermostatEco	sdm.devices.traits.ThermostatEco 이 특성은 ECO 모드를 지원하는 온도 조절기의 기기 유형에 속합니다.
ThermostatHvac	sdm.devices.traits.ThermostatHvac 이 특성은 HVAC 세부정보를 보고할 수 있는 온도 조절기의 기기 유형에 속합니다.
ThermostatMode	sdm.devices.traits.ThermostatMode 이 특성은 다양한 온도 조절기 모드를 지원하는 온도 조절기의 기기 유형에 속합니다.
ThermostatTemperatureSetpoint	sdm.devices.traits.ThermostatTemperatureSetpoint 이 특성은 희망 온도와 온도 범위 설정을 지원하는 온도 조절기의 기기 유형에 속합니다.

카메라

특성
CameraClipPreview	sdm.devices.traits.CameraClipPreview 이 특성은 클립 미리보기 다운로드를 지원하는 모든 기기에 속합니다.
CameraEventImage	sdm.devices.traits.CameraEventImage 이 특성은 이벤트에서 이미지 생성을 지원하는 모든 기기에 속합니다.
CameraImage	sdm.devices.traits.CameraImage 이 특성은 이미지 촬영을 지원하는 모든 기기에 속합니다.
CameraLiveStream	sdm.devices.traits.CameraLiveStream 이 특성은 실시간 스트리밍을 지원하는 모든 기기에 속합니다.
CameraMotion	sdm.devices.traits.CameraMotion 이 특성은 움직임 감지 이벤트를 지원하는 모든 기기에 속합니다.
CameraPerson	sdm.devices.traits.CameraPerson 이 특성은 사람 감지 이벤트를 지원하는 모든 기기에 속합니다.
CameraSound	sdm.devices.traits.CameraSound 이 특성은 소리 감지 활동을 지원하는 모든 기기에 속합니다.

초인종

특성
DoorbellChime	sdm.devices.traits.DoorbellChime 이 특성은 초인종 차임벨 및 관련 누르기 이벤트를 지원하는 모든 기기에 속합니다.