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.

Cihaz ATTRIBUTES

Bu özelliğe sahip cihazlar, SYNC işleminin bir parçası olarak aşağıdaki özellikleri bildirebilir. SYNC intent'lerini ele alma 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 seviyesinin 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.

Düzey için desteklenen her dilde kullanıcı dostu adlar. İlk öğe, standart ad olarak kabul edilir.
[item, ...] String

Eş anlamlı kelime adı.
lang String

Zorunludur.

Düzey eş anlamlıları için 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 false (yanlış) olarak ayarlanırsa, artırma/azaltma mantığı için ek dilbilgisi kullanılamaz.

Ö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 amaçlarının ele alınması hakkında daha fazla bilgi edinmek için Niyet karşılama bölümüne bakın.

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 geçerli 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

Ayrı 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 ele alma hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.

action.devices.commands.ArmDisarm

Bu cihazın alarm seviyesini 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 etkinleştirildiğinde doğru değerini döndürü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. Devre dışı bırakmak için Yanlış değerine dokunun.
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

Hata ve istisnaların tam listesini inceleyin.