طرح‌واره 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" : "f5586d41-d794-4218-bb83-22f47d9a2561",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "2lGyPgVVUlqV1-S1pHvvHGBPOH...",
      }
    }
  }
  "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
مثال: «2lGyPgVVUlqV1-S1pHvvHGBPOH...»

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

فیلد شرح نوع داده
eventId شناسه یکتای رویداد. string
مثال: «f5586d41-d794-4218-bb83-22f47d9a2561»
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 صحیح برگردانده‌شده توسط رویداد دوربین استفاده کنید.

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