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