Smart Home ArmDisarm Kanal Şeması

action.devices.traits.ArmDisarm - Bu özellik, örneğin güvenlik sistemlerinde olduğu gibi etkinleştirilip devre dışı bırakılmayı destekler.

Birden fazla güvenlik düzeyi bulunan 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 amaçlarını işleme hakkında daha fazla bilgi için Amaç karşılama bölümüne bakın.

Özellikler Type 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 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 değerini içerir.

[item, ...] Nesne

Belirli bir dil için düzey eş anlamlısı.

level_synonym Dizi

Zorunludur.

Desteklenen her dilde düzeyin kullanıcı dostu adları. İlk öğe, standart ad olarak değerlendirilir.

[item, ...] String

Eş anlamlı ad.

lang String

Zorunludur.

Seviye eş anlamlılarının dil kodu. Desteklenen diller başlıklı makaleye bakın.

ordered Boole

Zorunludur.

Politika doğru değerine ayarlanırsa artış/azalış mantığı için ek dil bilgisi seviyeleri dizisi sırasına göre uygulanır. Örneğin, "Ok Google, güvenlik seviyemi 1 artır" ibaresi Asistan'ın geçerli güvenlik düzeyini belirlemesine ve ardından bu güvenlik düzeyini artırmasına neden olur. Bu değer, yanlış değerine ayarlanırsa artış/azalış mantığı için ek dil bilgisi desteklenmez.

Örnekler

İki ayrı kol düzeyine 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 STATUS

Bu özelliğe sahip varlıklar, QUERY işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY amaçlarını işleme hakkında daha fazla bilgi için Amaç karşılama bölümüne bakın.

Eyaletler Type Açıklama
isArmed Boole

Zorunludur.

Cihazın şu anda silahlı olup olmadığını belirtir.

currentArmLevel String

Zorunludur.

availableArmLevels özelliği belirtilirse gereklidir. Birden fazla güvenlik düzeyi varsa geçerli güvenlik düzeyinin adını belirtir.

exitAllowance Integer

currentArmLevel geçerli olmadan önce kullanıcının kaç saniye içinde yola çıkması gerektiğini belirtir.

Örnekler

Farklı kol seviyesi bildiren güvenlik sistemi

{
  "isArmed": true,
  "currentArmLevel": "L1"
}

Cihaz Komisyonları

Bu özelliğe sahip cihazlar, EXECUTE işleminin bir parçası olarak aşağıdaki komutlara yanıt verebilir. EXECUTE amaçlarını işleme hakkında daha fazla bilgi 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 Type Açıklama
followUpToken String

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 arm değerini iptal etmek olduğunda doğru değerini alır.

İsteğe bağlı bir güvenlik düzeyiyle cihazı etkinleştirin veya devre dışı bırakın.

Parametreler Type Açıklama
followUpToken String

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 String

Güvenlik sistemi level_name.

Örnekler

Sistemi etkinleştir

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

Sistemi L1 kol düzeyine ayarla

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

Oluşturma işlemini iptal etme

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

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

Desteklenen değerler:

alreadyInState
deviceTampered
passphraseIncorrect
pinIncorrect
securityRestriction
tooManyFailedAttempts
userCancelled

Cihaz HATALARI

Hataların ve istisnaların tam listesini inceleyin.