مخطّط سمة SensorState في المنزل الذكي

‫action.devices.traits.SensorState: تشمل هذه السمة كلاً من القياس الكمي والحالة النوعية.

سمات الجهاز

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

السمات النوع الوصف
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 intents، اطّلِع على تلبية النية.

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

مطلوبة

قائمة بحالات أداة الاستشعار الحالية
[item, ...] العنصر

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

مطلوبة

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

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

القيمة الرقمية الحالية لجهاز الاستشعار
alarmState String

حالة التنبيه المقابلة لقراءة أداة الاستشعار الحالية. قد يتم تشغيل إنذار أو إنذار مُسبَق عندما تقترب قراءات المستشعر من مستويات خطيرة وتصل إليها.

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

IDLE
المنبّه غير نشِط، فالمستويات التي تم رصدها ليست خطيرة.
PRE_ALARM_1
المستويات التي تم رصدها مرتفعة ولكنها لم تصل إلى مستويات الطوارئ بعد، وقد تصبح المستويات خطيرة قريبًا.
PRE_ALARM_2
إذا كان الجهاز يتيح إرسال تنبيهات متعددة قبل الوصول إلى مستويات الطوارئ، يعني ذلك أنّ مستويات رصد المخاطر أعلى من PRE_ALARM_1، وأنّ هذه المستويات تستمر في الارتفاع وقد تقترب قريبًا من مستويات الطوارئ.
ALARM
بلغت المستويات التي تم رصدها مستويات الطوارئ وتم تشغيل إنذار.
alarmSilenceState String

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

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

ALLOWED
لم يتم كتم صوت المنبّه، ويُسمح حاليًا بكتم صوته.
DISALLOWED
لم يتم كتم صوت المنبّه ولا يُسمح حاليًا بكتم صوته.
SILENCED
تم كتم صوت المنبّه.

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

أمثلة

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

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

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

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

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

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

جهاز استشعار يُبلغ عن قيمة الحالة الوصفية والرقمية ويشير إلى أنّ المنبّه نشط

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200,
      "alarmState": "ALARM",
      "alarmSilenceState": "DISALLOWED"
    }
  ]
}

أوامر الجهاز

بلا عُري

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

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

الحقول النوع الوصف
SensorState العنصر

مطلوبة

الحمولة في الإشعار
priority عدد صحيح

مطلوبة

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

مطلوبة

اسم حالة أداة الاستشعار اطّلِع على قائمة بأنواع أجهزة الاستشعار المتوافقة للإشعارات.
currentSensorState String

مطلوبة

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

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

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

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

أمثلة

يرصد الدخان.

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

أخطاء الجهاز

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