Smart Home ArmDisarm Trait Schema

action.devices.traits.ArmDisarm - Bu özellik, örneğin güvenlik sistemlerinde kullanılan kurma ve devre dışı bırakma işlevlerini destekler.

Birden fazla güvenlik düzeyine sahip cihazlarda bu düzeyler availableArmLevels özelliğiyle bildirilmelidir.

Cihaz ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işlemi kapsamında aşağıdaki özellikleri bildirebilir. SYNC amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacın karşılanması başlıklı makaleyi inceleyin.

Özellikler Tür Açıklama
availableArmLevels Nesne

Cihazın desteklenen güvenlik seviyelerini açıklar. Bu özellik bildirilmezse cihaz yalnızca bir düzeyi destekler.
levels Array

Zorunludur.

Cihaz tarafından desteklenen 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 Array

Zorunludur.

level_synonym ve lang içerir.
[item, ...] Nesne

Belirli bir dil için seviye eş anlamlısı. Dil yedeklemesi sağlamak için lang değeri en olan en az bir öğe gereklidir.
level_synonym Array

Zorunludur.

Desteklenen her dilde seviye için kullanıcı dostu adlar. İlk öğe, kanonik ad olarak kabul edilir.
[item, ...] String

Eş anlamlı kelime adı. Dil yedeklemesi sağlamak için lang değeri en olan en az bir öğe gereklidir.
lang String

Zorunludur.

Seviye eş anlamlıları için dil kodu. Desteklenen diller sayfasına bakın.
ordered Boole

Zorunludur.

Doğru olarak ayarlanırsa seviyeler dizisinin sırasına göre artırma/azaltma 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 belirleyip bu seviyeyi bir artırır. Bu değer false olarak ayarlanırsa artırma/azaltma mantığı için ek dil bilgisi desteklenmez.

Örnekler

İki farklı etkinleştirme 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ı ele alma hakkında daha fazla bilgi edinmek için Amacın karşılanması başlıklı makaleyi inceleyin.

Eyaletler Tür Açıklama
isArmed Boole

Zorunludur.

Cihazın şu anda etkin olup olmadığını gösterir.
currentArmLevel String

Zorunludur.

availableArmLevels özelliği belirtilmişse zorunludur. Birden fazla güvenlik düzeyi varsa mevcut güvenlik düzeyinin adını gösterir.
exitAllowance Tamsayı

Kullanıcının currentArmLevel özelliğinin etkinleşmesi için ayrılması gereken süreyi saniye cinsinden gösterir.

Ö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 amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacın karşılanması 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çeriyor:

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. Devre dışı bırakılamadı.
cancel Boole

Zorunludur.

arm değerinin iptal edilmesi gerektiğinde doğru olur.

Cihazı isteğe bağlı bir güvenlik düzeyiyle kurabilir veya devre dışı bırakabilirsiniz.

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. Devre dışı bırakılamadı.
armLevel String

Güvenlik sisteminin kurulacağı level_name.

Örnekler

Sistemi kurma

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "followUpToken": "123"
  }
}

Sistemi L1 alarm düzeyine ayarlama

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "armLevel": "L1",
    "followUpToken": "456"
  }
}

Kurma işlemini iptal etme

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "cancel": true
  }
}

Cihazı etkinleştirirken veya devre dışı bırakırken bir hata oluştu.

Desteklenen değerler:

alreadyInState
deviceTampered
passphraseIncorrect
pinIncorrect
securityRestriction
tooManyFailedAttempts
userCancelled

Cihaz HATALARI

Hata ve istisnaların tam listesini inceleyin.