특성

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에 액세스할 수 있습니다. 대신 기기에 반환된 트레잇을 사용하세요.

parentRelations

parentRelations 객체는 현재 리소스의 상위 리소스를 나타냅니다. 구조물 또는 방입니다. 표시 이름은customName 정보 특성 가 있는 기기의 경우 RoomInfo 트레잇 방 상위자

명령어

명령어는 트레잇과 관련된 요청입니다. 예를 들어, 현재 모드나 Google Nest Thermostat의 온도 설정값입니다.

명령어는 executeCommand API 호출을 통해 전송됩니다.

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

명령어에 대한 응답은 대부분 단순한 성공 또는 실패입니다. 자세한 내용은 개별 트레잇 가이드를 참고하세요. 몇 가지 예시를 살펴보겠습니다.

이벤트

이벤트는 비동기식이며 Google Cloud Pub/Sub에 의해 Project ID.

트레잇 필드의 값이 변경되면 기본적으로 이벤트가 전송됩니다. 또한 특정 기기 작업이나 리소스 할당 변경에 대한 응답입니다. 자세한 내용은 이벤트 를 참조하세요.

트레잇 카테고리

구조

특성
정보
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 모드를 지원하는 THERMOSTAT 기기 유형에 속합니다.
ThermostatHvac
sdm.devices.traits.ThermostatHvac
이 트레잇은 HVAC 세부정보를 보고할 수 있는 THERMOSTAT 기기 유형에 속합니다.
ThermostatMode
sdm.devices.traits.ThermostatMode
이 트레잇은 다양한 온도 조절기 모드를 지원하는 THERMOSTAT 기기 유형에 속합니다.
ThermostatTemperatureSetpoint
sdm.devices.traits.ThermostatTemperatureSetpoint
이 트레잇은 희망 온도와 온도 범위 설정을 지원하는 THERMOSTAT 기기 유형에 속합니다.

카메라

특성
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
이 트레잇은 초인종 차임벨 및 관련 누르기 이벤트를 지원하는 모든 기기에 속합니다.