สคีมาฟีเจอร์ 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

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