مخطط CameraPerson

كاميرا Nest Cam (الإصدار القديم) كاميرا Nest Cam (مزودة ببطارية داخل المنزل أو خارجه) كاميرا Nest Cam مع مصباح كاميرا Nest Cam (سلكية داخل المنزل) Nest Hub Max جرس Nest Doorbell (الإصدار القديم) جرس Nest Doorbell (بطارية) جرس Nest Doorbell (سلكي) 

sdm.devices.traits.CameraPerson

تنتمي هذه السمة إلى أي جهاز يتيح أحداث كشف وجود أشخاص.

الحقول

لا تتوفّر أي حقول لهذه السمة.

الأوامر

لا تتوفّر أي أوامر لهذه السمة.

الفعاليات

شخص

قابلة للتعديل 

رصدت الكاميرا شخصًا.

يتوافق هذا الحدث مع الإشعارات القابلة للتعديل. يمكن تعديل إشعارات التطبيق الحالية التي تم إنشاؤها من هذا الحدث باستخدام محتوى من حدث لاحق يتضمّن eventThreadId نفسه.

رصد شخص

الحمولة

{
  "eventId" : "f8b4ee06-05fc-4508-af2a-fedb709abc4c",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "PUVQouIQNQ_Nlf2sqhGPBhNVEq...",
      }
    }
  }
  "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
Example: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
eventId كاميرا Nest Cam (الإصذار القديم) Nest Hub Max جرس Nest Doorbell (الإصدار القديم) معرّف مرتبط بالحدث.

استخدِم هذا المعرّف مع الأمر GenerateImage لتنزيل صورة الكاميرا المرتبطة بهذا الحدث.

 string
Example: "PUVQouIQNQ_Nlf2sqhGPBhNVEq..."

حقول حمولة الحدث

الحقل الوصف نوع البيانات
eventId المعرّف الفريد للحدث. string
Example: "f8b4ee06-05fc-4508-af2a-fedb709abc4c"
timestamp الوقت الذي وقع فيه الحدث. string
مثال: "‎2019-01-01T00:00:01Z"
resourceUpdate عنصر يقدّم تفاصيل حول آخر التعديلات من المورد. object
userId معرّف فريد ومشوَّش يمثّل المستخدِم. string
Example: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
eventThreadId قابلة للتعديل المعرّف الفريد لسلسلة الأحداث. string
Example: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
eventThreadState قابلة للتعديل تمثّل هذه السمة حالة سلسلة الأحداث. string
القيم: "STARTED" أو "UPDATED" أو "ENDED"
resourceGroup عنصر يشير إلى الموارد التي قد تتضمّن تعديلات مشابهة لهذا الحدث. سيكون مورد الحدث نفسه (من العنصر resourceUpdate) متاحًا دائمًا في هذا العنصر. object

يمكنك الاطّلاع على الفعاليات لمزيد من المعلومات عن الأنواع المختلفة من الأحداث وكيفية عملها.

الأخطاء

قد يتم عرض رموز الخطأ التالية فيما يتعلق بهذه السمة:

رسالة الخطأ متوسط عائد النقرة تحديد المشاكل وحلّها
لم تعُد صورة الكاميرا متاحة للتنزيل. DEADLINE_EXCEEDED تنتهي صلاحية صور الأحداث بعد 30 ثانية من نشر الحدث. احرص على تنزيل الصورة قبل انتهاء صلاحيتها.
لا ينتمي معرّف الحدث إلى الكاميرا. FAILED_PRECONDITION استخدِم eventID الصحيح الذي يعرضه حدث رصدته الكاميرا.

يمكنك الاطّلاع على مرجع رموز الخطأ في واجهة برمجة التطبيقات للحصول على القائمة الكاملة بهذه الرموز.