Skema Trait Beralih Smart Home
action.devices.traits.Toggles
- Trait ini milik perangkat apa pun dengan setelan yang hanya dapat ada di salah satu dari dua status.
Setelan ini dapat merepresentasikan tombol fisik dengan status aktif/nonaktif atau aktif/tidak aktif, kotak centang di HTML, atau jenis elemen lainnya yang diaktifkan/dinonaktifkan secara khusus. Jika setelan memiliki lebih dari dua status, atau memiliki status saat tidak satu pun opsi biner dipilih, setelan tersebut lebih baik direpresentasikan sebagai ciri Modes, yang setara dengan dial multi-status, tombol pilihan (fisik atau HTML), atau status biner yang tidak aktif/nonaktif secara eksplisit (misalnya, "AM/FM" atau "panas/cold").
Ciri ini mencakup satu atau beberapa tombol alih individual yang dapat ditetapkan oleh pengguna. Secara
umum, tombol beralih ini harus digunakan untuk fungsi yang dibatalkan tautannya
dari perilaku perangkat lainnya. Perilaku tertaut, seperti mengaktifkan atau menonaktifkan
perangkat, harus menggunakan karakteristik yang lebih spesifik (misalnya, thermostatMode
dalam trait TemperatureSetting).
ATTRIBUTE Perangkat
Perangkat dengan ciri ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC
. Untuk mempelajari
penanganan intent SYNC
lebih lanjut, lihat
Fulfillment intent.
Atribut | Type | Deskripsi |
---|---|---|
availableToggles |
Array |
Wajib. Daftar tombol yang tersedia. |
[item, ...] |
Objek |
Tombol tersedia. |
name |
String |
Wajib. Nama internal tombol, yang akan digunakan dalam perintah dan status. Bagian ini mungkin tidak mudah digunakan, dan akan dibagikan dalam semua bahasa. |
name_values |
Array |
Wajib. Sinonim tombol di setiap bahasa yang didukung. |
[item, ...] |
Objek |
Sinonim tombol dalam bahasa tertentu. |
name_synonym |
Array |
Wajib. Sinonim tombol beralih. String pertama dalam daftar ini digunakan sebagai nama kanonis level dalam bahasa tersebut. |
[item, ...] |
String |
Nama sinonim. |
lang |
String |
Wajib. Kode bahasa (ISO 639-1). Lihat bahasa yang didukung. |
commandOnlyToggles |
Boolean |
(Default: Menunjukkan apakah perangkat mendukung penggunaan komunikasi satu arah (benar) atau dua arah (salah). Setel atribut ini ke benar (true) jika perangkat tidak dapat merespons intent QUERY atau Status Laporan untuk karakteristik ini. |
queryOnlyToggles |
Boolean |
(Default: Diperlukan jika perangkat mendukung eksekusi khusus kueri. Atribut ini menunjukkan jika perangkat hanya dapat dikueri untuk informasi status, dan tidak dapat dikontrol. |
Contoh
Perangkat dengan beberapa tombol.
{ "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" } ] } ] }
Perangkat dengan tombol beralih khusus perintah.
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "commandOnlyToggles": true }
Perangkat dengan tombol khusus kueri.
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "queryOnlyToggles": true }
STATUS Perangkat
Entitas dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY
. Untuk mempelajari
penanganan intent QUERY
lebih lanjut, lihat
Fulfillment intent.
Status | Type | Deskripsi |
---|---|---|
currentToggleSettings |
Objek |
Wajib. Pasangan kunci/nilai dengan tombol |
<string> |
Boolean |
Status tombol saat ini. |
Contoh
Apakah sterilisasi aktif?
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
Perangkat COMMAND
Perangkat dengan karakteristik ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE
. Untuk mempelajari
penanganan intent EXECUTE
lebih lanjut, lihat
Fulfillment intent.
action.devices.commands.SetToggles
Menetapkan status tombol tertentu.
Parameter
Parameter | Type | Deskripsi |
---|---|---|
updateToggleSettings |
Objek |
Wajib. Pasangan kunci/nilai dengan tombol |
<string> |
Boolean |
Status tombol baru |
Contoh
Aktifkan hemat energi.
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "energysaving_toggle": true } } }
Nonaktifkan filter.
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "filter_toggle": false } } }
Contoh ucapan
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