Giản đồ Trait điền sẵn cho nhà thông minh

action.devices.traits.Fill – Đặc điểm này áp dụng cho các thiết bị hỗ trợ lấp đầy giá trị, chẳng hạn như bồn tắm.

THUỘC TÍNH của 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 SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, vui lòng 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 cấp độ đổ đầy 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 ngôn ngữ cụ thể.
level_name	Chuỗi	Bắt buộc. Tên nội bộ của cấp. Nội dung này có thể không thân thiện với người dùng và sẽ được chia sẻ cho tất cả cá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	Từ đồng nghĩa về cấp độ trong một ngôn ngữ cụ thể.
level_synonym	Mảng	Bắt buộc. Từ đồng nghĩa với cấp độ. Chuỗi đầu tiên trong danh sách này được dùng làm tên chính tắc của cấp độ ở 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ý ngữ pháp bổ sung để 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 mức thành phần trăm.

Ví dụ

Thiết bị có tính năng lấp đầy hoặc rút cạn cơ bản không hỗ trợ 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
  }
}

TRẠNG THÁI của 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 trong thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, vui lòng 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 lấp đầy đến mức bất kỳ. Sai nếu thiết bị đã cạn hoàn toàn.
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 từ thuộc tính availableFillLevels mà tại đó thiết bị được điền vào.
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 đã đầy chưa?

{
  "isFilled": true
}

Bồn tắm đã đầy chưa? (kèm theo nhiều cấp độ).

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

Lệnh trên thiết bị

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

action.devices.commands.Fill

Đổ đầy hoặc tháo cạn thiết bị.

Thông số

Thông số	Loại	Nội dung mô tả
fill	Boolean	Bắt buộc. True để lấp đầy, false để loại bỏ.
fillLevel	Chuỗi	Cho biết level_name từ thuộc tính availableFillLevels cần đặt. Nếu không chỉ định, hãy điền đến cấp mặc định.
fillPercent	Number	Cho biết tỷ lệ phần trăm của cấp được yêu cầu.

Ví dụ

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

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

Rút cạn bồn tắm.

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

Đổ đầy 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 lên một mức (yêu cầu thuộc tính ordered phải là true).

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

Thiết bị ERRORS

Xem danh sách đầy đủ lỗi và trường hợp ngoại lệ.