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ılabilir alan yok.

Komutlar

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

Etkinlikler

ClipPreview

Video klip önizleme için hazır.

Klip önizlemesi, mp4 biçimindeki 10 karelik bir video dosyasıdır. 10 karelik bir dizinin tamamını göstermek için mp4 video dosyasını göstermeyi veya başka bir biçime (örneğin, animasyonlu GIF) dönüştürmeyi seçebilirsiniz. Klip önizleme yöntemi seçilirken cihaz istemcisi ö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 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 öğesini, desteklenen bir veya daha fazla etkinlikle ilişkilendirmek için eventSessionId bileşenini kullanın.

ClipPreview etkinliği

Yük

{
  "eventId" : "7bbaa368-4d7b-49bf-b443-e3afe3b86554",
  "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 etkinliklerden oluşan tek bir oturumun parçası olarak gerçekleşen etkinliklere verilen 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ıdır. string
Örnek: "7bbaa368-4d7b-49bf-b443-e3afe3b86554"
timestamp Etkinliğin gerçekleştiği zaman. string
Örnek: "2019-01-01T00:00:01Z"
resourceUpdate Kaynak güncellemesiyle ilgili bilgileri ayrıntılandıran 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 etkinliğe benzer güncellemelere sahip olabilecek kaynakları gösteren 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 bölümüne bakın.

Klibi önizle

Klibi önizlemek için HTTP Yetkilendirme üst bilgisinde 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.