สคีมา Trait ของ SensorState สำหรับสมาร์ทโฮม

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

ATTRIBUTES ของอุปกรณ์

อุปกรณ์ที่มีลักษณะเช่นนี้อาจรายงานแอตทริบิวต์ต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ SYNC ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent SYNC ได้ที่Fulfillment 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 ได้ที่Fulfillment 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"
  }
}

ข้อผิดพลาดเกี่ยวกับอุปกรณ์

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