สคีมาของฟีเจอร์ Home Home SensorState

action.devices.traits.SensorState - ลักษณะเฉพาะนี้ครอบคลุมทั้งการวัดผลเชิงปริมาณและสถานะเชิงคุณภาพ

แอตทริบิวต์อุปกรณ์

อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ SYNC ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC ได้ที่การดําเนินการตามความตั้งใจ

แอตทริบิวต์	ประเภท	คำอธิบาย
sensorStatesSupported	อาร์เรย์	ต้องระบุ ออบเจ็กต์แต่ละรายการแสดงถึงความสามารถของสถานะเซ็นเซอร์ที่อุปกรณ์เครื่องนี้รองรับ เซ็นเซอร์แต่ละตัวต้องมีฟังก์ชันที่สื่อความหมายหรือตัวเลขเป็นอย่างน้อย เซ็นเซอร์ยังสามารถรายงานทั้ง 2 กรณีนี้ได้ด้วย ซึ่งอาจเป็นค่าตัวเลข
[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 ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ QUERY ได้ที่การดําเนินการตามความตั้งใจ

รัฐ	ประเภท	คำอธิบาย
currentSensorStateData	อาร์เรย์	ต้องระบุ รายการสถานะเซ็นเซอร์ปัจจุบัน
[item, ...]	วัตถุ	สถานะเซ็นเซอร์ปัจจุบัน
name	สตริง	ต้องระบุ ชื่อสถานะเซ็นเซอร์ จับคู่ค่าจาก sensorStatesSupported
currentSensorState	สตริง	ค่าสถานะที่สื่อความหมายในปัจจุบัน จับคู่ค่าจาก sensorStatesSupported
rawValue	Number	ค่าเซ็นเซอร์ตัวเลขปัจจุบัน

ดูเซ็นเซอร์ที่รองรับเพื่อดูรายละเอียดเพิ่มเติมเกี่ยวกับความสามารถและประเภทเซ็นเซอร์ต่างๆ ที่ฟีเจอร์นี้รองรับ

ตัวอย่าง

อุปกรณ์เซ็นเซอร์ที่รายงานค่าสถานะที่สื่อความหมาย

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

อุปกรณ์ ERRORS

ดูรายการข้อผิดพลาดและข้อยกเว้นทั้งหมด