Giản đồ thuộc tính đ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, chẳng hạn như bồn tắm.

Thuộc tính 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 thao tác 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	Mô tả
availableFillLevels	Đối tượng	Mô tả các mức độ làm đầ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ữ.
[item, ...]	Đối tượng	Tên cấp và các từ đồng nghĩa theo ngôn ngữ cụ thể.
level_name	String	Bắt buộc. Tên nội bộ của cấp. Cách 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	Từ đồng nghĩa của cấp độ bằng một ngôn ngữ nhất định.
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 độ trong ngôn ngữ đó.
[item, ...]	String	Tên từ đồng nghĩa.
lang	String	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 tỷ lệ phần trăm.

Ví dụ

Thiết bị có chức năng nạp hoặc xả cơ bản không hỗ trợ các mức nạp 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 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 quá trình thực hiện thao tác 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	Mô tả
isFilled	Boolean	Bắt buộc. Đúng nếu thiết bị được lấp đầy đến bất kỳ cấp nào. Sai nếu thiết bị đã hết pin.
currentFillLevel	String	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 tại thời điểm thiết bị được điền.
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 nước chưa?

{
  "isFilled": true
}

Bồn tắm đã đầy nước chưa? (có cấp).

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

lệnh của thiết bị

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 xả thiết bị.

Thông số

Thông số	Loại	Mô tả
fill	Boolean	Bắt buộc. Đúng để đổ đầy, sai để xả.
fillLevel	String	Cho biết level_name từ thuộc tính availableFillLevels cần đặt. Nếu không chỉ định, hãy lấp đầy đến cấp mặc định.
fillPercent	Number	Cho biết tỷ lệ phần trăm 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
  }
}

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

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

Đổ nước vào bồn tắm đến nửa chừng.

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

Tăng mức nước trong bồn tắm thêm một (yêu cầu thuộc tính ordered phải là true).

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

LỖI thiết bị

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