สคีมาลักษณะ 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"
]
}
}
]
}เซ็นเซอร์ที่รองรับ
ตารางต่อไปนี้แสดงประเภทเซ็นเซอร์ที่รองรับและความสามารถที่เกี่ยวข้อง
คุณภาพอากาศ
| ชื่อ | ความสามารถในการอธิบาย | ความสามารถด้านตัวเลข |
|---|---|---|
ค่าที่รองรับมีดังนี้
|
ค่าที่รองรับมีดังนี้
|
ค่าที่รองรับมีดังนี้
|
คาร์บอนมอนอกไซด์
| ชื่อ | ความสามารถในการอธิบาย | ความสามารถด้านตัวเลข |
|---|---|---|
ค่าที่รองรับมีดังนี้
|
ค่าที่รองรับมีดังนี้
|
ค่าที่รองรับมีดังนี้
|
ระดับควัน
| ชื่อ | ความสามารถในการอธิบาย | ความสามารถด้านตัวเลข |
|---|---|---|
ค่าที่รองรับมีดังนี้
|
ค่าที่รองรับมีดังนี้
|
ค่าที่รองรับมีดังนี้
|
ความสะอาดของไส้กรอง
| ชื่อ | ความสามารถในการอธิบาย | ความสามารถด้านตัวเลข |
|---|---|---|
ค่าที่รองรับมีดังนี้
|
ค่าที่รองรับมีดังนี้
|
ไม่รองรับ |
น้ำรั่ว
| ชื่อ | ความสามารถในการอธิบาย | ความสามารถด้านตัวเลข |
|---|---|---|
ค่าที่รองรับมีดังนี้
|
ค่าที่รองรับมีดังนี้
|
ไม่รองรับ |
การตรวจจับฝน
| ชื่อ | ความสามารถในการอธิบาย | ความสามารถด้านตัวเลข |
|---|---|---|
ค่าที่รองรับมีดังนี้
|
ค่าที่รองรับมีดังนี้
|
ไม่รองรับ |
อายุการใช้งานของไส้กรอง
| ชื่อ | ความสามารถในการอธิบาย | ความสามารถด้านตัวเลข |
|---|---|---|
ค่าที่รองรับมีดังนี้
|
ค่าที่รองรับมีดังนี้
|
ค่าที่รองรับมีดังนี้
|
อายุการใช้งานของแผ่นกรองที่คำนวณแล้ว
| ชื่อ | ความสามารถในการอธิบาย | ความสามารถด้านตัวเลข |
|---|---|---|
ค่าที่รองรับมีดังนี้
|
ไม่รองรับ | ค่าที่รองรับมีดังนี้
|
ระดับคาร์บอนไดออกไซด์
| ชื่อ | ความสามารถในการอธิบาย | ความสามารถด้านตัวเลข |
|---|---|---|
ค่าที่รองรับมีดังนี้
|
ไม่รองรับ | ค่าที่รองรับมีดังนี้
|
ฝุ่นละออง
| ชื่อ | ความสามารถในการอธิบาย | ความสามารถด้านตัวเลข |
|---|---|---|
ค่าที่รองรับมีดังนี้
|
ไม่รองรับ | ค่าที่รองรับมีดังนี้
|
สารประกอบอินทรีย์ระเหยง่าย
| ชื่อ | ความสามารถในการอธิบาย | ความสามารถด้านตัวเลข |
|---|---|---|
ค่าที่รองรับมีดังนี้
|
ไม่รองรับ | ค่าที่รองรับมีดังนี้
|
สถานะของอุปกรณ์
เอนทิตีที่มีลักษณะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดำเนินการ QUERY ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent QUERY ได้ที่การดำเนินการตาม Intent
| รัฐ | ประเภท | คำอธิบาย |
|---|---|---|
currentSensorStateData |
อาร์เรย์ |
ต้องระบุ รายการสถานะเซ็นเซอร์ปัจจุบัน |
[item, ...] |
ออบเจ็กต์ |
สถานะเซ็นเซอร์ปัจจุบัน |
name |
String |
ต้องระบุ ชื่อสถานะเซ็นเซอร์ จับคู่ค่าจาก |
currentSensorState |
String |
ค่าสถานะอธิบายปัจจุบัน จับคู่ค่าจาก |
rawValue |
Number |
ค่าเซ็นเซอร์ที่เป็นตัวเลขปัจจุบัน |
alarmState |
String |
สถานะการแจ้งเตือนที่สอดคล้องกับค่าที่อ่านได้จากเซ็นเซอร์ปัจจุบัน ระบบอาจส่งเสียงก่อนปลุกหรือปลุกเมื่อค่าที่อ่านได้จากเซ็นเซอร์เข้าใกล้และถึงระดับที่เป็นอันตราย ค่าที่รองรับมีดังนี้
|
alarmSilenceState |
String |
บ่งบอกสถานะปิดเสียงสำหรับสัญญาณเตือนของเซ็นเซอร์ รวมถึงระบุว่าปัจจุบันระบบอนุญาตให้ปิดเสียงสัญญาณเตือนที่ทำงานอยู่หรือไม่ ระบบอาจระบุสถานะนี้เมื่อสถานะก่อนสัญญาณเตือนหรือสถานะสัญญาณเตือนทำงานอยู่ สำหรับตัวตรวจจับควัน ระบบจะไม่ใช้ค่า ค่าที่รองรับมีดังนี้
|
ดูรายละเอียดเพิ่มเติมเกี่ยวกับความสามารถและเซ็นเซอร์ประเภทต่างๆ ที่ฟีเจอร์นี้รองรับได้ที่เซ็นเซอร์ที่รองรับ
ตัวอย่าง
อุปกรณ์เซ็นเซอร์ที่รายงานค่าสถานะแบบอธิบาย
{
"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"
}
]
}อุปกรณ์เซ็นเซอร์ที่รายงานค่าสถานะที่เป็นคำอธิบายและตัวเลข และระบุว่าปิดเสียงปลุก
{
"currentSensorStateData": [
{
"name": "SmokeLevel",
"currentSensorState": "smoke detected",
"rawValue": 200,
"alarmState": "ALARM",
"alarmSilenceState": "SILENCED"
}
]
}คำสั่งของอุปกรณ์
ไม่มี
การแจ้งเตือนของอุปกรณ์
อุปกรณ์ที่มีลักษณะนี้อาจแสดงผลเพย์โหลดการแจ้งเตือนต่อไปนี้เป็นส่วนหนึ่งของการเปลี่ยนแปลงสถานะอุปกรณ์ ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้การแจ้งเตือนได้ที่การแจ้งเตือนสําหรับการดําเนินการในบ้านอัจฉริยะ
| ช่อง | ประเภท | คำอธิบาย |
|---|---|---|
SensorState |
ออบเจ็กต์ |
ต้องระบุ เพย์โหลดการแจ้งเตือน |
priority |
จำนวนเต็ม |
ต้องระบุ แสดงถึงระดับการแจ้งเตือน ค่าที่รองรับในปัจจุบันคือ 0 ซึ่งระบุว่าควรอ่านออกเสียงการแจ้งเตือน |
name |
String |
ต้องระบุ ชื่อสถานะเซ็นเซอร์ ดูรายการประเภทเซ็นเซอร์ที่รองรับสำหรับการแจ้งเตือน |
currentSensorState |
String |
ต้องระบุ ค่าสถานะอธิบายปัจจุบัน ดูรายการประเภทเซ็นเซอร์ที่รองรับสำหรับการแจ้งเตือน |
เพย์โหลดการแจ้งเตือนอาจมีเซ็นเซอร์ประเภทต่อไปนี้
AirQualityCarbonMonoxideLevelSmokeLevelFilterCleanlinessWaterLeakRainDetectionFilterLifeTime
ดูรายละเอียดเพิ่มเติมเกี่ยวกับความสามารถต่างๆ ที่เซ็นเซอร์แต่ละประเภทรองรับได้ที่เซ็นเซอร์ที่รองรับ
ตัวอย่าง
{
"SensorState": {
"priority": 0,
"name": "SmokeLevel",
"currentSensorState": "high"
}
}