Lược đồ đặc điểm của tính năng Điền dữ liệu thông minh cho nhà

action.devices.traits.Fill – Đặc điểm này áp dụng cho những thiết bị hỗ trợ việc đổ đầy, 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 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 độ đổ đầ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 String

Bắt buộc.

Tên nội bộ của cấp độ. Điều này có thể gây khó chịu cho người dùng và sẽ được chia sẻ bằng 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. Bạn phải có ít nhất một mặt hàng có giá trị lang là en để cung cấp ngôn ngữ dự phòng.
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, ...] String

Tên từ đồng nghĩa. Bạn phải có ít nhất một mặt hàng có giá trị lang là en để cung cấp ngôn ngữ dự phòng.
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ý thêm ngữ pháp cho logic tăng hoặc giảm, như được biểu thị bằng mảng levels (ví dụ: nửa mức).
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 độ theo tỷ lệ phần trăm.

Ví dụ

Thiết bị có khả năng đổ đầy hoặc xả cơ bản và không hỗ trợ các mức đổ đầy riêng biệt.

{}

Thiết bị hỗ trợ các mức đổ đầ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 hoạt động 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 sạc ở bất kỳ mức nào. Sai nếu thiết bị đã hết pin hoàn toàn.
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 trong thuộc tính availableFillLevels mà thiết bị được sạc đầ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 nước chưa?

{
  "isFilled": true
}

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

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

Lệnh cho 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 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ả nước trong thiết bị.

Thông số

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

Bắt buộc.

True để đổ đầy, false để xả.
fillLevel String

Cho biết level_name từ thuộc tính availableFillLevels cần đặt. Nếu không được chỉ đị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 độ đượ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 khỏi bồn tắm.

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

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

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

Tăng mức nước trong 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"
  }
}

LỖI thiết bị

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