طرح‌واره CameraClipPreview

Nest Doorbell (باتری‌دار) Nest Doorbell (سیمی) 

sdm.devices.traits.CameraClipPreview

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

فیلدها

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

فرمان

هیچ فرمانی برای این مشخصه دردسترس نیست.

رویدادها

ClipPreview

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

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

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

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

رویداد ClipPreview

پایه‌بار

{
  "eventId" : "6c648daa-5aa9-47b4-80f4-05a22ef953e2",
  "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 نشانی وبی که در آن پیش‌نمایش کلیپ ویدیویی را ببینید. کدک ویدیویی پیش‌فرض H264 است. string
مثال: «https://previewUrl/...»

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

فیلد شرح نوع داده
eventId شناسه یکتای رویداد. string
مثال: «6c648daa-5aa9-47b4-80f4-05a22ef953e2»
timestamp زمانی که رویداد رخ داده است. string
مثال: «‎2019-01-01T00:00:01Z»
resourceUpdate شیئی که اطلاعات مربوط به به‌روزرسانی منبع را شرح می‌دهد. object
userId شناسه یکتای مبهمی که کاربر را نشان می‌دهد. string
مثال: «AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi»
resourceGroup شیئی که منابعی را نشان می‌دهد که ممکن است به‌روزرسانی‌های مشابهی با این رویداد داشته باشند. منبع خود رویداد (از شیء resourceUpdate) همیشه در این شیء وجود خواهد داشت. object

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

پیش‌دید کردن کلیپ

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

پیش‌نمایش

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

خطاها

برای مشاهده فهرست کامل کدهای خطای میانای برنامه‌سازی کاربردی، مرجع کدهای خطای میانای برنامه‌سازی کاربردی را ببینید.