Một trait trong API SDM 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 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:
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.
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.