Akıllı Ev ArmDisarm Kanal Şeması
action.devices.traits.ArmDisarm
- Bu özellik, örneğin güvenlik sistemlerinde kullanıldığı şekilde etkinleştirilip devre dışı bırakılmasını destekler.
Birden çok güvenlik düzeyi bulunan cihazlarda bu düzeyler availableArmLevels
özelliğiyle bildirilmelidir.
Cihaz ÖZELLİKLERİ
Bu özelliğe sahip cihazlar, SYNC
işleminin bir parçası olarak aşağıdaki özellikleri bildirebilir. SYNC
niyetlerini işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.
Özellikler | Tür | Açıklama |
---|---|---|
availableArmLevels |
Nesne |
Cihazın desteklenen güvenlik düzeylerini açıklar. Bu özellik bildirilmezse cihaz yalnızca bir düzeyi destekler. |
levels |
Dizi |
Zorunludur. Cihaz tarafından desteklenen kullanılabilir güvenlik düzeylerinin listesi. |
[item, ...] |
Nesne |
Güvenlik düzeyi. |
level_name |
Dize |
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 dil için seviye eş anlamlısı. |
level_synonym |
Dizi |
Zorunludur. Her desteklenen dildeki seviye için kullanıcı dostu adlar. İlk öğe, standart ad olarak değerlendirilir. |
[item, ...] |
Dize |
Eş anlamlı adı. |
lang |
Dize |
Zorunludur. Seviye eş anlamlılarının dil kodu. Desteklenen diller bölümünü inceleyin. |
ordered |
Boole |
Zorunludur. Doğru değerine ayarlanırsa seviye/düşüş mantığı için seviye dizisi sırasına göre ek dil bilgisi uygulanır. Örneğin, "Ok Google, güvenlik düzeyimi 1 artır" komutu kullanıldığında Asistan, mevcut güvenlik düzeyini belirler ve ardından güvenlik düzeyini bir artırır. Bu değer false olarak ayarlanırsa artışı/azalış mantığı için ek dil bilgisi desteklenmez. |
Örnekler
İki ayrı kol düzeyi olan 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 durumu
Bu özelliğe sahip cihazlar, QUERY
işleminin bir parçası olarak aşağıdaki durumları bildirebilir. QUERY
niyetlerini işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.
Eyaletler | Tür | Açıklama |
---|---|---|
isArmed |
Boole |
Zorunludur. Cihazın şu anda silahlı olup olmadığını belirtir. |
currentArmLevel |
Dize |
Zorunludur.
|
exitAllowance |
Integer |
|
Örnekler
Farklı kol düzeyini bildiren güvenlik sistemi
{ "isArmed": true, "currentArmLevel": "L1" }
Cihaz FTC'leri
Bu özelliğe sahip cihazlar, EXECUTE
işleminin bir parçası olarak aşağıdaki komutlara yanıt verebilir. EXECUTE
niyetlerini işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.
action.devices.commands.ArmDisarm
Bu cihazın alarm düzeyini ayarlayın.
Parametreler
Yük, aşağıdakilerden birini içerir:
Kolu veya devre dışı bırakma işlemini iptal et
Parametreler | Tür | Açıklama |
---|---|---|
followUpToken |
Dize |
Takip yanıtı için Google tarafından sağlanan jeton. |
arm |
Boole |
Zorunludur. Komut kol olduğunda doğru değerini alır. Devre dışı bırakmak için yanlış. |
cancel |
Boole |
Zorunludur. Komut |
İsteğe bağlı bir güvenlik seviyesi ile cihazı etkinleştirin veya devre dışı bırakın.
Parametreler | Tür | Açıklama |
---|---|---|
followUpToken |
Dize |
Takip yanıtı için Google tarafından sağlanan jeton. |
arm |
Boole |
Zorunludur. Komut kol olduğunda doğru değerini alır. Devre dışı bırakmak için yanlış. |
armLevel |
Dize |
Etkinleştirilecek |
Örnekler
Sistemi etkinleştirme
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "followUpToken": "123" } }
Sistemi L1 koluna ayarlama
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "armLevel": "L1", "followUpToken": "456" } }
Etkinleştirme işlemini iptal etme
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "cancel": true } }
İlgili hatalar
Cihaz etkinleştirilirken veya devre dışı bırakılırken bir hata oluştu.
Desteklenen değerler:
alreadyInState
deviceTampered
passphraseIncorrect
pinIncorrect
securityRestriction
tooManyFailedAttempts
userCancelled