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

İlgili hatalar

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.