CameraClipPreview Şeması

Nest Doorbell (pil) Nest Doorbell (kablolu) 

sdm.devices.traits.CameraClipPreview

Bu özellik, klip önizlemesinin indirilmesini destekleyen tüm cihazlara aittir.

Alanlar

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

Komutlar

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

Etkinlikler

ClipPreview

Önizleme için bir video klip var.

Klip önizlemesi, mp4 formatındaki 10 karelik bir video dosyasıdır. mp4 video dosyasını göstermeyi seçebilir veya 10 karelik bir diziyi eksiksiz olarak göstermek için dosyayı başka bir biçime (ör. animasyonlu GIF) dönüştürebilirsiniz. Klip önizleme yöntemi seçilirken cihaz istemci özellikleri de dikkate alınmalıdır.

Bu etkinlik aşağıdaki etkinlikler için desteklenir:

Tür Öğe Açıklama
Etkinlik CameraMotion özelliğinin Hareket etkinliği Kamera hareket algıladı.
Etkinlik CameraPerson özelliğinin Person etkinliği Kamera bir kişi algıladı.
Etkinlik DoorbellChime özelliğinin Chime etkinliği Kapı ziline basıldı.
Bu etkinliği ve ilgili previewUrl etkinliğini bir veya daha fazla desteklenen etkinlikle ilişkilendirmek için eventSessionId kullanın.

ClipPreview etkinliği

Yük

{
  "eventId" : "54e55063-25e6-44a5-9aa7-704405bb1c91",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraClipPreview.ClipPreview" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "previewUrl" : "https://previewUrl/..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

ClipPreview etkinlik alanları

Alan Açıklama Veri Türü
eventSessionId İlgili etkinliklerin tek bir oturumunun parçası olarak gerçekleşen etkinliklere verilen kimliktir. Etkinlikleri birleştirmek için kullanılabilir. string
Örnek: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
previewUrl Video klibin önizleneceği URL. Varsayılan video codec'i H264'tür. string
Örnek: "https://previewUrl/..."

Etkinlik yükü alanları

Alan Açıklama Veri Türü
eventId Etkinliğin benzersiz tanımlayıcısıdır. string
Örnek: "54e55063-25e6-44a5-9aa7-704405bb1c91"
timestamp Etkinliğin gerçekleştiği zaman. string
Örnek: "2019-01-01T00:00:01Z"
resourceUpdate Kaynak güncellemesiyle ilgili bilgileri ayrıntılı şekilde gösteren bir nesne. object
userId Kullanıcıyı temsil eden benzersiz ve kodu karartılmış bir tanımlayıcı. string
Örnek: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
resourceGroup Bu etkinlikle benzer güncellemelere sahip olabilecek kaynakları gösteren bir nesne. Etkinliğin kaynağı (resourceUpdate nesnesinden) bu nesnede her zaman bulunur. object

Farklı etkinlik türleri ve bu etkinliklerin işleyiş şekli hakkında daha fazla bilgi edinmek için Etkinlikler bölümünü inceleyin.

Klibi önizle

Klibi önizlemek için HTTP Yetkilendirmesi başlığındaki OAuth erişim jetonunu kullanarak previewUrl öğesine bir GET çağrısı yapın:

Önizleme

curl -H 'Authorization: Bearer access-token' \
  https://previewUrl/...

Hatalar

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