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

action.devices.traits.SensorState - تغطي هذه السمة كلاً من القياس الكمي والحالة النوعية.

سمات الجهاز

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

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

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

ويمثّل كل عنصر إمكانيات حالة المستشعر التي يتيحها هذا الجهاز المحدّد. يجب أن تحتوي كل أداة استشعار على إمكانية وصفية أو رقمية على الأقل. ويمكن أيضًا لأجهزة الاستشعار الإبلاغ عن كليهما، وفي هذه الحالة يُفضَّل استخدام القيمة الرقمية.

[item, ...] كائن

إمكانات أداة الاستشعار المتوافقة

يجب إدراج عنصر واحد على الأقل.

name String

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

نوع أداة الاستشعار المتوافق اطّلِع على جدول "أجهزة الاستشعار المتوافقة".

descriptiveCapabilities كائن

وصف لقدرات أداة الاستشعار.

availableStates صفيف

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

قائمة الحالات المتاحة للجهاز يتم دعم الحالة "غير معروف" بشكل ضمني عندما لا تعرض أداة الاستشعار أي قيمة.

[item, ...] String

قيمة الحالة الوصفية المتاحة

يجب إدراج عنصر واحد على الأقل.

numericCapabilities كائن

تصف القيم الرقمية المحتملة التي يمكن لأداة الاستشعار الإبلاغ عنها.

rawValueUnit String

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

وحدة رقمية مسموح بها.

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

أمثلة

جهاز الاستشعار الذي يبلغ عن قيمة الحالة الوصفية

{
  "sensorStatesSupported": [
    {
      "name": "AirQuality",
      "descriptiveCapabilities": {
        "availableStates": [
          "healthy",
          "moderate",
          "unhealthy",
          "very unhealthy"
        ]
      }
    }
  ]
}

جهاز استشعار يبلغ عن قيمة الحالة الرقمية

{
  "sensorStatesSupported": [
    {
      "name": "CarbonMonoxideLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      }
    }
  ]
}

جهاز استشعار يسجّل قيمة الحالة الوصفية والرقمية

{
  "sensorStatesSupported": [
    {
      "name": "SmokeLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      },
      "descriptiveCapabilities": {
        "availableStates": [
          "smoke detected",
          "high",
          "no smoke detected"
        ]
      }
    }
  ]
}

أجهزة الاستشعار المتوافقة

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

جودة الهواء

الاسم الإمكانات الوصفية إمكانات رقمية

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

AirQuality

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

healthy
moderate
unhealthy
unhealthy for sensitive groups
very unhealthy
hazardous
good
fair
poor
very poor
severe
unknown

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

AQI

أول أكسيد الكربون

الاسم الإمكانات الوصفية إمكانات رقمية

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

CarbonMonoxideLevel

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

carbon monoxide detected
high
no carbon monoxide detected
unknown

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

PARTS_PER_MILLION

مستوى الدخان

الاسم الإمكانات الوصفية إمكانات رقمية

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

SmokeLevel

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

smoke detected
high
no smoke detected
unknown

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

PARTS_PER_MILLION

مستوى نظافة الفلتر

الاسم الإمكانات الوصفية إمكانات رقمية

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

FilterCleanliness

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

clean
dirty
needs replacement
unknown
غير متاح.

تسرُّب المياه

الاسم الإمكانات الوصفية إمكانات رقمية

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

WaterLeak

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

leak
no leak
unknown
غير متاح.

رصد تساقط الأمطار

الاسم الإمكانات الوصفية إمكانات رقمية

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

RainDetection

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

rain detected
no rain detected
unknown
غير متاح.

العمر الافتراضي للفلتر

الاسم الإمكانات الوصفية إمكانات رقمية

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

FilterLifeTime

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

new
good
replace soon
replace now
unknown

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

PERCENTAGE

مدة صلاحية الفلتر المحسوبة

الاسم الإمكانات الوصفية إمكانات رقمية

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

PreFilterLifeTime
HEPAFilterLifeTime
Max2FilterLifeTime
غير متاح.

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

PERCENTAGE

مستوى ثاني أكسيد الكربون

الاسم الإمكانات الوصفية إمكانات رقمية

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

CarbonDioxideLevel
غير متاح.

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

PARTS_PER_MILLION

الجسيمات المعلّقة

الاسم الإمكانات الوصفية إمكانات رقمية

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

PM2.5
PM10
غير متاح.

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

MICROGRAMS_PER_CUBIC_METER

المركّبات العضوية المتطايرة

الاسم الإمكانات الوصفية إمكانات رقمية

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

VolatileOrganicCompounds
غير متاح.

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

PARTS_PER_MILLION

حالات الجهاز

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

الولايات النوع الوصف
currentSensorStateData صفيف

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

قائمة بحالات أداة الاستشعار الحالية

[item, ...] كائن

حالة أداة الاستشعار الحالية

name String

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

اسم حالة أداة الاستشعار يتطابق مع قيمة من sensorStatesSupported.

currentSensorState String

قيمة الحالة الوصفية الحالية. يتطابق مع قيمة من sensorStatesSupported.

rawValue Number

قيمة أداة الاستشعار الرقمية الحالية

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

أمثلة

جهاز الاستشعار الذي يبلغ عن قيمة الحالة الوصفية

{
  "currentSensorStateData": [
    {
      "name": "AirQuality",
      "currentSensorState": "healthy"
    }
  ]
}

جهاز استشعار يبلغ عن قيمة الحالة الرقمية

{
  "currentSensorStateData": [
    {
      "name": "CarbonMonoxideLevel",
      "rawValue": 200
    }
  ]
}

جهاز استشعار يسجّل قيمة الحالة الوصفية والرقمية

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200
    }
  ]
}

مفاتيح الجهاز

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

إشعارات الجهاز

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

الحقول النوع الوصف
SensorState كائن

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

حمولة الإشعارات

priority عدد صحيح

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

يمثّل مستوى الإشعار. والقيمة المسموح بها حاليًا هي 0، ما يعني أنّه يجب قول الإشعار بصوت عالٍ.

name String

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

اسم حالة أداة الاستشعار يمكنك الاطّلاع على قائمة بأنواع أدوات الاستشعار المتوافقة لعرض الإشعارات.

currentSensorState String

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

قيمة الحالة الوصفية الحالية. يمكنك الاطّلاع على قائمة بأنواع أدوات الاستشعار المتوافقة لعرض الإشعارات.

يمكن أن تحتوي حمولة الإشعارات على أنواع أجهزة الاستشعار التالية:

  • AirQuality
  • CarbonMonoxideLevel
  • SmokeLevel
  • FilterCleanliness
  • WaterLeak
  • RainDetection
  • FilterLifeTime

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

أمثلة

رصد الدخان.

{
  "SensorState": {
    "priority": 0,
    "name": "SmokeLevel",
    "currentSensorState": "high"
  }
}

أخطاء الجهاز

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