مرحبًا بك في "مركز مطوّري Google Home"، الوجهة الجديدة لتعلّم كيفية تطوير المهام المنزلية الذكية. ملاحظة: ستواصل إنشاء إجراءات في "وحدة تحكّم المهام".

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

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

أخطاء الجهاز

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