Đặc điểm

Một đặc điểm trong SDM API bao gồm các 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 môi trường 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 đoán hoặc suy luận chức năng của thiết bị thực tế mà nó được chỉ định. Không có gì đảm bảo rằng một loại thiết bị sẽ vẫn ổn định cho một thiết bị cụ thể khi có thêm nhiều 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à một cấu trúc hoặc phòng. Tên hiển thị tương ứng với trường customName củaĐặc điểm 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ó cấu trúc mẹ.

Lệnh

Lệnh là những 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 cho một lệnh đều chỉ là thành công hoặc không thành công. 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à do Google Cloud Pub/Sub quản lý trong một chủ đề duy nhất cho mỗi Project ID.

Theo mặc định, các sự kiện được gửi cho mọi thay đổi về giá trị của một trường đặc điểm. Các thông báo 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 những thay đổi về việc chỉ định tài nguyên. Hãy xem phần 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 để cung cấp 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 kết nối.
Fan
sdm.devices.traits.Fan
Đặc điểm này thuộc về mọi thiết bị có khả năng điều khiển quạt.
Độ ẩ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ị để cung cấp thông tin liên quan đến thiết bị.
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ế độ TIẾT KIỆM NĂNG LƯỢNG.
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ề hệ thống sưởi ấm, thông gió và điều hoà không khí (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ế độ của 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 (MÁY ĐIỀU NHIỆT) 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ợ tải bản xem trước của đoạn video 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ợ 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 có liên quan.