مخطط سمة جهاز استشعار المنزل المزوّد بأجهزة ذكية
action.devices.traits.SensorState
- تغطي هذه السمة كلاً من القياس الكمي والحالة النوعية.
سمات الجهاز
قد تُبلغ الأجهزة التي تتضمّن هذه السمة عن السمات التالية كجزء من عملية 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" ] } } ] }
أجهزة الاستشعار المتوافقة
تسرد الجداول التالية أنواع أجهزة الاستشعار المتوافقة والإمكانات المرتبطة بها.
جودة الهواء
الاسم | الإمكانات الوصفية | إمكانات رقمية |
---|---|---|
القيم المسموح بها:
|
القيم المسموح بها:
|
القيم المسموح بها:
|
أول أكسيد الكربون
الاسم | الإمكانات الوصفية | إمكانات رقمية |
---|---|---|
القيم المسموح بها:
|
القيم المسموح بها:
|
القيم المسموح بها:
|
مستوى الدخان
الاسم | الإمكانات الوصفية | إمكانات رقمية |
---|---|---|
القيم المسموح بها:
|
القيم المسموح بها:
|
القيم المسموح بها:
|
مستوى نظافة الفلتر
الاسم | الإمكانات الوصفية | إمكانات رقمية |
---|---|---|
القيم المسموح بها:
|
القيم المسموح بها:
|
غير متاح. |
تسرُّب المياه
الاسم | الإمكانات الوصفية | إمكانات رقمية |
---|---|---|
القيم المسموح بها:
|
القيم المسموح بها:
|
غير متاح. |
رصد تساقط الأمطار
الاسم | الإمكانات الوصفية | إمكانات رقمية |
---|---|---|
القيم المسموح بها:
|
القيم المسموح بها:
|
غير متاح. |
العمر الافتراضي للفلتر
الاسم | الإمكانات الوصفية | إمكانات رقمية |
---|---|---|
القيم المسموح بها:
|
القيم المسموح بها:
|
القيم المسموح بها:
|
مدة صلاحية الفلتر المحسوبة
الاسم | الإمكانات الوصفية | إمكانات رقمية |
---|---|---|
القيم المسموح بها:
|
غير متاح. | القيم المسموح بها:
|
مستوى ثاني أكسيد الكربون
الاسم | الإمكانات الوصفية | إمكانات رقمية |
---|---|---|
القيم المسموح بها:
|
غير متاح. | القيم المسموح بها:
|
الجسيمات المعلّقة
الاسم | الإمكانات الوصفية | إمكانات رقمية |
---|---|---|
القيم المسموح بها:
|
غير متاح. | القيم المسموح بها:
|
المركّبات العضوية المتطايرة
الاسم | الإمكانات الوصفية | إمكانات رقمية |
---|---|---|
القيم المسموح بها:
|
غير متاح. | القيم المسموح بها:
|
حالات الجهاز
قد تبلّغ الكيانات التي تتضمّن هذه السمة عن الحالات التالية كجزء من عملية QUERY
. لمزيد من المعلومات عن التعامل مع أغراض QUERY
، يُرجى الاطّلاع على تنفيذ النية.
الولايات | النوع | الوصف |
---|---|---|
currentSensorStateData |
صفيف |
يجب ملء هذا الحقل. قائمة بحالات أداة الاستشعار الحالية |
[item, ...] |
كائن |
حالة أداة الاستشعار الحالية |
name |
String |
يجب ملء هذا الحقل. اسم حالة أداة الاستشعار يتطابق مع قيمة من |
currentSensorState |
String |
قيمة الحالة الوصفية الحالية. يتطابق مع قيمة من |
rawValue |
Number |
قيمة أداة الاستشعار الرقمية الحالية |
يمكنك الاطّلاع على أجهزة الاستشعار المتوافقة للحصول على مزيد من التفاصيل حول الإمكانات المختلفة وأنواع أجهزة الاستشعار التي توفّرها هذه السمة.
أمثلة
جهاز الاستشعار الذي يبلغ عن قيمة الحالة الوصفية
{ "currentSensorStateData": [ { "name": "AirQuality", "currentSensorState": "healthy" } ] }
جهاز استشعار يبلغ عن قيمة الحالة الرقمية
{ "currentSensorStateData": [ { "name": "CarbonMonoxideLevel", "rawValue": 200 } ] }
جهاز استشعار يسجّل قيمة الحالة الوصفية والرقمية
{ "currentSensorStateData": [ { "name": "SmokeLevel", "currentSensorState": "smoke detected", "rawValue": 200 } ] }
مفاتيح الجهاز
غير مسموح بأي رسائل
إشعارات الجهاز
قد تعرض الأجهزة التي تتضمّن هذه السمة حمولة الإشعارات التالية كجزء من تغيير حالة الجهاز. لمزيد من المعلومات حول تنفيذ الإشعارات، يمكنك الاطّلاع على إشعارات إجراءات المنزل المزوّد بأجهزة ذكية.
الحقول | النوع | الوصف |
---|---|---|
SensorState |
كائن |
يجب ملء هذا الحقل. حمولة الإشعارات |
priority |
عدد صحيح |
يجب ملء هذا الحقل. يمثّل مستوى الإشعار. والقيمة المسموح بها حاليًا هي 0، ما يعني أنّه يجب قول الإشعار بصوت عالٍ. |
name |
String |
يجب ملء هذا الحقل. اسم حالة أداة الاستشعار يمكنك الاطّلاع على قائمة بأنواع أدوات الاستشعار المتوافقة لعرض الإشعارات. |
currentSensorState |
String |
يجب ملء هذا الحقل. قيمة الحالة الوصفية الحالية. يمكنك الاطّلاع على قائمة بأنواع أدوات الاستشعار المتوافقة لعرض الإشعارات. |
يمكن أن تحتوي حمولة الإشعارات على أنواع أجهزة الاستشعار التالية:
AirQuality
CarbonMonoxideLevel
SmokeLevel
FilterCleanliness
WaterLeak
RainDetection
FilterLifeTime
يمكنك الاطّلاع على أجهزة الاستشعار المتوافقة للحصول على مزيد من التفاصيل حول الإمكانات المختلفة التي يوفّرها كل نوع من أنواع أجهزة الاستشعار.
أمثلة
رصد
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }