طرح‌واره CameraClipPreview

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

sdm.devices.traits.CameraClipPreview

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

فیلدها

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

فرمان

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

رویدادها

ClipPreview

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

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

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

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

رویداد ClipPreview

پایه‌بار

{
  "eventId" : "3b38e05a-38d8-4b7b-a7cb-7e1a2a3bdbd8",
  "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
مثال: «3b38e05a-38d8-4b7b-a7cb-7e1a2a3bdbd8»
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/...

خطاها

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