طرح‌واره CameraPerson

Nest Cam (legacy) Nest Cam (outdoor or indoor, battery) Nest Cam with floodlight Nest Cam (indoor, wired) Nest Hub Max Nest Doorbell (legacy) Nest Doorbell (battery) Nest Doorbell (wired) 

sdm.devices.traits.CameraPerson

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

فیلدها

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

فرمان

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

رویدادها

شخص

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

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

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

رویداد شخص

پایه‌بار

{
  "eventId" : "7536fd3b-537e-430b-9e0a-284007d88044",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "4BZzMyazK8z96z555j9-TToHU5...",
      }
    }
  }
  "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
مثال: «4BZzMyazK8z96z555j9-TToHU5...»

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

فیلد شرح نوع داده
eventId شناسه یکتای رویداد. string
مثال: «7536fd3b-537e-430b-9e0a-284007d88044»
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

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

خطاها

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

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

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