สคีมาลักษณะของ Smart Home 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

สถานะของอุปกรณ์

เอนทิตีที่มีลักษณะนี้อาจรายงานสิ่งต่อไปนี้ สถานะเป็นส่วนหนึ่งของการดำเนินการ 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
    }
  ]
}

คำสั่งอุปกรณ์

ไม่มี

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

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

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

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

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

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

ตัวอย่าง

ตรวจพบควัน

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

ข้อผิดพลาดของอุปกรณ์

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