Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenmek için yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem oluşturmaya devam edersiniz.
Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Akıllı Ev ArmDisarm Kanal Şeması

action.devices.traits.ArmDisarm - Bu özellik, örneğin güvenlik sistemlerinde kullanıldığı şekilde etkinleştirilip devre dışı bırakılmasını destekler.

Birden çok güvenlik düzeyi bulunan cihazlarda bu düzeyler availableArmLevels özelliğiyle bildirilmelidir.

Cihaz ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işleminin bir parçası olarak aşağıdaki özellikleri bildirebilir. SYNC niyetlerini işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.

Özellikler Tür 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 Dize

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 seviye eş anlamlısı.

level_synonym Dizi

Zorunludur.

Her desteklenen dildeki seviye için kullanıcı dostu adlar. İlk öğe, standart ad olarak değerlendirilir.

[item, ...] Dize

Eş anlamlı adı.

lang Dize

Zorunludur.

Seviye eş anlamlılarının dil kodu. Desteklenen diller bölümünü inceleyin.

ordered Boole

Zorunludur.

Doğru değerine ayarlanırsa seviye/düşüş mantığı için seviye dizisi sırasına göre ek dil bilgisi uygulanır. Örneğin, "Ok Google, güvenlik düzeyimi 1 artır" komutu kullanıldığında Asistan, mevcut güvenlik düzeyini belirler ve ardından güvenlik düzeyini bir artırır. Bu değer false olarak ayarlanırsa artışı/azalış mantığı için ek dil bilgisi desteklenmez.

Örnekler

İki ayrı kol düzeyi olan 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 durumu

Bu özelliğe sahip cihazlar, QUERY işleminin bir parçası olarak aşağıdaki durumları bildirebilir. QUERY niyetlerini işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.

Eyaletler Tür Açıklama
isArmed Boole

Zorunludur.

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

currentArmLevel Dize

Zorunludur.

availableArmLevels özelliği belirtilirse zorunludur. 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 ayrılması gerektiğini belirtir.

Örnekler

Farklı kol düzeyini bildiren güvenlik sistemi

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

Cihaz FTC'leri

Bu özelliğe sahip cihazlar, EXECUTE işleminin bir parçası olarak aşağıdaki komutlara yanıt verebilir. EXECUTE niyetlerini işleme hakkında daha fazla bilgi edinmek 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 Tür Açıklama
followUpToken Dize

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 ettiğinde doğru değerini alır.

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

Parametreler Tür Açıklama
followUpToken Dize

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 Dize

Etkinleştirilecek level_name.

Örnekler

Sistemi etkinleştirme

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

Sistemi L1 koluna ayarlama

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

Etkinleştirme 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.