Lược đồ đặc điểm StatusReport cho nhà thông minh

action.devices.traits.StatusReport – Đặc điểm 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ị được 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 chính thiết bị đó cũng như trạng thái của mọi thiết bị 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 với các thiết bị liên quan đại diện cho từng cảm biến. StatusReport đóng vai trò là một tính năng tổng hợp để báo cáo trạng thái chung, nhưng không thay thế tính năng giải quyết riêng lẻ. Mọi thiết bị 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.

THUỘC TÍNH thiết bị

Không có.

TRẠNG THÁI thiết bị

Các thực thể có đặc điểm này có thể báo cáo các trạng thái sau đây trong thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem bài viết 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 hoặc ngoại lệ hiện tại của thiết bị và mọi mã thiết bị 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 việc thực thi các 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ới mức độ ưu tiên cao nhất là 0. Google báo cáo trạng thái lỗi hoặc ngoại lệ từ mức độ ưu tiên 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. Giá trị tối thiểu: 0.
statusCode	String	Trạng thái hiện tại của thiết bị. Xem danh sách đầy đủ các lỗi và ngoại lệ.

Ví dụ

Hệ thống an ninh của tôi có ổn 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 thiết bị

Không có.

LỖI thiết bị

Xem danh sách đầy đủ các lỗi và ngoại lệ.