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 |
supportsFillPercent |
Boolean |
(Mặc định: 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 |
currentFillPercent |
Number |
Bắt buộc nếu bạn đặt thuộc tính |
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 |
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 ordered
là true
).
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "full_level" } }