طرح‌واره CameraPerson

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

sdm.devices.traits.CameraPerson

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

فیلدها

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

فرمان

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

رویدادها

شخص

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

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

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

رویداد شخص

پایه‌بار

{
  "eventId" : "41f5481c-1e98-42f9-86d5-e6a10cf62e20",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "5-LiOBqUN-mSIRT4scu6XQTt4N...",
      }
    }
  }
  "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
مثال: «5-LiOBqUN-mSIRT4scu6XQTt4N...»

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

فیلد شرح نوع داده
eventId شناسه یکتای رویداد. string
مثال: «41f5481c-1e98-42f9-86d5-e6a10cf62e20»
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 تصاویر رویداد ۳۰ ثانیه پس‌از انتشار رویداد منقضی می‌شود. حتماً تصویر را قبل‌از منقضی شدن بارگیری کنید.
شناسه رویداد متعلق به دوربین نیست. FAILED_PRECONDITION از eventID صحیح برگردانده‌شده توسط رویداد دوربین استفاده کنید.

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