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

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

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

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