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

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

سمات الجهاز

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

السمات Type الوصف
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
    }
  ]
}

حالات الجهاز

قد تُبلِغ الكيانات التي تحمل هذه السمة عن الحالات التالية كجزء من عملية QUERY. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في QUERY، يُرجى الاطّلاع على تنفيذ النية بالشراء.

الولايات Type الوصف
occupancy String

مطلوب:

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

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

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

أمثلة

هل يرصد جهاز الاستشعار معدّل الإشغال في المكتب؟

{
  "occupancy": "OCCUPIED"
}

حوالات الجهاز

غير مسموح بأي رسائل

أخطاء الجهاز

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