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

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"
  }
}

أخطاء الجهاز

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