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

action.devices.traits.Fill – Đặc điểm này áp dụng cho các thiết bị hỗ trợ việc đổ đầy nước như bồn tắm.

ATTRIBUTES thiết bị

Các thiết bị có đặc điểm này có thể báo cáo các thuộc tính sau đây trong quá trình thực hiện SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem phần Thực hiện ý định.

Thuộc tính	Loại	Nội dung mô tả
availableFillLevels	Đối tượng	Mô tả các mức độ lấp đầy của thiết bị.
levels	Mảng	Bắt buộc. Danh sách tên cấp và từ đồng nghĩa theo ngôn ngữ cụ thể.
[item, ...]	Đối tượng	Tên cấp độ và các từ đồng nghĩa theo từng ngôn ngữ.
level_name	Chuỗi	Bắt buộc. Tên nội bộ của cấp độ. Tính năng này có thể không thân thiện với người dùng và sẽ được chia sẻ trên tất cả ngôn ngữ.
level_values	Mảng	Bắt buộc. Từ đồng nghĩa của cấp độ trong mỗi ngôn ngữ được hỗ trợ.
[item, ...]	Đối tượng	Các từ đồng nghĩa của cấp độ bằng ngôn ngữ đã cho.
level_synonym	Mảng	Bắt buộc. Từ đồng nghĩa của cấp. Chuỗi đầu tiên trong danh sách này được dùng làm tên chuẩn của cấp bằng ngôn ngữ đó.
[item, ...]	Chuỗi	Tên từ đồng nghĩa.
lang	Chuỗi	Bắt buộc. Mã ngôn ngữ (ISO 639-1). Xem các ngôn ngữ được hỗ trợ.
ordered	Boolean	Bắt buộc. Nếu đúng, thiết bị sẽ xử lý thêm ngữ pháp để tăng hoặc giảm logic, như được biểu thị bằng mảng levels (ví dụ: nửa cấp).
supportsFillPercent	Boolean	(Mặc định: false) Nếu đúng, hãy chấp nhận các lệnh để điều chỉnh cấp độ thành một tỷ lệ phần trăm.

Ví dụ

Thiết bị có những tính năng làm đầy hoặc thoát cơ bản không hỗ trợ các mức lấp đầy riêng biệt.

{}

Thiết bị hỗ trợ các mức lấp đầy riêng biệt.

{
  "availableFillLevels": {
    "levels": [
      {
        "level_name": "half_level",
        "level_values": [
          {
            "level_synonym": [
              "Half",
              "Half way",
              "One half"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "level_name": "full_level",
        "level_values": [
          {
            "level_synonym": [
              "Full",
              "All the way",
              "Complete"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  }
}

Thiết bị STATES

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 toán tử QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem phần Thực hiện ý định.

Tiểu bang	Loại	Nội dung mô tả
isFilled	Boolean	Bắt buộc. Đúng nếu thiết bị được đổ đầy ở mức bất kỳ. Sai nếu thiết bị đã hết pin.
currentFillLevel	Chuỗi	Bắt buộc nếu bạn đặt thuộc tính availableFillLevels. Cho biết level_name hiện tại qua thuộc tính availableFillLevels dùng để điền thiết bị.
currentFillPercent	Number	Bắt buộc nếu bạn đặt thuộc tính supportsFillPercent. Cho biết tỷ lệ phần trăm mức lấp đầy hiện tại.

Ví dụ

Bồn tắm có đầy không?

{
  "isFilled": true
}

Bồn tắm có đầy không? (có cấp độ).

{
  "isFilled": true,
  "currentFillLevel": "half_level"
}

Thiết bị COMMANDS

Các thiết bị có đặc điểm này có thể phản hồi các lệnh sau đây trong thao tác EXECUTE. Để tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem phần Thực hiện ý định.

action.devices.commands.Fill

Đổ đầy hoặc tiêu hao thiết bị.

Thông số

Thông số	Loại	Nội dung mô tả
fill	Boolean	Bắt buộc. True để điền, false để điền.
fillLevel	Chuỗi	Cho biết level_name trong thuộc tính availableFillLevels cần đặt. Nếu không xác định, hãy điền vào cấp mặc định.
fillPercent	Number	Cho biết tỷ lệ phần trăm cấp đã yêu cầu.

Ví dụ

Đổ nước vào bồn tắm.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true
  }
}

Xả nước khỏi bồn tắm.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": false
  }
}

Đổ nước vào bồn tắm một nửa.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "half_level"
  }
}

Tăng mức lấp đầy bồn tắm thêm một (yêu cầu thuộc tính ordered là true).

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "full_level"
  }
}

Thiết bị ERRORS

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