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 |
supportsFillPercent |
Boolean |
(Mặc định: 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 |
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? (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 |
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" } }