Skema Karakter Mode Smart Home
action.devices.traits.Modes - Fitur ini mencakup semua mode yang tersedia dan setelan khusus mode untuk perangkat.
Sifat ini dimiliki oleh perangkat apa pun dengan jumlah "n-way" yang arbitrer mode 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 pada satu waktu; pengering tidak bisa dalam "halus", "normal", dan "tugas berat" mode secara bersamaan. Setelan yang hanya dapat diaktifkan atau dinonaktifkan termasuk dalam karakteristik Toggles.
Misalnya, mesin cuci dapat memiliki setelan untuk ukuran dan suhu muatan. Keduanya menjadi mode karena mereka independen satu sama lain, tetapi hanya dapat berada dalam satu keadaan pada satu waktu. Pengguna dapat mengatur mode seperti secara eksplisit dengan perintah seperti Setel suhu mesin cuci ke dingin.
Beberapa moda "diurutkan" dan juga dapat disesuaikan dengan menambah/mengurangi ucapan. Misalnya, ukuran muatan (kecil, menengah, besar) dan suhu diurutkan dengan jelas (perhatikan bahwa suhu bukan termostat dengan target numerik, seperti pada perangkat lainnya), tetapi jenis beban (halus, normal, wol, dsb.) mungkin tidak.
Sifat ini mencakup satu atau beberapa mode individual yang dapat disetel pengguna. Secara umum,
mode ini harus digunakan untuk fungsionalitas yang dibatalkan tautannya dari perangkat lain
perilaku model. Perilaku terkait, seperti menyalakan atau mematikan perangkat itu sendiri, harus
gunakan ciri yang lebih spesifik (misalnya, thermostatMode dalam
karakteristik TemperatureSetting).
ATTRIBUTES Perangkat
Perangkat dengan karakteristik ini mungkin melaporkan hal berikut
sebagai bagian dari operasi SYNC. Untuk mempelajari
selengkapnya tentang menangani intent SYNC, lihat
Pemenuhan intent.
| Atribut | Jenis | Deskripsi |
|---|---|---|
availableModes |
Array |
Wajib. Daftar mode yang tersedia. |
[item, ...] |
Objek |
Mode tersedia. |
name |
String |
Wajib. Nama internal mode, yang akan digunakan dalam perintah dan status. URL ini mungkin tidak mudah digunakan dan akan dibagikan dalam semua bahasa. |
name_values |
Array |
Wajib. Sinonim mode dalam setiap bahasa yang didukung. |
[item, ...] |
Objek |
Sinonim mode dalam bahasa tertentu. |
name_synonym |
Array |
Wajib. Sinonim mode. 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. |
settings |
Array |
Wajib. Setelan yang didukung untuk mode ini. |
[item, ...] |
Objek |
Setelan yang didukung. Membutuhkan setidaknya 2 item. |
setting_name |
String |
Wajib. Nama internal setelan mode, yang akan digunakan dalam perintah dan status. URL ini mungkin tidak mudah digunakan 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 kebijakan ini disetel ke benar (true), tata bahasa tambahan untuk logika peningkatan/penurunan akan diterapkan, sesuai urutan (peningkatan) array setelan. |
commandOnlyModes |
Boolean |
(Default: Menunjukkan apakah perangkat mendukung penggunaan komunikasi satu arah (benar) atau dua arah (salah). Tetapkan atribut ini ke true jika perangkat tidak dapat merespons intent QUERY atau Status Laporan untuk karakteristik ini. |
queryOnlyModes |
Boolean |
(Default: Diperlukan jika perangkat mendukung eksekusi hanya kueri. Atribut ini menunjukkan apakah perangkat hanya dapat dikueri untuk mengetahui 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
}
NEGARA Perangkat
Entitas dengan karakteristik ini dapat melaporkan hal berikut
status sebagai bagian dari operasi QUERY. Untuk mempelajari
selengkapnya tentang menangani intent QUERY, lihat
Pemenuhan intent.
| Negara bagian | Jenis | Deskripsi |
|---|---|---|
currentModeSettings |
Objek |
Wajib. Pasangan kunci/nilai dengan mode |
<string> |
String |
Saat ini |
Contoh
Mode apa yang digunakan perangkat?
{
"currentModeSettings": {
"load_mode": "small_load",
"temp_mode": "cold_temp"
}
}
Perangkat COMMANDS
Perangkat dengan karakteristik ini dapat merespons hal berikut
sebagai bagian dari operasi EXECUTE. Untuk mempelajari
selengkapnya tentang menangani intent EXECUTE, lihat
Pemenuhan intent.
action.devices.commands.SetModes
Setelan mode update.
Parameter
| Parameter | Jenis | Deskripsi |
|---|---|---|
updateModeSettings |
Objek |
Wajib. Pasangan kunci/nilai dengan mode |
<string> |
String |
|
Contoh
Tetapkan ke beban 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