สคีมาฟีเจอร์ 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" ] } } ] }
เซ็นเซอร์ที่รองรับ
ตารางต่อไปนี้แสดงประเภทเซ็นเซอร์ที่รองรับและความสามารถที่เกี่ยวข้อง
คุณภาพอากาศ
ชื่อ | ความสามารถเชิงคําอธิบาย | ความสามารถของตัวเลข |
---|---|---|
ค่าที่รองรับ
|
ค่าที่รองรับ
|
ค่าที่รองรับ
|
คาร์บอนมอนอกไซด์
ชื่อ | ความสามารถเชิงคําอธิบาย | ความสามารถของตัวเลข |
---|---|---|
ค่าที่รองรับ
|
ค่าที่รองรับ
|
ค่าที่รองรับ
|
ระดับควัน
ชื่อ | ความสามารถเชิงคําอธิบาย | ความสามารถของตัวเลข |
---|---|---|
ค่าที่รองรับ
|
ค่าที่รองรับ
|
ค่าที่รองรับ
|
กรองความสะอาด
ชื่อ | ความสามารถเชิงคําอธิบาย | ความสามารถของตัวเลข |
---|---|---|
ค่าที่รองรับ
|
ค่าที่รองรับ
|
ไม่รองรับ |
น้ํารั่ว
ชื่อ | ความสามารถเชิงคําอธิบาย | ความสามารถของตัวเลข |
---|---|---|
ค่าที่รองรับ
|
ค่าที่รองรับ
|
ไม่รองรับ |
การตรวจจับฝน
ชื่อ | ความสามารถเชิงคําอธิบาย | ความสามารถของตัวเลข |
---|---|---|
ค่าที่รองรับ
|
ค่าที่รองรับ
|
ไม่รองรับ |
อายุการใช้งานของตัวกรอง
ชื่อ | ความสามารถเชิงคําอธิบาย | ความสามารถของตัวเลข |
---|---|---|
ค่าที่รองรับ
|
ค่าที่รองรับ
|
ค่าที่รองรับ
|
อายุการใช้งานของตัวกรองที่คํานวณแล้ว
ชื่อ | ความสามารถเชิงคําอธิบาย | ความสามารถของตัวเลข |
---|---|---|
ค่าที่รองรับ
|
ไม่รองรับ | ค่าที่รองรับ
|
ระดับคาร์บอนไดออกไซด์
ชื่อ | ความสามารถเชิงคําอธิบาย | ความสามารถของตัวเลข |
---|---|---|
ค่าที่รองรับ
|
ไม่รองรับ | ค่าที่รองรับ
|
ฝุ่นละออง
ชื่อ | ความสามารถเชิงคําอธิบาย | ความสามารถของตัวเลข |
---|---|---|
ค่าที่รองรับ
|
ไม่รองรับ | ค่าที่รองรับ
|
สารอินทรีย์ระเหยง่าย
ชื่อ | ความสามารถเชิงคําอธิบาย | ความสามารถของตัวเลข |
---|---|---|
ค่าที่รองรับ
|
ไม่รองรับ | ค่าที่รองรับ
|
อุปกรณ์ STATES
เอนทิตีที่มีลักษณะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ QUERY
หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ QUERY
โปรดดูการดําเนินการ Intent
รัฐ | ประเภท | คำอธิบาย |
---|---|---|
currentSensorStateData |
อาร์เรย์ |
ต้องระบุ รายการสถานะของเซ็นเซอร์ปัจจุบัน |
[item, ...] |
ออบเจ็กต์ |
สถานะเซ็นเซอร์ปัจจุบัน |
name |
String |
ต้องระบุ ชื่อสถานะเซ็นเซอร์ จับคู่ค่าจาก |
currentSensorState |
String |
ค่าสถานะที่สื่อความหมายในปัจจุบัน จับคู่ค่าจาก |
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" } }