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 seviyesine sahip cihazlarda bu seviyeler 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ı karşılama 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

Zorunlu.

Cihaz tarafından desteklenen güvenlik seviyelerinin listesi.
[item, ...] Nesne

Güvenlik seviyesi.
level_name String

Zorunlu.

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 Array

Zorunlu.

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

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

Zorunlu.

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

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

Zorunlu.

Seviye eş anlamlılarının dil kodu. Desteklenen diller bölümüne bakın.
ordered Boole

Zorunlu.

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 yanlış 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ı karşılama başlıklı makaleyi inceleyin.

Eyaletler Tür Açıklama
isArmed Boole

Zorunlu.

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

Zorunlu.

availableArmLevels özelliği belirtilmişse zorunludur. Birden fazla güvenlik seviyesi varsa mevcut güvenlik seviyesinin adını gösterir.
exitAllowance Integer

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ı 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ç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

Zorunlu.

Komut, silahlandırma olduğunda doğru olur. Devre dışı bırakılamadı.
cancel Boole

Zorunlu.

Komut, arm değerini iptal etmek olduğunda doğru olur.

İsteğe bağlı güvenlik seviyesiyle 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

Zorunlu.

Komut, silahlandırma olduğunda doğru olur. Devre dışı bırakılamadı.
armLevel String

Güvenlik sisteminin kurulacağı level_name.

Örnekler

Sistemi etkinleştirme

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

Sistemi L1 alarm seviyesine 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

Hatalar ve istisnalar listesinin tamamını inceleyin.