طرحواره CameraPerson

Nest Cam (قدیمی) Nest Cam (در فضای باز یا داخلی، باتری) Nest Cam با نورافکن Nest Cam (داخلی، سیمی) Nest Hub Max Nest Doorbell (قدیمی) Nest Doorbell (باتری) Nest Doorbell (سیمی)

sdm.devices.traits.CameraPerson

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

فیلدها

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

دستورات

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

رویدادها

شخص

قابل به روز رسانی

یک نفر توسط دوربین شناسایی شده است.

این رویداد از اعلان های قابل به روز رسانی پشتیبانی می کند. اعلان‌های برنامه موجود ایجاد شده از این رویداد را می‌توان با استفاده از محتوای رویداد بعدی با همان eventThreadId به‌روزرسانی کرد.

رویداد شخصی

بار 

{
  "eventId" : "d7397c30-5034-461c-9bd6-1ab66752c5ff",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "DMQWYZ9JH-oKl7KVY-4-Ss8B7P...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

فیلدهای رویداد شخص

میدان توضیحات نوع داده
eventSessionId Nest Doorbell (باتری) Nest Doorbell (سیمی) شناسه ای که به رویدادهایی داده می شود که به عنوان بخشی از یک جلسه واحد از رویدادهای مرتبط رخ می دهند. ممکن است برای ادغام رویدادها استفاده شود.

از آن برای مرتبط کردن این رویداد با رویداد ClipPreview مربوط به ویژگی CameraClipPreview استفاده کنید.

 string
مثال: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
eventId Nest Cam (قدیمی) Nest Hub Max Nest Doorbell (قدیمی) شناسه مرتبط با رویداد.

از آن با دستور GenerateImage برای دانلود تصویر دوربین مربوط به این رویداد استفاده کنید.

 string
مثال: "DMQWYZ9JH-oKl7KVY-4-Ss8B7P..."

فیلدهای محموله رویداد

میدان توضیحات نوع داده
eventId شناسه منحصر به فرد رویداد. string
مثال: "d7397c30-5034-461c-9bd6-1ab66752c5ff"
timestamp زمانی که واقعه رخ داده است. string
مثال: "2019-01-01T00:00:01Z"
resourceUpdate یک شی که جزئیات مربوط به به روز رسانی منبع را ارائه می دهد. object
userId یک شناسه منحصر به فرد و مبهم که نشان دهنده کاربر است. string
مثال: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
eventThreadId به روز رسانی شناسه منحصر به فرد برای موضوع رویداد. string
مثال: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
eventThreadState به روز رسانی وضعیت موضوع رویداد. string
مقادیر: "STARTED"، "UPDATED"، "ENDED"
resourceGroup شیئی که منابعی را نشان می‌دهد که ممکن است به‌روزرسانی‌های مشابهی با این رویداد داشته باشند. منبع خود رویداد (از شی resourceUpdate ) همیشه در این شی وجود خواهد داشت. object

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

خطاها

کد(های) خطای زیر ممکن است در رابطه با این ویژگی برگردانده شوند:

پیغام خطا RPC عیب یابی
تصویر دوربین دیگر برای دانلود در دسترس نیست. DEADLINE_EXCEEDED تصاویر رویداد 30 ثانیه پس از انتشار رویداد منقضی می شوند. حتما قبل از انقضا تصویر را دانلود کنید.
شناسه رویداد به دوربین تعلق ندارد. FAILED_PRECONDITION از eventID صحیحی که توسط رویداد دوربین برگردانده شده است استفاده کنید.

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