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ılabilen komut yok.

Etkinlikler

ClipPreview

Video klip önizlenebilir.

Klip önizlemesi, mp4 biçiminde 10 karelik bir video dosyasıdır. 10 karelik bir sırayı eksiksiz olarak göstermek için mp4 video dosyasını göstermeyi seçebilir veya başka bir biçime (ör. animasyonlu GIF) kod dönüştürebilirsiniz. Klip önizleme yöntemi seçerken cihaz istemci özellikleri 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 Kişi 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 öğesini bir veya daha fazla desteklenen etkinlikle ilişkilendirmek için eventSessionId öğesini kullanın.

ClipPreview etkinliği

Yük

{
  "eventId" : "fee9d372-2c10-43ae-96d5-4990e9abc1c6",
  "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 oturumu kapsamında gerçekleşen etkinliklere atanan kimlik. 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ı. string
Örnek: "fee9d372-2c10-43ae-96d5-4990e9abc1c6"
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 içeren bir nesne. object
userId Kullanıcıyı temsil eden benzersiz, karartılmış bir tanımlayıcı. string
Örnek: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
resourceGroup Bu etkinlikle benzer güncellemelere sahip olabilecek kaynakları belirten bir nesne. Etkinliğin kaynağı (resourceUpdate nesnesinden) her zaman bu nesnede bulunur. object

Farklı etkinlik türleri ve bunların işleyiş şekli hakkında daha fazla bilgi için Etkinlikler başlıklı makaleyi inceleyin.

Klibi önizleme

Klibi önizlemek için HTTP Authorization üst bilgisindeki OAuth erişim jetonunu kullanarak previewUrl adresine GET çağrısı gönderin:

Ö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.