طرحواره ویژگی حالت سنسور خانه هوشمند

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"
        ]
      }
    }
  ]
}

سنسورهای پشتیبانی شده

جداول زیر انواع سنسورهای پشتیبانی شده و قابلیت های مرتبط با آنها را فهرست می کند.

کیفیت هوا

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

AirQuality

مقادیر پشتیبانی شده:

healthy
moderate
unhealthy
unhealthy for sensitive groups
very unhealthy
hazardous
good
fair
poor
very poor
severe
unknown

مقادیر پشتیبانی شده:

AQI

مونوکسید کربن

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

CarbonMonoxideLevel

مقادیر پشتیبانی شده:

carbon monoxide detected
high
no carbon monoxide detected
unknown

مقادیر پشتیبانی شده:

PARTS_PER_MILLION

سطح دود

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

SmokeLevel

مقادیر پشتیبانی شده:

smoke detected
high
no smoke detected
unknown

مقادیر پشتیبانی شده:

PARTS_PER_MILLION

تمیزی فیلتر

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

FilterCleanliness

مقادیر پشتیبانی شده:

clean
dirty
needs replacement
unknown
پشتیبانی نمی شود.

نشت آب

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

WaterLeak

مقادیر پشتیبانی شده:

leak
no leak
unknown
پشتیبانی نمی شود.

تشخیص باران

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

RainDetection

مقادیر پشتیبانی شده:

rain detected
no rain detected
unknown
پشتیبانی نمی شود.

طول عمر فیلتر

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

FilterLifeTime

مقادیر پشتیبانی شده:

new
good
replace soon
replace now
unknown

مقادیر پشتیبانی شده:

PERCENTAGE

طول عمر فیلتر محاسبه شده

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

PreFilterLifeTime
HEPAFilterLifeTime
Max2FilterLifeTime
پشتیبانی نمی شود.

مقادیر پشتیبانی شده:

PERCENTAGE

سطح دی اکسید کربن

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

CarbonDioxideLevel
پشتیبانی نمی شود.

مقادیر پشتیبانی شده:

PARTS_PER_MILLION

ذرات معلق

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

PM2.5
PM10
پشتیبانی نمی شود.

مقادیر پشتیبانی شده:

MICROGRAMS_PER_CUBIC_METER

ترکیبات آلی فرار

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

VolatileOrganicCompounds
پشتیبانی نمی شود.

مقادیر پشتیبانی شده:

PARTS_PER_MILLION

وضعیت دستگاه

موجودیت های دارای این ویژگی ممکن است وضعیت های زیر را به عنوان بخشی از عملیات QUERY گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت مقاصد QUERY ، به تحقق هدف مراجعه کنید.

ایالات تایپ کنید توضیحات
currentSensorStateData آرایه

مورد نیاز.

فهرست حالات حسگر فعلی

[ item, ... ] شیء

وضعیت سنسور فعلی

name رشته

مورد نیاز.

نام وضعیت سنسور با یک مقدار از sensorStatesSupported مطابقت دارد.

currentSensorState رشته

مقدار وضعیت توصیفی فعلی با یک مقدار از sensorStatesSupported مطابقت دارد.

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"
  }
}

خطاهای دستگاه

لیست کامل خطاها و استثناها را ببینید.