مخطط سمات جهاز استشعار المنزل الذكي

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

الجهاز ATTRIBUTES

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

السمات	النوع	الوصف
sensorStatesSupported	المصفوفة	مطلوبة. يمثل كل كائن إمكانات حالة المستشعر المتوافقة مع هذا الجهاز المحدد. يجب أن يتضمّن كل جهاز استشعار وظيفة وصفية أو رقمية على الأقلّ. يمكن لأجهزة الاستشعار أيضًا الإبلاغ عن كلتيهما، وفي هذه الحالة سيتم تفضيل القيمة الرقمية.
[item, ...]	العنصر	إمكانات جهاز الاستشعار المتوافقة يتطلب عنصرًا واحدًا على الأقل.
name	سلسلة	مطلوبة. نوع جهاز الاستشعار المتوافق راجِع جدول "أجهزة الاستشعار المتوافقة".
descriptiveCapabilities	العنصر	وصف لإمكانيات جهاز الاستشعار.
availableStates	المصفوفة	مطلوبة. قائمة بالحالات المتاحة للجهاز. يتم دعم الحالة "غير معروف" بشكل ضمني عندما لا يعرض المستشعر قيمة.
[item, ...]	سلسلة	قيمة الحالة الوصفية المعتمدة. يتطلب عنصرًا واحدًا على الأقل.
numericCapabilities	العنصر	لوصف القيم العددية المحتملة التي يمكن للمستشعر الإبلاغ عنها.
rawValueUnit	سلسلة	مطلوبة. الوحدة الرقمية المتاحة.

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

أمثلة

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

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

حالة الجهاز STATES

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

الولايات	النوع	الوصف
currentSensorStateData	المصفوفة	مطلوبة. قائمة بحالات المستشعر الحالية.
[item, ...]	العنصر	حالة جهاز الاستشعار الحالية.
name	سلسلة	مطلوبة. اسم حالة جهاز الاستشعار تتطابق مع قيمة من sensorStatesSupported.
currentSensorState	سلسلة	قيمة الحالة الوصفية الحالية. تتطابق مع قيمة من sensorStatesSupported.
rawValue	Number	قيمة المستشعر الرقمي الحالي.

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

أمثلة

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

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

جهاز الاستشعار الذي يعرض قيمة الحالة الرقمية.

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

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

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

مفاتيح COMMAND

بلا عري

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

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

الحقول	النوع	الوصف
SensorState	العنصر	مطلوبة. البيانات الأساسية للإشعارات
priority	عدد صحيح	مطلوبة. يمثل مستوى الإشعار. القيمة المسموح بها حاليًا هي 0، مما يعني أنه يجب قول الإشعار بصوت عالٍ.
name	سلسلة	مطلوبة. اسم حالة جهاز الاستشعار اطلع على قائمة بأنواع أجهزة الاستشعار المتوافقة مع الإشعارات.
currentSensorState	سلسلة	مطلوبة. قيمة الحالة الوصفية الحالية. اطلع على قائمة بأنواع أجهزة الاستشعار المتوافقة مع الإشعارات.

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

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

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

أمثلة

يرصد الدخان.

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

أخطاء الجهاز

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