สคีมาฟีเจอร์ SmartHome SensorState

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

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

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

Attributes	ประเภท	คำอธิบาย
sensorStatesSupported	อาร์เรย์	ต้องระบุ วัตถุแต่ละอย่างแสดงถึงความสามารถของสถานะเซ็นเซอร์ที่อุปกรณ์เครื่องนี้รองรับ เซ็นเซอร์แต่ละตัวต้องมีคําอธิบายหรือตัวเลขอย่างน้อย เซ็นเซอร์ยังสามารถรายงานทั้ง 2 กรณีได้ ในกรณีที่แนะนําให้ใช้ค่าตัวเลข
[item, ...]	ออบเจ็กต์	ความสามารถของเซ็นเซอร์ที่รองรับ ต้องมีอย่างน้อย 1 รายการ
name	String	ต้องระบุ ประเภทเซ็นเซอร์ที่รองรับ ดูตารางเซ็นเซอร์ที่รองรับ
descriptiveCapabilities	ออบเจ็กต์	คําอธิบายความสามารถของเซ็นเซอร์
availableStates	อาร์เรย์	ต้องระบุ รายการสถานะที่มีสําหรับอุปกรณ์นี้ สถานะ "ไม่ทราบ" จะได้รับการสนับสนุนโดยนัยเมื่อเซ็นเซอร์ไม่ส่งคืนค่า
[item, ...]	String	ค่าสถานะที่สื่อความหมายที่รองรับ ต้องมีอย่างน้อย 1 รายการ
numericCapabilities	ออบเจ็กต์	อธิบายค่าตัวเลขที่เป็นไปได้ที่เซ็นเซอร์จะรายงานได้
rawValueUnit	String	ต้องระบุ หน่วยตัวเลขที่รองรับ

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

ตัวอย่าง

อุปกรณ์เซ็นเซอร์ที่รายงานค่าสถานะโดยละเอียด

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

อุปกรณ์ STATES

เอนทิตีที่มีลักษณะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ QUERY หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ QUERY โปรดดูการดําเนินการ Intent

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

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

ตัวอย่าง

อุปกรณ์เซ็นเซอร์ที่รายงานค่าสถานะโดยละเอียด

{
  "currentSensorStateData": [
    {
      "name": "AirQuality",
      "currentSensorState": "healthy"
    }
  ]
}

อุปกรณ์เซ็นเซอร์ที่รายงานค่าสถานะเป็นตัวเลข

{
  "currentSensorStateData": [
    {
      "name": "CarbonMonoxideLevel",
      "rawValue": 200
    }
  ]
}

อุปกรณ์เซ็นเซอร์ที่รายงานค่าสถานะเป็นตัวเลขและข้อความอธิบาย

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200
    }
  ]
}

อุปกรณ์ COMMANDS

ไม่ต้องแจ้งเตือนเลย

การแจ้งเตือนของอุปกรณ์

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

ช่อง	ประเภท	คำอธิบาย
SensorState	ออบเจ็กต์	ต้องระบุ เปย์โหลดการแจ้งเตือน
priority	จำนวนเต็ม	ต้องระบุ แสดงระดับการแจ้งเตือน ค่าที่รองรับปัจจุบันคือ 0 ซึ่งบ่งบอกว่าควรมีการอ่านออกเสียงการแจ้งเตือนนั้น
name	String	ต้องระบุ ชื่อสถานะเซ็นเซอร์ ดูรายการประเภทเซ็นเซอร์ที่รองรับสําหรับการแจ้งเตือน
currentSensorState	String	ต้องระบุ ค่าสถานะที่สื่อความหมายในปัจจุบัน ดูรายการประเภทเซ็นเซอร์ที่รองรับสําหรับการแจ้งเตือน

เพย์โหลดการแจ้งเตือนอาจมีเซ็นเซอร์ประเภทต่อไปนี้

• AirQuality
• CarbonMonoxideLevel
• SmokeLevel
• FilterCleanliness
• WaterLeak
• RainDetection
• FilterLifeTime

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

ตัวอย่าง

ตรวจพบควัน

{
  "SensorState": {
    "priority": 0,
    "name": "SmokeLevel",
    "currentSensorState": "high"
  }
}

อุปกรณ์ ERRORS

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