Chào mừng bạn đến với Trung tâm nhà phát triển Google Home, điểm đến mới để tìm hiểu cách phát triển các hành động nhà thông minh. Lưu ý: Bạn sẽ tiếp tục xây dựng các hành động trong bảng điều khiển Actions.

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 orderedtrue).

{
  "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ệ.