طرحواره ویژگی حالت سنسور خانه هوشمند
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" } }