مخطط CameraPerson

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

sdm.devices.traits.CameraPerson

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

الحقول

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

الأوامر

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

الفعاليات

شخص

قابل للتحديث 

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

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

حدث شخصي

الحمولة

{
  "eventId" : "1ddaab64-7cd3-43d6-a493-573aa5fe25d5",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "e_r6O08OPPH33h2GjJj8pIjyGy...",
      }
    }
  }
  "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
مثال: "e_r6O08OPPH33h2GjJj8pIjyGy..."

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

الحقل الوصف نوع البيانات
eventId المعرّف الفريد للحدث. string
مثال: "1ddaab64-7cd3-43d6-a493-573aa5fe25d5"
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 تنتهي صلاحية صور الأحداث بعد 30 ثانية من نشر الحدث. يُرجى الحرص على تنزيل الصورة قبل انتهاء صلاحيتها.
معرّف الحدث غير تابع للكاميرا. FAILED_PRECONDITION استخدِم eventID الصحيح الذي تم إرجاعه من خلال حدث الكاميرا.

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