Giản đồ Trait điền sẵn cho nhà thông minh
action.devices.traits.Fill
– Đặc điểm này áp dụng cho các thiết bị hỗ trợ lấp đầy giá trị, 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 quá trình SYNC
. Để tìm hiểu thêm về cách xử lý ý định SYNC
, vui lòng 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 cấp độ đổ đầ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 |
Chuỗi |
Bắt buộc. Tên nội bộ của cấp. Nội dung này có thể không thân thiện với người dùng và sẽ được chia sẻ 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 về cấp độ trong một ngôn ngữ cụ thể. |
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 chính tắc của cấp độ ở 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ý ngữ pháp bổ sung để 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 mức thành phần trăm. |
Ví dụ
Thiết bị có tính năng lấp đầy hoặc rút cạn 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 } }
TRẠNG THÁI của 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 trong thao tác QUERY
. Để tìm hiểu thêm về cách xử lý ý định QUERY
, vui lòng 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 lấp đầy đến mức bất kỳ. Sai nếu thiết bị đã cạn hoàn toàn. |
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 đã đầy chưa?
{ "isFilled": true }
Bồn tắm đã đầy chưa? (kèm theo nhiều cấp độ).
{ "isFilled": true, "currentFillLevel": "half_level" }
Lệnh trên thiết bị
Các thiết bị có trait này có thể phản hồi các lệnh sau đây trong quá trình thao tác EXECUTE
. Để tìm hiểu thêm về cách xử lý ý định EXECUTE
, vui lòng xem phần Thực hiện ý định.
action.devices.commands.Fill
Đổ đầy hoặc tháo cạn thiết bị.
Thông số
Thông số | Loại | Nội dung mô tả |
---|---|---|
fill |
Boolean |
Bắt buộc. True để lấp đầy, false để loại bỏ. |
fillLevel |
Chuỗi |
Cho biết |
fillPercent |
Number |
Cho biết tỷ lệ phần trăm của 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 } }
Rút cạn bồn tắm.
{ "command": "action.devices.commands.Fill", "params": { "fill": false } }
Đổ đầy 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 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" } }