طرح پیش‌نمایش CameraClip

زنگ درب نست (باتری) زنگ درب نست (سیمی)

sdm.devices.traits.CameraClipPreview

این ویژگی متعلق به هر دستگاهی است که از دانلود پیش‌نمایش کلیپ پشتیبانی می‌کند.

فیلدها

هیچ فیلدی برای این ویژگی موجود نیست.

دستورات

هیچ دستوری برای این ویژگی موجود نیست.

رویدادها

پیش‌نمایش کلیپ

یک کلیپ ویدیویی برای پیش‌نمایش در دسترس است.

پیش‌نمایش کلیپ، یک فایل ویدیویی ۱۰ فریمی با فرمت mp4 است. می‌توانید فایل ویدیویی mp4 را نمایش دهید یا آن را به فرمت دیگری (مثلاً یک گیف متحرک) تبدیل کد کنید تا یک توالی کامل ۱۰ فریمی نمایش داده شود. هنگام انتخاب روش پیش‌نمایش کلیپ، باید قابلیت‌های دستگاه کلاینت را در نظر بگیرید.

این رویداد برای رویدادهای زیر پشتیبانی می‌شود:

نوع عنصر توضیحات
رویداد رویداد حرکت از ویژگی CameraMotion حرکت توسط دوربین تشخیص داده شده است.
رویداد رویداد Person از ویژگی CameraPerson یک نفر توسط دوربین شناسایی شده است.
رویداد رویداد Chime از ویژگی DoorbellChime زنگ در فشرده شده است.
از eventSessionId برای مرتبط کردن این رویداد و previewUrl مرتبط با آن با یک یا چند رویداد پشتیبانی شده استفاده کنید.

رویداد ClipPreview

بار مفید 

{
  "eventId" : "c6af1089-abe7-4391-9be6-c10b0f631488",
  "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

میدان توضیحات نوع داده
eventSessionId شناسه‌ای که به رویدادهایی که به عنوان بخشی از یک جلسه از رویدادهای مرتبط رخ می‌دهند، داده می‌شود. ممکن است برای تجمیع رویدادها استفاده شود. string
مثال: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
previewUrl آدرس اینترنتی (URL) برای پیش‌نمایش کلیپ ویدیویی. کدک پیش‌فرض ویدیو H264 است. string
مثال: "https:// previewUrl /..."

فیلدهای بار رویداد

میدان توضیحات نوع داده
eventId شناسه منحصر به فرد برای رویداد. string
مثال: "c6af1089-abe7-4391-9be6-c10b0f631488"
timestamp زمانی که رویداد رخ داده است. string
مثال: "2019-01-01T00:00:01Z"
resourceUpdate شیء‌ای که اطلاعات مربوط به به‌روزرسانی منابع را شرح می‌دهد. object
userId یک شناسه منحصر به فرد و مبهم که نمایانگر کاربر است. string
مثال: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
resourceGroup شیء‌ای که منابعی را نشان می‌دهد که ممکن است به‌روزرسانی‌های مشابهی با این رویداد داشته باشند. منبع خود رویداد (از شیء resourceUpdate ) همیشه در این شیء وجود خواهد داشت. object

برای اطلاعات بیشتر در مورد انواع مختلف رویدادها و نحوه عملکرد آنها، به بخش رویدادها مراجعه کنید.

پیش‌نمایش کلیپ

برای پیش‌نمایش کلیپ، با استفاده از توکن دسترسی OAuth در هدر HTTP Authorization، یک فراخوانی GET به previewUrl انجام دهید:

پیش‌نمایش 

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

خطاها

برای مشاهده لیست کامل کدهای خطای API به مرجع کدهای خطای API مراجعه کنید.