Giản đồ về đặc điểm chế độ nhà thông minh
action.devices.traits.Modes
– Trait này bao gồm tất cả các chế độ có sẵn và các chế độ cài đặt dành riêng cho từng chế độ của một thiết bị.
Đặc điểm này thuộc về những thiết bị có số "n-chiều" tuỳ ý chế độ mà trong đó các chế độ và chế độ cài đặt cho mỗi chế độ là tuỳ ý và riêng biệt cho từng thiết bị hoặc loại thiết bị. Mỗi chế độ có thể có nhiều chế độ cài đặt, nhưng mỗi lần bạn chỉ có thể chọn một chế độ; máy sấy không thể hãy "một cách tinh tế" "bình thường", và "nhiệm vụ nặng nề" chế độ đồng thời. Một chế độ cài đặt chỉ đơn giản có thể bật hoặc tắt thuộc về đặc điểm Toggles.
Ví dụ: Máy giặt có thể có các chế độ cài đặt cho khối lượng giặt và nhiệt độ. Cả hai đều là chế độ vì chúng độc lập với nhau, nhưng mỗi chế độ chỉ có thể ở một trạng thái mỗi lần. Người dùng có thể đặt một chế độ như nhiệt độ rõ ràng bằng một lệnh như Đặt nhiệt độ của máy giặt ở lạnh.
Một số chế độ được "theo thứ tự" và cũng có thể điều chỉnh bằng cử chỉ lên/xuống tăng/giảm độ dài lời nói. Ví dụ: kích thước tải (nhỏ, trung bình, lớn) và nhiệt độ được sắp xếp rõ ràng (lưu ý rằng nhiệt độ không phải là giá trị thực máy điều nhiệt có đích dạng số, như trên các thiết bị khác), nhưng loại tải (món ngon, loại bình thường, len, v.v.) có thể không được.
Đặc điểm này bao gồm một hoặc nhiều chế độ riêng lẻ mà người dùng có thể đặt. Nhìn chung,
các chế độ này nên được dùng cho chức năng đã huỷ liên kết khỏi thiết bị khác
hành vi. Hành vi được liên kết, chẳng hạn như tự bật hoặc tắt thiết bị, phải
sử dụng đặc điểm cụ thể hơn (ví dụ: thermostatMode
trong
trait TemperatureSetting).
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ả |
---|---|---|
availableModes |
Mảng |
Bắt buộc. Danh sách các chế độ hiện có. |
[item, ...] |
Đối tượng |
Chế độ có sẵn. |
name |
String |
Bắt buộc. Tên nội bộ của chế độ, sẽ được dùng trong các lệnh và trạng thái. 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ữ. |
name_values |
Mảng |
Bắt buộc. Từ đồng nghĩa của chế độ này trong mỗi ngôn ngữ được hỗ trợ. |
[item, ...] |
Đối tượng |
Từ đồng nghĩa của chế độ này bằng một ngôn ngữ đã cho. |
name_synonym |
Mảng |
Bắt buộc. Từ đồng nghĩa của chế độ này. 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ợ. |
settings |
Mảng |
Bắt buộc. Các chế độ cài đặt được hỗ trợ cho chế độ này. |
[item, ...] |
Đối tượng |
Chế độ cài đặt được hỗ trợ. Cần có ít nhất 2 mục. |
setting_name |
String |
Bắt buộc. Tên nội bộ của chế độ cài đặt, sẽ được dùng trong các lệnh và trạng thái. 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ữ. |
setting_values |
Mảng |
Bắt buộc. Từ đồng nghĩa của chế độ cài đặt này trong mỗi ngôn ngữ được hỗ trợ. |
[item, ...] |
Đối tượng |
Từ đồng nghĩa của chế độ cài đặt bằng ngôn ngữ đã cho. |
setting_synonym |
Mảng |
Bắt buộc. Từ đồng nghĩa của chế độ cài đặt này. 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 |
(Mặc định: Nếu bạn đặt giá trị này thành true, thì ngữ pháp bổ sung cho logic tăng/giảm sẽ được áp dụng theo thứ tự (tăng) của mảng cài đặt. |
commandOnlyModes |
Boolean |
(Mặc định: Cho biết thiết bị có hỗ trợ giao tiếp một chiều (true) hay hai chiều (false). Đặt thuộc tính này thành true nếu thiết bị không thể phản hồi ý định QUERY hoặc Trạng thái báo cáo đối với đặc điểm này. |
queryOnlyModes |
Boolean |
(Mặc định: Bắt buộc nếu thiết bị hỗ trợ thực thi chỉ truy vấn. Thuộc tính này cho biết liệu thiết bị chỉ có thể truy vấn về thông tin trạng thái chứ không thể kiểm soát được. |
Ví dụ
Thiết bị có nhiều chế độ và chế độ cài đặt.
{ "availableModes": [ { "name": "load_mode", "name_values": [ { "name_synonym": [ "Load", "Size", "Load size" ], "lang": "en" } ], "settings": [ { "setting_name": "small_load", "setting_values": [ { "setting_synonym": [ "Small", "Half" ], "lang": "en" } ] }, { "setting_name": "medium_load", "setting_values": [ { "setting_synonym": [ "Medium", "Normal" ], "lang": "en" } ] }, { "setting_name": "large_load", "setting_values": [ { "setting_synonym": [ "Large", "Full" ], "lang": "en" } ] } ], "ordered": true }, { "name": "temp_mode", "name_values": [ { "name_synonym": [ "Temperature", "Temp" ], "lang": "en" } ], "settings": [ { "setting_name": "hot_temp", "setting_values": [ { "setting_synonym": [ "Hot", "White" ], "lang": "en" } ] }, { "setting_name": "warm_temp", "setting_values": [ { "setting_synonym": [ "Warm", "Color" ], "lang": "en" } ] }, { "setting_name": "cold_temp", "setting_values": [ { "setting_synonym": [ "Cold", "Delicate" ], "lang": "en" } ] } ], "ordered": false } ] }
Thiết bị chỉ có chế độ dùng lệnh.
{ "availableModes": [ { "name": "light_mode", "name_values": [ { "name_synonym": [ "Light", "Lighting" ], "lang": "en" } ], "settings": [ { "setting_name": "day_light", "setting_values": [ { "setting_synonym": [ "Day", "Bright" ], "lang": "en" } ] }, { "setting_name": "night_light", "setting_values": [ { "setting_synonym": [ "Night", "Dark" ], "lang": "en" } ] }, { "setting_name": "reading_light", "setting_values": [ { "setting_synonym": [ "Reading", "Ambiant" ], "lang": "en" } ] } ], "ordered": false } ], "commandOnlyModes": true, "queryOnlyModes": false }
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ả |
---|---|---|
currentModeSettings |
Đối tượng |
Bắt buộc. Khoá/giá trị ghép nối với chế độ |
<string> |
String |
Hiện tại |
Ví dụ
Thiết bị đang ở chế độ nào?
{ "currentModeSettings": { "load_mode": "small_load", "temp_mode": "cold_temp" } }
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.SetModes
Cập nhật phần cài đặt chế độ.
Tham số
Tham số | Loại | Mô tả |
---|---|---|
updateModeSettings |
Đối tượng |
Bắt buộc. Khoá/giá trị ghép nối với chế độ |
<string> |
String |
|
Ví dụ
Đặt thành tải lớn.
{ "command": "action.devices.commands.SetModes", "params": { "updateModeSettings": { "load_mode": "large_load" } } }
Cách phát âm mẫu
de-DE
- Stelle den Staubsauger auf Ruhemodus
en-US
- set the vacuum to energy saver mode
es-ES
- pon la lavadora en modo frío
fr-FR
- mets l'aspirateur en silencieux
hi-IN
- वैक्यूम पर कार्पेट मोड लगाएं
it-IT
- imposta l'aspirapolvere su silenzioso
ja-JP
- 掃除機 を 静音 モードに設定して
ko-KR
- 세탁기 세탁량 많음 으로 설정해
pt-BR
- acionar a função autolimpeza do aspirador
- ligar o modo de aquecimento