Skema Fitur Mode Smart Home
action.devices.traits.Modes
- Fitur ini mencakup semua mode yang tersedia dan setelan khusus mode untuk perangkat.
Fitur ini termasuk dalam perangkat apa pun dengan sejumlah mode "n-arah" yang arbitrer di mana mode dan setelan untuk setiap mode bersifat arbitrer dan unik untuk setiap perangkat atau jenis perangkat. Setiap mode memiliki beberapa kemungkinan setelan, tetapi hanya satu yang dapat dipilih dalam satu waktu; pengering tidak dapat berada dalam mode "delicate", "normal", dan "heavy duty" secara bersamaan. Setelan yang dapat diaktifkan atau dinonaktifkan saja termasuk dalam trait Toggles.
Misalnya, mesin cuci dapat memiliki setelan untuk ukuran muatan dan suhu. Keduanya akan menjadi mode karena tidak bergantung satu sama lain, tetapi masing-masing hanya dapat berada dalam satu status dalam satu waktu. Pengguna dapat menyetel mode seperti suhu secara eksplisit dengan perintah seperti Setel suhu mesin cuci ke dingin.
Beberapa mode "diurutkan" dan juga dapat disesuaikan dengan kata-kata naik/turun, tambah/kurang. Misalnya, ukuran muatan (kecil, sedang, besar) dan suhu jelas diurutkan (perhatikan bahwa suhu bukanlah termostat dengan target numerik, seperti pada perangkat lain), tetapi jenis muatan (pakaian halus, normal, wol, dll.) mungkin tidak.
Ciri ini mencakup satu atau beberapa mode individual yang dapat ditetapkan pengguna. Secara umum,
mode ini harus digunakan untuk fungsi yang tidak terkait dengan perilaku perangkat lain. Perilaku yang ditautkan, seperti mengaktifkan atau menonaktifkan perangkat itu sendiri, harus menggunakan sifat yang lebih spesifik (misalnya, thermostatMode
di TemperatureSetting sifat).
ATRIBUT Perangkat
Perangkat dengan karakteristik ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC
. Untuk mempelajari lebih lanjut cara menangani intent SYNC
, lihat Fulfillment intent.
Atribut | Jenis | Deskripsi |
---|---|---|
availableModes |
Array |
Wajib. Daftar mode yang tersedia. |
[item, ...] |
Objek |
Mode yang tersedia. |
name |
String |
Wajib. Nama internal mode, yang akan digunakan dalam perintah dan status. Hal ini dapat membuat pengalaman pengguna menjadi tidak ramah, dan akan dibagikan dalam semua bahasa. |
name_values |
Array |
Wajib. Sinonim mode dalam setiap bahasa yang didukung. |
[item, ...] |
Objek |
Sinonim mode dalam bahasa tertentu. Setidaknya satu item dengan nilai |
name_synonym |
Array |
Wajib. Sinonim mode. String pertama dalam daftar ini digunakan sebagai nama kanonis level dalam bahasa tersebut. |
[item, ...] |
String |
Nama sinonim. Setidaknya satu item dengan nilai |
lang |
String |
Wajib. Kode bahasa (ISO 639-1). Lihat bahasa yang didukung. |
settings |
Array |
Wajib. Setelan yang didukung untuk mode ini. |
[item, ...] |
Objek |
Setelan yang didukung. Memerlukan minimal 2 item. |
setting_name |
String |
Wajib. Nama internal setelan mode, yang akan digunakan dalam perintah dan status. Hal ini dapat membuat pengalaman pengguna menjadi tidak ramah, dan akan dibagikan dalam semua bahasa. |
setting_values |
Array |
Wajib. Sinonim setelan dalam setiap bahasa yang didukung. |
[item, ...] |
Objek |
Sinonim setelan dalam bahasa tertentu. |
setting_synonym |
Array |
Wajib. Sinonim setelan. 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. |
ordered |
Boolean |
(Default: Jika disetel ke benar (true), tata bahasa tambahan untuk logika peningkatan/penurunan akan berlaku, dalam urutan (meningkat) array setelan. |
commandOnlyModes |
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 Report State untuk karakteristik ini. |
queryOnlyModes |
Boolean |
(Default: Wajib diisi jika perangkat mendukung eksekusi hanya kueri. Atribut ini menunjukkan apakah perangkat hanya dapat dikueri untuk informasi status, dan tidak dapat dikontrol. |
Contoh
Perangkat dengan beberapa mode dan setelan.
{ "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 } ] }
Perangkat dengan mode khusus perintah.
{ "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 }
STATUS Perangkat
Entitas dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY
. Untuk mempelajari lebih lanjut cara menangani intent QUERY
, lihat Fulfillment intent.
Negara bagian | Jenis | Deskripsi |
---|---|---|
currentModeSettings |
Objek |
Wajib. Key-value pair dengan mode |
<string> |
String |
Saat ini |
Contoh
Dalam mode apa perangkat berada?
{ "currentModeSettings": { "load_mode": "small_load", "temp_mode": "cold_temp" } }
PERINTAH perangkat
Perangkat dengan karakteristik ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE
. Untuk mempelajari lebih lanjut cara menangani intent EXECUTE
, lihat Fulfillment intent.
action.devices.commands.SetModes
Perbarui setelan mode.
Parameter
Parameter | Jenis | Deskripsi |
---|---|---|
updateModeSettings |
Objek |
Wajib. Key-value pair dengan mode |
<string> |
String |
Baru |
Contoh
Setel ke muatan besar.
{ "command": "action.devices.commands.SetModes", "params": { "updateModeSettings": { "load_mode": "large_load" } } }
Contoh ucapan
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