مخطط سمات جهاز استشعار المنزل الذكي
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" ] } } ] }
أجهزة الاستشعار المتوافقة
تسرد الجداول التالية أنواع أجهزة الاستشعار المتوافقة وإمكاناتها.
جودة الهواء
الاسم | الإمكانيات الوصفية | الإمكانات الرقمية |
---|---|---|
القيم المسموح بها:
|
القيم المسموح بها:
|
القيم المسموح بها:
|
أول أكسيد الكربون
الاسم | الإمكانيات الوصفية | الإمكانات الرقمية |
---|---|---|
القيم المسموح بها:
|
القيم المسموح بها:
|
القيم المسموح بها:
|
مستوى الدخان
الاسم | الإمكانيات الوصفية | الإمكانات الرقمية |
---|---|---|
القيم المسموح بها:
|
القيم المسموح بها:
|
القيم المسموح بها:
|
نظافة الفلتر
الاسم | الإمكانيات الوصفية | الإمكانات الرقمية |
---|---|---|
القيم المسموح بها:
|
القيم المسموح بها:
|
غير متاح. |
تسرب المياه
الاسم | الإمكانيات الوصفية | الإمكانات الرقمية |
---|---|---|
القيم المسموح بها:
|
القيم المسموح بها:
|
غير متاح. |
رصد هطول الأمطار
الاسم | الإمكانيات الوصفية | الإمكانات الرقمية |
---|---|---|
القيم المسموح بها:
|
القيم المسموح بها:
|
غير متاح. |
مدة الفلتر
الاسم | الإمكانيات الوصفية | الإمكانات الرقمية |
---|---|---|
القيم المسموح بها:
|
القيم المسموح بها:
|
القيم المسموح بها:
|
فترة بقاء الفلتر المحسوب
الاسم | الإمكانيات الوصفية | الإمكانات الرقمية |
---|---|---|
القيم المسموح بها:
|
غير متاح. | القيم المسموح بها:
|
مستوى ثاني أكسيد الكربون
الاسم | الإمكانيات الوصفية | الإمكانات الرقمية |
---|---|---|
القيم المسموح بها:
|
غير متاح. | القيم المسموح بها:
|
الجسيمات
الاسم | الإمكانيات الوصفية | الإمكانات الرقمية |
---|---|---|
القيم المسموح بها:
|
غير متاح. | القيم المسموح بها:
|
مركبات عضوية متقلبة
الاسم | الإمكانيات الوصفية | الإمكانات الرقمية |
---|---|---|
القيم المسموح بها:
|
غير متاح. | القيم المسموح بها:
|
حالة الجهاز STATES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن الحالات
التالية كجزء من عملية QUERY
. لمزيد من المعلومات حول التعامل مع إجراءات QUERY
، يُرجى الاطّلاع على تنفيذ الإجراء.
الولايات | النوع | الوصف |
---|---|---|
currentSensorStateData |
المصفوفة |
مطلوبة. قائمة بحالات المستشعر الحالية. |
[item, ...] |
العنصر |
حالة جهاز الاستشعار الحالية. |
name |
سلسلة |
مطلوبة. اسم حالة جهاز الاستشعار تتطابق مع قيمة من |
currentSensorState |
سلسلة |
قيمة الحالة الوصفية الحالية. تتطابق مع قيمة من |
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" } }