สคีมาลักษณะ 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

ค่าเซ็นเซอร์ที่เป็นตัวเลขปัจจุบัน
alarmState String

สถานะการแจ้งเตือนที่สอดคล้องกับค่าที่อ่านได้จากเซ็นเซอร์ปัจจุบัน ระบบอาจส่งเสียงก่อนปลุกหรือปลุกเมื่อค่าที่อ่านได้จากเซ็นเซอร์เข้าใกล้และถึงระดับที่เป็นอันตราย

ค่าที่รองรับ

IDLE
สัญญาณเตือนไม่ทำงาน ระดับที่ตรวจพบไม่เป็นอันตราย
PRE_ALARM_1
ระดับที่ตรวจพบสูงขึ้นแต่ยังไม่ถึงระดับฉุกเฉิน ระดับดังกล่าวอาจกลายเป็นอันตรายในไม่ช้า
PRE_ALARM_2
หากอุปกรณ์รองรับการแจ้งเตือนหลายรายการก่อนที่จะถึงระดับฉุกเฉิน แสดงว่าระดับการตรวจจับสูงกว่า PRE_ALARM_1 ระดับจะเพิ่มขึ้นอย่างต่อเนื่องและอาจถึงระดับฉุกเฉินในไม่ช้า
ALARM
ระดับที่ตรวจพบถึงระดับฉุกเฉินและระบบได้ส่งเสียงสัญญาณเตือน
alarmSilenceState String

บ่งบอกสถานะการปิดเสียงสำหรับสัญญาณเตือนของเซ็นเซอร์ รวมถึงระบุว่าปัจจุบันระบบอนุญาตให้ปิดเสียงสัญญาณเตือนที่ทำงานอยู่หรือไม่ ระบบอาจระบุสถานะนี้เมื่อสถานะก่อนสัญญาณเตือนหรือสถานะสัญญาณเตือนทำงานอยู่

ค่าที่รองรับ

ALLOWED
ไม่ได้ปิดเสียงนาฬิกาปลุกและระบบอนุญาตให้ปิดเสียงนาฬิกาปลุกในขณะนี้
DISALLOWED
ระบบจะไม่ปิดเสียงนาฬิกาปลุกและยังไม่อนุญาตให้ปิดเสียงนาฬิกาปลุกในขณะนี้
SILENCED
ปิดเสียงปลุกแล้ว

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

ตัวอย่าง

อุปกรณ์เซ็นเซอร์ที่รายงานค่าสถานะแบบอธิบาย

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

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

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

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

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

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

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200,
      "alarmState": "ALARM",
      "alarmSilenceState": "DISALLOWED"
    }
  ]
}

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

ไม่มี

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

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

ช่อง ประเภท คำอธิบาย
SensorState ออบเจ็กต์

ต้องระบุ

เพย์โหลดการแจ้งเตือน
priority จำนวนเต็ม

ต้องระบุ

แสดงถึงระดับการแจ้งเตือน ค่าที่รองรับในปัจจุบันคือ 0 ซึ่งระบุว่าควรอ่านออกเสียงการแจ้งเตือน
name String

ต้องระบุ

ชื่อสถานะเซ็นเซอร์ ดูรายการประเภทเซ็นเซอร์ที่รองรับสำหรับการแจ้งเตือน
currentSensorState String

ต้องระบุ

ค่าสถานะอธิบายปัจจุบัน ดูรายการประเภทเซ็นเซอร์ที่รองรับสำหรับการแจ้งเตือน

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

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

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

ตัวอย่าง

ตรวจพบควัน

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

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

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