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

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

ATTRIBUTES للجهاز

يمكن أن تُبلغ الأجهزة التي تتضمّن هذه السمة عن ما يلي: كجزء من عملية 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
    }
  ]
}

CommandS للجهاز

بلا عُري

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

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

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

يمكن أن تتضمّن حمولة الإشعارات أنواع أدوات الاستشعار التالية:

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

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

أمثلة

يرصد دخانًا.

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

أخطاء الجهاز

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