Hatalar ve istisnalar

Bu dokümanda, akıllı telefon ile ilgili resmi olarak desteklenen hatalar ve istisnalar ev cihazları. Lütfen bu belirtilen hataları ve istisna kodlarını niyette kullanın yanıt olarak veya bildirimlerde Google Asistan'ın son kullanıcıları bir sorunla ilgili sorunlar konusunda veya cihaz durumuna bağlı olarak değişebilir. Yanıt yanlış biçimlendirme içeriyorsa veya errorCode, Google Asistan kullanıcılara genel bir hata mesajı verir. Örneğin: "Maalesef cihaz şu anda kullanılamıyor".

Hatalar

Bir sorun, yürütülmesine veya başarısız olur. Örneğin, bir kapı kilidi sıkışmış ve veya kilidi açılmışsa kullanıcıya bu durumla ilgili bir hata döndürülecektir.

Hata kodları cihaz düzeyinde veya genel düzeyde eklenebilir. Örneğin, Kullanıcının bir sağlayıcıdan çok sayıda ışığı varsa ve kullanıcı bir merkez tarafından kontrol ediliyorsa, kullanıcı tüm ışıklarını kapatmak isterse sağlayıcı tek bir lamba çevrimdışıysa cihaz düzeyinde hata veya tüm merkez çevrimdışı ve hiçbir ışık kontrol edilemez. Tüm cihaz çevrimdışı olduğundan, genel düzeyi veya cihaz düzeyini kullanmak arasında fark yoktur hatalar. Cihaz çevrimdışıyken {"online": false} durumunu şurada bildirmelisiniz: reportState hatasını deviceOffline hata kodu.

Özet olarak:

• Genel düzeyde hata: yanıttaki tüm cihazlarda aynı hata bulunuyor
• Yerel düzeyde hata: hata ve başarı örnekleri içeren karışık yanıt

ziyaret edin.

Genel düzeydeki hatalar

Aşağıdaki JSON snippet'i, QUERY veya EXECUTE yanıtı.

Hub'dan kaynaklanan genel düzey deviceOffline hatasına örnek: çevrimdışı:

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "errorCode": "deviceOffline",
    "status" : "ERROR"
  }
}

Hub'dan kaynaklanan genel düzey inSoftwareUpdate hatasına örnek: güncelleniyor:

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "errorCode": "inSoftwareUpdate",
    "status" : "ERROR"
  }
}

Cihaz düzeyindeki hatalar

QUERY yanıtı

Aşağıdaki JSON snippet'i, QUERY yanıtı.

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "devices": {
      "device-id-1": {
        "errorCode": "deviceOffline",
        "status" : "ERROR"
      },
      "device-id-2": {
        "errorCode": "deviceOffline",
        "status" : "ERROR"
      }
    }
  }
}

Yanıtı UYGULAMA

Aşağıdaki JSON snippet'i, Yanıtı Yürüt.

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [
      {
        "ids": [
          "device-id-1"
        ],
        "status": "ERROR",
        "errorCode": "deviceOffline"
      },
      {
        "ids": [
          "device-id-2"
        ],
        "status": "SUCCESS",
        "states": {
          "on": true,
          "online": true
        }
      }
    ]
  }
}

Hata içeren bildirimler

Proaktif bildirim

Aşağıdaki JSON snippet'i, proaktif bir bildirimdir.

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "agentUserId": "agent-user-id-1",
  "eventId": "unique-event-id-1",
  "payload": {
    "devices": {
      "notifications": {
        "device-id-1": {
          "RunCycle": {
            "priority": 0,
            "status": "FAILURE",
            "errorCode": "deviceDoorOpen"
          }
        }
      }
    }
  }
}

Takip yanıtı

Aşağıdaki JSON snippet'i, bir takip e-postası gönderin.

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "agentUserId": "agent-user-id-1",
  "eventId": "unique-event-id-1",
  "payload": {
    "devices": {
      "notifications": {
        "device-id-1": {
          "LockUnlock": {
            "priority": 0,
            "followUpResponse": {
              "status": "FAILURE",
              "errorCode": "deviceJammingDetected",
              "followUpToken": "PLACEHOLDER"
            }
          }
        }
      }
    }
  }
}

Hata listesi

Aşağıdaki hatalar, cihazda ilişkili TTS'yi oluşturur.

.

İstisnalar

Bir komutunu kullanın. Komut başarılı veya başarısız olabilir.

Komut başarılı olduysa (durum = "BAŞARILI"), istisnaları raporlayın StatusReport özelliğini kullanarak (hedef dışındaki cihazlar için), veya uygun bir exceptionCode (hedef cihaz için) döndürerek.

Örneğin, kurutucu tüy ekranı doluysa kullanıcı yine de ancak onları bu durum hakkında uyarmak isteyebilirsiniz. Benzer şekilde, cihazın şarjı boşsa bile, şurada bir komut çalıştırabilirsiniz: ancak cihazın pilinin azaldığını bildirmelidir.

Komut istisnalar nedeniyle başarısız olursa durum "EXCEPTIONS" (İSTİSNALAR) olmalıdır. Ayrıca istisnalar StatusReport özelliği kullanılarak bildirilmelidir.

Hedef cihaz hakkında engellenmeyen istisna (BAŞARILI)

Bu örnek kapıyı kilitlemek içindir:

Ön kapı kilidinin pil seviyesi düşük. Ön kapı kilitleniyor.

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["device-id-1"],
      "status": "SUCCESS",
      "states": {
        "on": true,
        "online": true,
        "isLocked": true,
        "isJammed": false,
        "exceptionCode": "lowBattery"
      }
    }]
  }
}

Durum Raporu kullanılan başka bir cihaz hakkında engellenmeyen istisna (BAŞARILI)

Bu örnek, bir güvenlik sistemini devre dışı bırakmak içindir: Tamam, güvenlik sistemi etkinleştiriliyor. Ön pencere açık.

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["device-id-1"],
      "status": "SUCCESS",
      "states": {
        "on": true,
        "online": true,
        "isArmed": true,
        "currentArmLevel": "L2",
        "currentStatusReport": [{
          "blocking": false,
          "deviceTarget": "sensor_id1",
          "priority": 0,
          "statusCode": "deviceOpen"
        }]
      }
    }]
  }
}

Durum Raporu kullanılarak başka bir cihazla ilgili engelleme istisnası

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "devices": {
      "device-id-1": {
        "on": true,
        "online": true,
        "status": "EXCEPTIONS",
        "currentStatusReport": [{
            "blocking": true,
            "deviceTarget": "device-id-1",
            "priority": 0,
            "statusCode": "lowBattery"
          },
          {
            "blocking": true,
            "deviceTarget": "front_window_id",
            "priority": 1,
            "statusCode": "deviceOpen"
          },
          {
            "blocking": true,
            "deviceTarget": "back_window_id",
            "priority": 1,
            "statusCode": "deviceOpen"
          }
        ]
      }
    }
  }
}

İstisna listesi

Aşağıdaki istisnalar cihazda ilişkilendirilmiş TTS'yi oluşturur.

.