طرح CameraClipPreview

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

sdm.devices.traits.CameraClipPreview

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

فیلدها

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

فرمان

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

رویدادها

ClipPreview

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

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

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

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

رویداد ClipPreview

پایه‌بار

{
  "eventId" : "f563f89d-e47e-4846-a0a9-1f2d89e18a5a",
"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
مثال: «f563f89d-e47e-4846-a0a9-1f2d89e18a5a»
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/...

خطاها

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