Giản đồ điền dữ liệu về nhà thông minh

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

ATTRIBUTE của thiết bị

Những thiết bị có đặc điểm này có thể báo cáo những điều sau trong thao tác SYNC. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem 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 từng 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 String

Bắt buộc.

Tên nội bộ của cấp. Thông tin này có thể không thân thiện với người dùng và sẽ được dùng chung 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 của cấp độ trong một ngôn ngữ đã cho.

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 chuẩn của cấp độ trong ngôn ngữ đó.

[item, ...] String

Tên đồ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 là true, hãy chấp nhận các lệnh để điều chỉnh mức độ thành một tỷ lệ phần trăm.

Ví dụ

Thiết bị có chức năng đổ đầy hoặc rút nước 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
  }
}

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ả
isFilled Boolean

Bắt buộc.

Đúng nếu thiết bị được làm đầy đến mức bất kỳ. 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 mà tại đó thiết bị được lấp đầy.

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? (có cấp độ).

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

lệnh của thiết bị

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

action.devices.commands.Fill

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

Thông số

Thông số Loại Mô tả
fill Boolean

Bắt buộc.

"True" để đổ đầy, "false" để rút nước.

fillLevel String

Cho biết level_name qua thuộc tính availableFillLevels cần đặt. Nếu chưa chỉ định, hãy điền đến mức 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
  }
}

Xả 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 của 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"
  }
}

Thiết bị ERRORS

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