Đặc điểm

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

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

Trường

Trường là các giá trị có kiểu dữ liệu phổ biến, chẳng hạn như số hoặc một 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 máy 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 nên sử dụng sdm.devices.types.device-type do API SDM trả về để suy ra hoặc suy ra chức năng của thiết bị thực tế được chỉ định. Không có gì đảm bảo rằng loại thiết bị sẽ duy trì trạng thái ổn định cho một thiết bị cụ thể khi chúng tôi thêm nhiều tính năng hơn vào SDM API. 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, một nhà hoặc một căn phòng. Tên hiển thị tương ứng với trường customName của Thông tin đối với các thiết bị có cấu trúc mẹ hoặc Tính năng RoomInfo dành cho thiết bị có cha mẹ.

Lệnh

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

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 phản hồi cho một lệnh đều đơn giản là thành công hoặc thất bại. Hãy xem các hướng dẫn về đặc điểm riêng cho 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ý theo một chủ đề duy nhất 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. Chúng cũng có thể được gửi trong phản hồi các thao tác cụ thể trên thiết bị hoặc các thay đổi trong việc gán tài nguyên. 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 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 mọi phòng dành cho thông tin liên quan đến phòng.

Thiết bị

Đặc điểm
Kết nối	sdm.devices.traits.Connectivity Đặc điểm này thuộc về bất kỳ thiết bị nào 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ề bất kỳ thiết bị nào có hệ thống điều khiển quạt.
Độ ẩm	sdm.devices.traits.Humidity Đặc điểm này thuộc về bất kỳ thiết bị nào có cảm biến để đo độ ẩm.
Thông tin	sdm.devices.traits.Info Trait này thuộc về bất kỳ thiết bị nào có thông tin liên quan đến thiết bị.
Cài đặt	sdm.devices.traits.Settings Trait này thuộc về bất kỳ thiết bị nào có thông tin cài đặt liên quan đến thiết bị.
Nhiệt độ	sdm.devices.traits.Temperature Đặc điểm này thuộc về bất kỳ thiết bị nào 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ị của MÁY ĐIỀU NHIỆT có hỗ trợ các chế độ ECO.
ThermostatHvac	sdm.devices.traits.ThermostatHvac Đặc điểm này thuộc về các loại thiết bị của NHỮNG ĐIỀU NHIỆT có thể báo cáo thông tin chi tiết về hệ thống sưởi, thông gió và điều hoà.
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 các loại thiết bị của NHIỆT ĐIỀU NHIỆT hỗ trợ đặ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ề bất kỳ thiết bị nào hỗ trợ 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ề bất kỳ thiết bị nào hỗ trợ tính năng tạo hình ảnh từ sự kiện.
CameraImage	sdm.devices.traits.CameraImage Đặc điểm này thuộc về bất kỳ thiết bị nào có hỗ trợ tính năng 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ề bất kỳ thiết bị nào 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 có 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ề bất kỳ thiết bị nào hỗ trợ chuông cửa và các sự kiện nhấn có liên quan.