طرحواره ویژگی وضعیت سنسور خانه هوشمند
action.devices.traits.SensorState
- این ویژگی هم اندازه گیری کمی و هم حالت کیفی را پوشش می دهد.
ویژگی های دستگاه
دستگاه های دارای این ویژگی ممکن است ویژگی های زیر را به عنوان بخشی از عملیات SYNC
گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت SYNC
، به تحقق هدف مراجعه کنید.
ویژگی های | تایپ کنید | شرح |
---|---|---|
sensorStatesSupported | آرایه | ضروری. هر شی نشان دهنده قابلیت های حالت حسگر است که توسط این دستگاه خاص پشتیبانی می شود. هر حسگر باید حداقل دارای قابلیت توصیفی یا عددی باشد. سنسورها همچنین می توانند هر دو را گزارش کنند، در این صورت مقدار عددی ترجیح داده می شود. |
[ item, ... ] | هدف - شی | قابلیت های سنسور پشتیبانی شده حداقل به 1 مورد نیاز دارد. |
name | رشته | ضروری. نوع سنسور پشتیبانی شده جدول سنسورهای پشتیبانی شده را ببینید. |
descriptiveCapabilities | هدف - شی | شرح قابلیت های سنسور. |
availableStates | آرایه | ضروری. لیست حالت های موجود برای دستگاه. حالت "ناشناخته" به طور ضمنی پشتیبانی می شود زمانی که سنسور مقداری را برنگرداند. |
[ item, ... ] | رشته | پشتیبانی از مقدار حالت توصیفی. حداقل به 1 مورد نیاز دارد. |
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
گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت QUERY
، به تحقق هدف مراجعه کنید.
ایالت ها | تایپ کنید | شرح |
---|---|---|
currentSensorStateData | آرایه | ضروری. فهرست حالات حسگر فعلی |
[ item, ... ] | هدف - شی | وضعیت سنسور فعلی |
name | رشته | ضروری. نام وضعیت سنسور با یک مقدار از |
currentSensorState | رشته | مقدار وضعیت توصیفی فعلی با یک مقدار از |
rawValue | عدد | مقدار سنسور عددی فعلی |
برای جزئیات بیشتر در مورد قابلیتها و انواع حسگرهای مختلف که این ویژگی پشتیبانی میکند، به حسگرهای پشتیبانی شده مراجعه کنید.
مثال ها
دستگاه حسگر که مقدار حالت توصیفی را گزارش میکند.
{ "currentSensorStateData": [ { "name": "AirQuality", "currentSensorState": "healthy" } ] }
دستگاه حسگری که مقدار حالت عددی را گزارش می کند.
{ "currentSensorStateData": [ { "name": "CarbonMonoxideLevel", "rawValue": 200 } ] }
دستگاه حسگر که مقدار حالت توصیفی و عددی را گزارش میکند.
{ "currentSensorStateData": [ { "name": "SmokeLevel", "currentSensorState": "smoke detected", "rawValue": 200 } ] }
دستورات دستگاه
هیچ یک.
اطلاعیه های دستگاه
دستگاههای دارای این ویژگی ممکن است بار اعلان زیر را به عنوان بخشی از تغییر وضعیت دستگاه برگردانند. برای کسب اطلاعات بیشتر در مورد اجرای اعلانها، به اطلاعیهها برای اقدامات خانه هوشمند مراجعه کنید.
زمینه های | تایپ کنید | شرح |
---|---|---|
SensorState | هدف - شی | ضروری. بار اعلان. |
priority | عدد صحیح | ضروری. سطح اعلان را نشان می دهد. مقدار پشتیبانی شده در حال حاضر 0 است، که نشان می دهد اعلان باید با صدای بلند گفته شود. |
name | رشته | ضروری. نام وضعیت سنسور لیست انواع سنسورهای پشتیبانی شده را برای اطلاعیه ها ببینید. |
currentSensorState | رشته | ضروری. مقدار وضعیت توصیفی فعلی لیست انواع سنسورهای پشتیبانی شده را برای اطلاعیه ها ببینید. |
محموله اعلان می تواند شامل انواع سنسورهای زیر باشد:
-
AirQuality
-
CarbonMonoxideLevel
-
SmokeLevel
-
FilterCleanliness
-
WaterLeak
-
RainDetection
-
FilterLifeTime
برای جزئیات بیشتر در مورد قابلیت های مختلف پشتیبانی شده توسط هر نوع سنسور، به سنسورهای پشتیبانی شده مراجعه کنید.
مثال ها
را
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }