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

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

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

أخطاء الجهاز

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