Skema Atribut SmartDisarm Smart Home
action.devices.traits.ArmDisarm
- Sifat ini mendukung pengaktifan dan penonaktifan seperti yang digunakan dalam, misalnya, sistem keamanan.
Untuk perangkat dengan beberapa tingkat keamanan, tingkat ini harus dilaporkan dengan
atribut availableArmLevels
.
ATRIBUT Perangkat
Perangkat dengan karakteristik ini dapat melaporkan atribut
berikut sebagai bagian dari operasi SYNC
. Untuk mempelajari
penanganan intent SYNC
lebih lanjut, lihat
fulfillment intent.
Atribut | Jenis | Deskripsi |
---|---|---|
availableArmLevels |
Objek |
Menjelaskan tingkat keamanan perangkat yang didukung. Jika atribut ini tidak dilaporkan, perangkat hanya mendukung satu level. |
levels |
Array |
Wajib. Daftar tingkat keamanan yang tersedia yang didukung oleh perangkat. |
[item, ...] |
Objek |
Tingkat keamanan. |
level_name |
String |
Wajib. Nama internal tingkat keamanan yang digunakan dalam perintah dan status. Nama ini dapat tidak mudah digunakan dan dibagikan dalam semua bahasa. |
level_values |
Array |
Wajib. Berisi |
[item, ...] |
Objek |
Sinonim tingkat untuk bahasa tertentu. |
level_synonym |
Array |
Wajib. Nama yang mudah digunakan untuk level dalam setiap bahasa yang didukung. Item pertama diperlakukan sebagai nama kanonis. |
[item, ...] |
String |
Nama sinonim. |
lang |
String |
Wajib. Kode bahasa untuk sinonim tingkat. Lihat Bahasa yang didukung. |
ordered |
Boolean |
Wajib. Jika disetel ke benar (true), tata bahasa tambahan untuk logika penambahan/penurunan akan diterapkan, dalam urutan array level. Misalnya, "Ok Google, tingkatkan level keamanan saya sebanyak 1", menghasilkan Asisten yang menentukan tingkat keamanan saat ini, lalu meningkatkan tingkat keamanan tersebut satu tingkat. Jika nilai ini ditetapkan ke false, tata bahasa tambahan untuk logika penambahan/penurunan tidak didukung. |
Contoh
Sistem keamanan dengan dua tingkat lengan yang berbeda
{ "availableArmLevels": { "levels": [ { "level_name": "L1", "level_values": [ { "level_synonym": [ "Home and Guarding", "SL1" ], "lang": "en" }, { "level_synonym": [ "Zuhause und Bewachen", "SL1" ], "lang": "de" } ] }, { "level_name": "L2", "level_values": [ { "level_synonym": [ "Away and Guarding", "SL2" ], "lang": "en" }, { "level_synonym": [ "Weg und Bewachen", "SL2" ], "lang": "de" } ] } ], "ordered": 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.
Negara bagian | Jenis | Deskripsi |
---|---|---|
isArmed |
Boolean |
Wajib. Menunjukkan apakah perangkat saat ini diaktifkan. |
currentArmLevel |
String |
Wajib. Wajib jika atribut |
exitAllowance |
Integer |
Menunjukkan waktu, dalam detik, pengguna harus pergi sebelum |
Contoh
Sistem keamanan yang melaporkan tingkat grup yang berbeda
{ "isArmed": true, "currentArmLevel": "L1" }
COMMAND Perangkat
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.ArmDisarm
Setel tingkat alarm perangkat ini.
Parameter
Payload berisi salah satu dari hal berikut:
Membatalkan operasi pengaktifan atau penonaktifan
Parameter | Jenis | Deskripsi |
---|---|---|
followUpToken |
String |
Token yang disediakan Google untuk respons tindak lanjut. |
arm |
Boolean |
Wajib. True saat perintah ditujukan untuk mengaktifkan. Salah untuk dinonaktifkan. |
cancel |
Boolean |
Wajib. Benar jika perintahnya adalah membatalkan nilai |
Mengaktifkan atau menonaktifkan perangkat, dengan tingkat keamanan opsional.
Parameter | Jenis | Deskripsi |
---|---|---|
followUpToken |
String |
Token yang disediakan Google untuk respons tindak lanjut. |
arm |
Boolean |
Wajib. True saat perintah ditujukan untuk mengaktifkan. Salah untuk dinonaktifkan. |
armLevel |
String |
|
Contoh
Mengisi sistem
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "followUpToken": "123" } }
Menyetel sistem ke level otomatis L1
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "armLevel": "L1", "followUpToken": "456" } }
Membatalkan operasi pengaktifan
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "cancel": true } }
Error terkait
Terjadi error saat mengaktifkan atau menonaktifkan perangkat.
Nilai yang didukung:
alreadyInState
deviceTampered
passphraseIncorrect
pinIncorrect
securityRestriction
tooManyFailedAttempts
userCancelled