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

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

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

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

แอตทริบิวต์	Type	คำอธิบาย
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

อุปกรณ์ STATES

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

รัฐ	Type	คำอธิบาย
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
    }
  ]
}

อุปกรณ์ COMMANDS

ไม่มี

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

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

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

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

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

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

ตัวอย่าง

ตรวจพบควัน

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

อุปกรณ์ ERRORS

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