Akıllı Ev ArmDisarm Özelliği Şeması
action.devices.traits.ArmDisarm
: Bu özellik, örneğin güvenlik sistemlerinde kullanılan silahlandırma ve silahsızlandırma işlemlerini destekler.
Birden fazla güvenlik düzeyine sahip cihazlarda bu düzeyler availableArmLevels
özelliğiyle bildirilmelidir.
CİHAZ ÖZELLİKLERİ
Bu özelliğe sahip cihazlar, SYNC
işlemi kapsamında aşağıdaki özellikleri bildirebilir. SYNC
intent'lerini işleme hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.
Özellikler | Tür | Açıklama |
---|---|---|
availableArmLevels |
Nesne |
Cihazın desteklenen güvenlik seviyelerini açıklar. Bu özellik raporlanmazsa cihaz yalnızca bir seviyeyi destekler. |
levels |
Dizi |
Zorunludur. Cihaz tarafından desteklenen mevcut güvenlik seviyelerinin listesi. |
[item, ...] |
Nesne |
Güvenlik seviyesi. |
level_name |
String |
Zorunludur. Komutlarda ve durumlarda kullanılan güvenlik düzeyinin dahili adı. Bu ad, kullanıcı dostu olmayabilir ve tüm dillerde paylaşılır. |
level_values |
Dizi |
Zorunludur.
|
[item, ...] |
Nesne |
Belirli bir dilin eş anlamlı seviyesi. |
level_synonym |
Dizi |
Zorunludur. Desteklenen her dilde seviye için kullanıcı dostu adlar. İlk öğe, standart ad olarak kabul edilir. |
[item, ...] |
String |
Eş anlamlı kelime adı. |
lang |
String |
Zorunludur. Seviye eş anlamlılarının dil kodu. Desteklenen diller bölümüne bakın. |
ordered |
Boole |
Zorunludur. Doğru olarak ayarlanırsa seviyeler dizisinin sırasına göre artma/azalma mantığı için ek dil bilgisi uygulanır. Örneğin, "Ok Google, güvenlik seviyemi 1 artır" dediğinizde Asistan mevcut güvenlik seviyesini belirler ve ardından bu güvenlik seviyesini bir artırır. Bu değer yanlış olarak ayarlanırsa artış/azalma mantığı için ek dil bilgisi desteklenmez. |
Örnekler
İki farklı kol seviyesine sahip güvenlik sistemi
{ "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 } }
Cihaz DURUMLARI
Bu özelliğe sahip öğeler, QUERY
işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY
intent'lerini işleme hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.
Eyaletler | Tür | Açıklama |
---|---|---|
isArmed |
Boole |
Zorunludur. Cihazın şu anda alarmlı olup olmadığını belirtir. |
currentArmLevel |
String |
Zorunludur.
|
exitAllowance |
Tamsayı |
|
Örnekler
Farklı kol seviyesini bildiren güvenlik sistemi
{ "isArmed": true, "currentArmLevel": "L1" }
Cihaz KOMUTLARI
Bu özelliğe sahip cihazlar, EXECUTE
işlemi kapsamında aşağıdaki komutlara yanıt verebilir. EXECUTE
intent'lerini işleme hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.
action.devices.commands.ArmDisarm
Bu cihazın alarm düzeyini ayarlayın.
Parametreler
Yük aşağıdakilerden birini içerir:
Etkinleştirme veya devre dışı bırakma işlemini iptal etme
Parametreler | Tür | Açıklama |
---|---|---|
followUpToken |
String |
Takip yanıtı için Google tarafından sağlanan jeton. |
arm |
Boole |
Zorunludur. Komut silahlandırma olduğunda doğru değerini alır. Silahı devre dışı bırakmak için yanlış. |
cancel |
Boole |
Zorunludur. Komut |
İsteğe bağlı bir güvenlik düzeyiyle cihazı etkinleştirin veya devre dışı bırakın.
Parametreler | Tür | Açıklama |
---|---|---|
followUpToken |
String |
Takip yanıtı için Google tarafından sağlanan jeton. |
arm |
Boole |
Zorunludur. Komut, silahlandırma olduğunda doğru değerini alır. Silahı devre dışı bırakmak için yanlış. |
armLevel |
String |
Etkinleştirileceği |
Örnekler
Sistemi etkinleştirme
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "followUpToken": "123" } }
Sistemi L1 kol seviyesi olarak ayarlama
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "armLevel": "L1", "followUpToken": "456" } }
Arma işlemini iptal etme
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "cancel": true } }
İlgili hatalar
Cihazın etkinleştirilmesi veya devre dışı bırakılması sırasında hata oluştu.
Desteklenen değerler:
alreadyInState
deviceTampered
passphraseIncorrect
pinIncorrect
securityRestriction
tooManyFailedAttempts
userCancelled