مخطط CameraPerson

sdm.devices.traits.CameraPerson

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

الحقول

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

الطلبات الصوتية

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

الفعاليات

شخص

قابل للتعديل 

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

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

حدث شخص

الحمولة

{
  "eventId" : "914a826c-8b1f-4ff9-8b53-a2b92a945cd2",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "9Uk0BSbGbYySSeq4b4LOXni1fb...",
      }
    }
  }
  "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
مثال: "9Uk0BSbGbYySSeq4b4LOXni1fb..."

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

الحقل الوصف نوع البيانات
eventId المعرّف الفريد للحدث string
مثال: "914a826c-8b1f-4ff9-8b53-a2b92a945cd2"
timestamp وقت وقوع الحدث. string
مثال: "2019-01-01T00:00:01Z"
resourceUpdate كائن يوضح تفاصيل المعلومات عن تحديث المورد. object
userId معرّف فريد مشفَّر يمثّل المستخدم string
مثال: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
eventThreadId قابل للتعديل المعرّف الفريد لسلسلة الأحداث. string
مثال: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
eventThreadState قابلة للتعديل حالة سلسلة أحداث الفعالية. string
القيم: "تم البدء"، "تم التعديل"، "ENDED"
resourceGroup كائن يشير إلى الموارد التي قد تحتوي على تعديلات مشابهة لهذا الحدث. سيكون مورد الحدث نفسه (من الكائن resourceUpdate) متوفرًا دائمًا في هذا الكائن. object

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

الأخطاء

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

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

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