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

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

سمات الجهاز

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

السمات	Type	الوصف
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

حالات الجهاز

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

الولايات	Type	الوصف
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
    }
  ]
}

حوالات الجهاز

بلا عري

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

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

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

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

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

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

أمثلة

يرصد الدخان.

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

أخطاء الجهاز

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