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