Giản đồ về đặc điểm báo cáo trạng thái của nhà thông minh

action.devices.traits.StatusReport – Trait này báo cáo trạng thái hiện tại của một thiết bị cụ thể hoặc một nhóm thiết bị đã kết nối.

Một thiết bị cụ thể có thể báo cáo trạng thái hiện tại của thiết bị cũng như trạng thái của thiết bị có liên quan trong một nhóm. Ví dụ: thiết bị mục tiêu có thể là một hệ thống an ninh có các thiết bị có liên quan biểu thị các cảm biến riêng lẻ. StatusReport đóng vai trò là số liệu tổng hợp cho báo cáo tình trạng tập thể, nhưng không thay thế địa chỉ của từng cá nhân. Bất kỳ thiết bị nào mà Trợ lý Google có thể truy cập đều phải được báo cáo dưới dạng một thiết bị riêng biệt trong phản hồi SYNC.

ATTRIBUTE của thiết bị

Không có.

Thiết bị STATES

Đối tượng có đặc điểm này có thể báo cáo những nội dung sau các trạng thái trong thao tác QUERY. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem Thực hiện ý định.

Tiểu bang Loại Mô tả
currentStatusReport Mảng

Bắt buộc.

Trạng thái lỗi hiện tại hoặc trạng thái ngoại lệ của thiết bị và mọi mã thiết bị có liên quan.

[item, ...] Đối tượng

Trạng thái hiện tại.

blocking Boolean

Đúng nếu lỗi hoặc trạng thái hiện tại đang chặn các quá trình thực thi lệnh khác.

deviceTarget String

Mã của thiết bị mục tiêu.

priority Số nguyên

Chỉ định mức độ ưu tiên của trạng thái này. Giá trị càng thấp thì mức độ ưu tiên càng cao và mức độ ưu tiên cao nhất là 0. Google báo cáo lỗi hoặc trạng thái ngoại lệ theo mức độ ưu tiên từ cao nhất đến thấp nhất. Tuỳ thuộc vào nền tảng, Google có thể chỉ báo cáo các lỗi hoặc ngoại lệ có mức độ ưu tiên cao.

statusCode String

Trạng thái hiện tại của thiết bị. Xem danh sách đầy đủ lỗi và ngoại lệ.

Ví dụ

Hệ thống an ninh của tôi có hoạt động không?

{
  "currentStatusReport": [
    {
      "blocking": false,
      "deviceTarget": "alarm_1",
      "priority": 0,
      "statusCode": "lowBattery"
    },
    {
      "blocking": false,
      "deviceTarget": "front_window_1",
      "priority": 1,
      "statusCode": "deviceOpen"
    },
    {
      "blocking": false,
      "deviceTarget": "back_window_2",
      "priority": 1,
      "statusCode": "deviceOpen"
    },
    {
      "blocking": true,
      "deviceTarget": "alarm_2",
      "priority": 0,
      "statusCode": "needsSoftwareUpdate"
    }
  ]
}

lệnh của thiết bị

Không có.

Thiết bị ERRORS

Xem toàn bộ danh sách lỗi và ngoại lệ.