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.

level_synonym ve lang içerir.

[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.

availableArmLevels özelliği belirtilmişse gereklidir. Birden fazla güvenlik düzeyi varsa mevcut güvenlik düzeyinin adını belirtir.

exitAllowance Tamsayı

currentArmLevel etkinleşmeden önce kullanıcının ayrılması gereken süreyi (saniye cinsinden) belirtir.

Ö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 arm değerini iptal etmek olduğunda doğru değerini döndürür.

İ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 level_name.

Ö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
  }
}

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

Cihaz HATALARI

Hataların ve istisnaların tam listesini inceleyin.