Đặc điểm

A đặc điểm trong SDM API bao gồm trường, lệnh và sự kiện.

Trường

Trường là các giá trị có kiểu dữ liệu chung, chẳng hạn như số hoặc chuỗi. Ví dụ: một trường có thể chứa chế độ hiện tại hoặc độ ẩm xung quanh của Google Nest Thermostat.

Bạn có thể xem các đặc điểm và trường bằng lệnh gọi GET đến điểm cuối API mong muốn:

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

Loại thiết bị

Bạn không nên sử dụng sdm.devices.types.device-type do SDM API trả về để suy diễn hoặc suy luận chức năng của thiết bị thực tế được chỉ định. Không có gì đảm bảo rằng một loại thiết bị sẽ ổn định cho một thiết bị cụ thể khi có thêm các tính năng được thêm vào SDM API. Thay vào đó, hãy sử dụng các đặc điểm được trả về cho thiết bị.

parentRelations

Đối tượng parentRelations đại diện cho tài nguyên mẹ của tài nguyên hiện tại, có thể là cấu trúc hoặc phòng. Tên hiển thị tương ứng với trường customName của Info cho các thiết bị có cấu trúc mẹ hoặc đặc điểm RoomInfo cho các thiết bị có phòng mẹ.

Lệnh

Lệnh là các yêu cầu được liên kết với một đặc điểm. Ví dụ: thay đổi chế độ hiện tại hoặc điểm đặt nhiệt độ trên Google Nest Thermostat.

Lệnh được gửi bằng lệnh gọi API executeCommand:

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

Hầu hết các phản hồi đối với một lệnh đều là thành công hoặc thất bại. Hãy xem hướng dẫn về từng đặc điểm để biết các ví dụ cụ thể về cách sử dụng lệnh.

Sự kiện

Các sự kiện không đồng bộ và được Google Cloud Pub/Sub quản lý trong một chủ đề duy nhất cho mỗi Project mã nhận dạng.

Các sự kiện được gửi theo mặc định cho mọi thay đổi về giá trị của trường đặc điểm. Các sự kiện này cũng có thể được gửi để phản hồi các hành động cụ thể của thiết bị hoặc thay đổi về việc chỉ định tài nguyên. Hãy xem Sự kiện để biết thêm thông tin.

Danh mục đặc điểm

Cấu trúc

Đặc điểm
Thông tin
sdm.structures.traits.Info
Đặc điểm này thuộc về mọi cấu trúc để biết thông tin liên quan đến cấu trúc.
RoomInfo
sdm.structures.traits.RoomInfo
Đặc điểm này thuộc về mọi phòng để biết thông tin liên quan đến phòng.

Thiết bị

Đặc điểm
Khả năng kết nối
sdm.devices.traits.Connectivity
Đặc điểm này thuộc về mọi thiết bị có thông tin về khả năng kết nối.
Quạt
sdm.devices.traits.Fan
Đặc điểm này thuộc về mọi thiết bị có khả năng kiểm soát quạt của hệ thống.
Độ ẩm
sdm.devices.traits.Humidity
Đặc điểm này thuộc về mọi thiết bị có cảm biến để đo độ ẩm.
Thông tin
sdm.devices.traits.Info
Đặc điểm này thuộc về mọi thiết bị để biết thông tin liên quan đến thiết bị.
Chế độ cài đặt
sdm.devices.traits.Settings
Đặc điểm này thuộc về mọi thiết bị để biết thông tin về chế độ cài đặt liên quan đến thiết bị.
Nhiệt độ
sdm.devices.traits.Temperature
Đặc điểm này thuộc về mọi thiết bị có cảm biến để đo nhiệt độ.

Máy điều nhiệt

Đặc điểm
ThermostatEco
sdm.devices.traits.ThermostatEco
Đặc điểm này thuộc về các loại thiết bị THERMOSTAT hỗ trợ chế độ ECO.
ThermostatHvac
sdm.devices.traits.ThermostatHvac
Đặc điểm này thuộc về các loại thiết bị THERMOSTAT có thể báo cáo thông tin chi tiết về HVAC.
ThermostatMode
sdm.devices.traits.ThermostatMode
Đặc điểm này thuộc về các loại thiết bị THERMOSTAT hỗ trợ nhiều chế độ máy điều nhiệt.
ThermostatTemperatureSetpoint
sdm.devices.traits.ThermostatTemperatureSetpoint
Đặc điểm này thuộc về các loại thiết bị THERMOSTAT hỗ trợ việc đặt nhiệt độ mục tiêu và phạm vi nhiệt độ.

Máy ảnh

Đặc điểm
CameraClipPreview
sdm.devices.traits.CameraClipPreview
Đặc điểm này thuộc về mọi thiết bị hỗ trợ việc tải bản xem trước đoạn trích xuống.
CameraEventImage
sdm.devices.traits.CameraEventImage
Đặc điểm này thuộc về mọi thiết bị hỗ trợ việc tạo hình ảnh từ các sự kiện.
CameraImage
sdm.devices.traits.CameraImage
Đặc điểm này thuộc về mọi thiết bị hỗ trợ việc chụp ảnh.
CameraLiveStream
sdm.devices.traits.CameraLiveStream
Đặc điểm này thuộc về mọi thiết bị hỗ trợ tính năng phát trực tiếp.
CameraMotion
sdm.devices.traits.CameraMotion
Đặc điểm này thuộc về mọi thiết bị hỗ trợ các sự kiện phát hiện chuyển động.
CameraPerson
sdm.devices.traits.CameraPerson
Đặc điểm này thuộc về mọi thiết bị hỗ trợ các sự kiện phát hiện người.
CameraSound
sdm.devices.traits.CameraSound
Đặc điểm này thuộc về mọi thiết bị hỗ trợ các sự kiện phát hiện âm thanh.

Chuông cửa

Đặc điểm
DoorbellChime
sdm.devices.traits.DoorbellChime
Đặc điểm này thuộc về mọi thiết bị hỗ trợ chuông cửa và các sự kiện nhấn liên quan.