Đặc điểm

Một trait trong API SDM bao gồm các trường, lệnh và sự kiện.

Mọi lệnh gọi đến SDM API phải sử dụng điểm cuối sau:
https://smartdevicemanagement.googleapis.com/v1

Trường

Trường là các giá trị có loại dữ liệu phổ biến, 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 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ị

Không được sử dụng sdm.devices.types.device-type do API SDM trả về để suy luậ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ẽ vẫn ổn định cho một thiết bị cụ thể khi thêm nhiều tính năng vào API SDM. Thay vào đó, hãy sử dụng các trait đượ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ủaInfo đối với các thiết bị có phần tử mẹ là cấu trúc hoặcRoomInfo đối với các thiết bị có phần tử mẹ là phòng.

Lệnh

Lệnh là các yêu cầu 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 Máy điều nhiệt Google Nest.

Lệnh gọi API executeCommand sẽ gửi một lệnh:

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 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à được Google Cloud Pub/Sub quản lý trong một chủ đề duy nhất cho mỗi Project mã nhận dạng.

Theo mặc định, hệ thống sẽ gửi các sự kiện cho mọi thay đổi về giá trị của trường trait. Bạn cũng có thể gửi các thông báo này để phản hồi các thao tác cụ thể trên thiết bị hoặc thay đổi trong 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 bất kỳ cấu trúc nào dành cho thông tin liên quan đến cấu trúc.
RoomInfo	sdm.structures.traits.RoomInfo Đặc điểm này thuộc về bất kỳ phòng nào để 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.
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ị để 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ị để cung cấp 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ề hệ thống điều hòa không khí.
ThermostatMode	sdm.devices.traits.ThermostatMode Đặc điểm này thuộc về các loại thiết bị của MÁY ĐIỀU NHIỆT 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ợ tính năng tải bản xem trước đ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ợ 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ề bất kỳ thiết bị nào có hỗ trợ tính năng phát trực tiếp.
CameraMotion	sdm.devices.traits.CameraMotion Trait này thuộc về bất kỳ thiết bị nào hỗ trợ 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ợ sự kiện phát hiện người.
CameraSound	sdm.devices.traits.CameraSound Trait này thuộc về bất kỳ thiết bị nào hỗ trợ 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.