CameraPerson Şeması

Nest Cam (eski) Nest Cam (dış veya iç mekan, pil) Projektörlü Nest Cam Nest Cam (iç mekan, kablolu) Nest Hub Max Nest Doorbell (eski) Nest Doorbell (pil) Nest Doorbell (kablolu) 

sdm.devices.traits.CameraPerson

Bu özellik, kişi algılama etkinliklerini destekleyen tüm cihazlara aittir.

Alanlar

Bu özellik için kullanılabilir alan yok.

Komutlar

Bu özellik için kullanılabilir komut yok.

Etkinlikler

Kişi

Güncellenebilir 

Kamera bir kişi algıladı.

Bu etkinlik, güncellenebilir bildirimleri destekliyor. Bu etkinlikten oluşturulan mevcut uygulama bildirimleri, aynı eventThreadId ile sonraki bir etkinliğin içeriği kullanılarak güncellenebilir.

Kişi etkinliği

Yük

{
  "eventId" : "a83d73ba-0af9-4751-a226-f91e40b3987c",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "MAEiz3D0IPphj1wutVjbi2a72D...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Kişi etkinliği alanları

Alan Açıklama Veri Türü
eventSessionId Nest Doorbell (pil) Nest Doorbell (kablolu) İlgili etkinliklerin tek bir oturumu kapsamında gerçekleşen etkinliklere verilen kimlik. Etkinlikleri birleştirmek için kullanılabilir.

Bu etkinliği, CameraClipPreview özelliğinin ilgili ClipPreview etkinliğiyle ilişkilendirmek için kullanın.

 string
Örnek: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
eventId Nest Cam (eski) Nest Hub Max Nest Doorbell (eski) Etkinlikle ilişkili bir kimlik.

Bu etkinlikle ilgili kamera görüntüsünü indirmek için GenerateImage komutuyla birlikte kullanın.

 string
Örnek: "MAEiz3D0IPphj1wutVjbi2a72D..."

Etkinlik yükü alanları

Alan Açıklama Veri Türü
eventId Etkinliğin benzersiz tanımlayıcısı. string
Örnek: "a83d73ba-0af9-4751-a226-f91e40b3987c"
timestamp Etkinliğin gerçekleştiği zaman. string
Örnek: "2019-01-01T00:00:01Z"
resourceUpdate Kaynak güncellemesiyle ilgili bilgileri ayrıntılı olarak açıklayan bir nesne. object
userId Kullanıcıyı temsil eden benzersiz ve karartılmış tanımlayıcı. string
Örnek: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
eventThreadId Güncellenebilir Etkinlik iş parçacığının benzersiz tanımlayıcısı. string
Örnek: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
eventThreadState Güncellenebilir Etkinlik iş parçacığının durumu. string
Değerler: "BAŞLADI", "GÜNCELLENDİ", "SONA ERDİ"
resourceGroup Bu etkinlikle benzer güncellemeler içerebilecek kaynakları belirten bir nesne. Etkinliğin kaynağı (resourceUpdate nesnesinden) bu nesnede her zaman bulunur. object

Farklı etkinlik türleri ve bunların işleyiş şekli hakkında daha fazla bilgi için Etkinlikler bölümüne bakın.

Hatalar

Bu özellik ile ilgili olarak aşağıdaki hata kodları döndürülebilir:

Hata Mesajı TBG Sorun giderme
Kamera görüntüsü artık indirilemiyor. DEADLINE_EXCEEDED Etkinlik resimlerinin süresi, etkinlik yayınlandıktan 30 saniye sonra dolar. Resmi süresi dolmadan önce indirdiğinizden emin olun.
Etkinlik kimliği kameraya ait değil. FAILED_PRECONDITION Kamera etkinliği tarafından döndürülen doğru eventID değerini kullanın.

API hata kodlarının tam listesi için API Hata Kodu Referansı'na bakın.