مخطط سمة استشعار تواجد الأفراد في المنازل المزوّدة بأجهزة ذكية

action.devices.traits.OccupancySensing: تنتمي هذه السمة إلى الأجهزة التي يمكنها رصد تواجد الأفراد في المنزل، سواء من خلال تقنية PIR أو الموجات فوق الصوتية أو أجهزة استشعار التلامس الجسدي.

صفات الجهاز

قد تبلّغ الأجهزة التي تتضمّن هذه السمة عن السمات التالية كجزء من عملية SYNC. لمزيد من المعلومات حول التعامل مع أغراض SYNC، يمكنك الاطّلاع على تنفيذ النية.

السمات النوع الوصف
occupancySensorConfiguration صفيف

قائمة بالعناصر، يحتوي كل منها على نوع أداة الاستشعار والتأخيرات المرتبطة به والحدّ الأدنى للأحداث
[item, ...] كائن

نوع أداة الاستشعار والتأخيرات المرتبطة به والحدّ الأدنى للأحداث، إذا كان ذلك منطبقًا.
occupancySensorType String

يجب ملء هذا الحقل.

القيم المسموح بها:

PIR
يتوافق الجهاز مع ميزة استشعار تواجد الأفراد في المنزل من خلال ميزة الاستشعار السلبي بالأشعة تحت الحمراء (PIR).
ULTRASONIC
يوفّر الجهاز إمكانية استشعار تواجد الأفراد في المنزل من خلال الاستشعار بالموجات فوق الصوتية.
PHYSICAL_CONTACT
يوفّر الجهاز ميزة استشعار تواجد الأفراد في المنزل من خلال ميزة استشعار جهات الاتصال.
occupiedToUnoccupiedDelaySec عدد صحيح

يمثّل هذا المقياس المهلة الزمنية بالثواني قبل أن يتغيّر معدّل الإشغال المُبلّغ عنه إلى حالة "غير مشغول" بعد آخر حدث تم رصده.
unoccupiedToOccupiedDelaySec عدد صحيح

يمثّل هذا المقياس المهلة الزمنية بالثواني قبل أن يتغيّر معدّل الإشغال المُبلّغ عنه إلى حالة مشغول بعد آخر حدث تم رصده. تكون هذه السمة مطلوبة إذا تم ضبط occupiedToUnoccupiedDelaySec.
unoccupiedToOccupiedEventThreshold عدد صحيح

يحدِّد عدد أحداث الاكتشاف التي يجب أن تحدث خلال الفترة unoccupiedToOccupiedDelaySec قبل أن يتغير الإشغال المُبلغ عنه إلى حالة مشغول. تكون هذه السمة مطلوبة إذا تم ضبط unoccupiedToOccupiedDelaySec.

أمثلة

أداة استشعار تواجد الأفراد في المنزل تتوافق مع ميزة PIR والاستشعار بالموجات فوق الصوتية

{
  "occupancySensorConfiguration": [
    {
      "occupancySensorType": "PIR",
      "occupiedToUnoccupiedDelaySec": 10,
      "unoccupiedToOccupiedDelaySec": 10,
      "unoccupiedToOccupiedEventThreshold": 2
    },
    {
      "occupancySensorType": "ULTRASONIC",
      "occupiedToUnoccupiedDelaySec": 10,
      "unoccupiedToOccupiedDelaySec": 10,
      "unoccupiedToOccupiedEventThreshold": 2
    }
  ]
}

STATES الجهاز

يمكن للكيانات التي تحمل هذه السمة الإبلاغ عن الحالات التالية كجزء من عملية QUERY. لمزيد من المعلومات حول التعامل مع أغراض QUERY، يمكنك الاطّلاع على تنفيذ النية.

الولايات النوع الوصف
occupancy String

يجب ملء هذا الحقل.

تشير هذه القيمة إلى ما إذا كان الجهاز يستشعر رصد تواجد الأفراد في المنزل.

القيم المسموح بها:

OCCUPIED
يرصد الجهاز الإشغال.
UNOCCUPIED
لم يرصد الجهاز الإشغال.
UNKNOWN_OCCUPANCY_STATE
حالة الإشغال الحالية التي يرصدها الجهاز غير معروفة.

أمثلة

هل يرصد جهاز الاستشعار تواجد الأفراد في المكتب؟

{
  "occupancy": "OCCUPIED"
}

تعليمات الجهاز

بلا عُري

أخطاء الجهاز

راجع القائمة الكاملة للأخطاء والاستثناءات.