Nhà thông minh bật/tắt giản đồ đặc điểm
action.devices.traits.Toggles
– Trait này thuộc về bất kỳ thiết bị nào có chế độ cài đặt chỉ có thể tồn tại ở một trong hai trạng thái.
Các chế độ cài đặt này có thể biểu thị một nút thực có trạng thái bật/tắt hoặc đang hoạt động/không hoạt động, hộp đánh dấu trong HTML hoặc bất kỳ loại phần tử được bật/tắt cụ thể nào khác. Nếu chế độ cài đặt có nhiều hơn hai trạng thái hoặc có một trạng thái mà không có lựa chọn nhị phân nào được chọn, thì chế độ cài đặt đó sẽ được biểu thị tốt hơn dưới dạng đặc điểm Modes tương đương với quay số đa trạng thái, nút chọn (vật lý hoặc HTML) hoặc trạng thái nhị phân không bật/tắt rõ ràng (ví dụ: "AM/FM" hoặc "nóng/lạnh").
Trait này bao gồm một hoặc nhiều nút bật/tắt riêng lẻ mà người dùng có thể đặt. Nhìn chung, bạn nên sử dụng các nút bật/tắt này cho chức năng bị huỷ liên kết khỏi hành vi khác của thiết bị. 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).
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ả |
---|---|---|
availableToggles |
Mảng |
Bắt buộc. Danh sách nút bật/tắt hiện có. |
[item, ...] |
Đối tượng |
Nút bật/tắt có sẵn. |
name |
Chuỗi |
Bắt buộc. Tên nội bộ của nút bật/tắt, sẽ được dùng trong các lệnh và trạng thái. 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ữ. |
name_values |
Mảng |
Bắt buộc. Từ đồng nghĩa của nút bật/tắt trong mỗi ngôn ngữ được hỗ trợ. |
[item, ...] |
Đối tượng |
Từ đồng nghĩa của nút bật/tắt trong một ngôn ngữ cụ thể. |
name_synonym |
Mảng |
Bắt buộc. Từ đồng nghĩa của nút bật/tắt. 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ợ. |
commandOnlyToggles |
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 cho trait này. |
queryOnlyToggles |
Boolean |
(Mặc định: Đây là trường 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 được thông tin trạng thái hay không và không thể kiểm soát thiết bị. |
Ví dụ
Thiết bị có nhiều nút bật/tắt.
{ "availableToggles": [ { "name": "sterilization_toggle", "name_values": [ { "name_synonym": [ "Clean", "Bio clean" ], "lang": "en" } ] }, { "name": "energysaving_toggle", "name_values": [ { "name_synonym": [ "Energy saving", "Eco" ], "lang": "en" } ] } ] }
Thiết bị có nút bật/tắt ở chế độ chỉ dùng lệnh.
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "commandOnlyToggles": true }
Thiết bị có nút bật/tắt chỉ truy vấn.
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "queryOnlyToggles": 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ả |
---|---|---|
currentToggleSettings |
Đối tượng |
Bắt buộc. Cặp khoá/giá trị với nút bật/tắt |
<string> |
Boolean |
Trạng thái bật/tắt hiện tại. |
Ví dụ
Tính năng khử trùng có đang bật không?
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
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.SetToggles
Đặt một trạng thái bật/tắt nhất định.
Thông số
Thông số | Loại | Nội dung mô tả |
---|---|---|
updateToggleSettings |
Đối tượng |
Bắt buộc. Cặp khoá/giá trị với nút bật/tắt |
<string> |
Boolean |
Trạng thái bật/tắt mới |
Ví dụ
Bật chế độ tiết kiệm năng lượng.
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "energysaving_toggle": true } } }
Tắt bộ lọc.
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "filter_toggle": false } } }
Cách phát âm mẫu
de-DE
- Bitte schalte Power Cool am Kühlschrank aus
- stelle den Kühlschrank auf Power Cool
en-US
- activate power freeze for the freezer
- cancel power cool for the kitchen fridge
es-ES
- pon el enfriamiento rápido en la nevera
- quita el enfriamiento rápido
fr-FR
- mets le mode power cool sur le réfrigérateur
- Éteins le mode power freeze du réfrigérateur .
hi-IN
- रेफ़्रिजरेटर का पावर कूल मोड बंद कर दो
- रेफ़्रिजरेटर में पावर कूल मोड चालू करो
it-IT
- disattiva il power freeze del freezer
- imposta la funzione power freeze del surgelatore
ja-JP
- 冷蔵庫 の 急速冷凍 つけて
- 冷蔵庫 の 急速冷凍 を切ってくれる
ko-KR
- 냉장고 급속 냉장 해제해
- 냉장고 모드 급속 냉장 으로 바꿔
nl-NL
- Zet de power cool uit op de koelkast
- zet de koelkast op superkoelen
pt-BR
- Ativa a função power freeze no congelador .
- Desativa o bloqueio infantil do forno .
- desligar o power cool da geladeira
- iniciar o modo power freeze do freezer
sv-SE
- Stäng av power cool i kylskåpet
- sätt på power freeze på frysen