สคีมาของฟีเจอร์ Home Home SensorState
action.devices.traits.SensorState
- ลักษณะเฉพาะนี้ครอบคลุมทั้งการวัดผลเชิงปริมาณและสถานะเชิงคุณภาพ
แอตทริบิวต์อุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ SYNC
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC
ได้ที่การดําเนินการตามความตั้งใจ
แอตทริบิวต์ | ประเภท | คำอธิบาย |
---|---|---|
sensorStatesSupported |
อาร์เรย์ |
ต้องระบุ ออบเจ็กต์แต่ละรายการแสดงถึงความสามารถของสถานะเซ็นเซอร์ที่อุปกรณ์เครื่องนี้รองรับ เซ็นเซอร์แต่ละตัวต้องมีฟังก์ชันที่สื่อความหมายหรือตัวเลขเป็นอย่างน้อย เซ็นเซอร์ยังสามารถรายงานทั้ง 2 กรณีนี้ได้ด้วย ซึ่งอาจเป็นค่าตัวเลข |
[item, ...] |
วัตถุ |
ความสามารถของเซ็นเซอร์ที่รองรับ ต้องมีอย่างน้อย 1 รายการ |
name |
สตริง |
ต้องระบุ ประเภทเซ็นเซอร์ที่รองรับ ดูตารางเซ็นเซอร์ที่รองรับ |
descriptiveCapabilities |
วัตถุ |
คําอธิบายความสามารถของเซ็นเซอร์ |
availableStates |
อาร์เรย์ |
ต้องระบุ รายการสถานะที่พร้อมใช้งานสําหรับอุปกรณ์ สถานะ "ไม่ทราบ" จะรองรับโดยปริยายเมื่อเซ็นเซอร์ไม่แสดงผลค่า |
[item, ...] |
สตริง |
ค่าสถานะที่สื่อความหมายที่รองรับ ต้องมีอย่างน้อย 1 รายการ |
numericCapabilities |
วัตถุ |
อธิบายค่าตัวเลขที่เป็นไปได้ที่เซ็นเซอร์รายงานได้ |
rawValueUnit |
สตริง |
ต้องระบุ หน่วยตัวเลขที่รองรับ |
ดูเซ็นเซอร์ที่รองรับเพื่อดูรายละเอียดเพิ่มเติมเกี่ยวกับความสามารถและประเภทเซ็นเซอร์ต่างๆ ที่ฟีเจอร์นี้รองรับ
ตัวอย่าง
อุปกรณ์เซ็นเซอร์ที่รายงานค่าสถานะที่สื่อความหมาย
{ "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
ได้ที่การดําเนินการตามความตั้งใจ
รัฐ | ประเภท | คำอธิบาย |
---|---|---|
currentSensorStateData |
อาร์เรย์ |
ต้องระบุ รายการสถานะเซ็นเซอร์ปัจจุบัน |
[item, ...] |
วัตถุ |
สถานะเซ็นเซอร์ปัจจุบัน |
name |
สตริง |
ต้องระบุ ชื่อสถานะเซ็นเซอร์ จับคู่ค่าจาก |
currentSensorState |
สตริง |
ค่าสถานะที่สื่อความหมายในปัจจุบัน จับคู่ค่าจาก |
rawValue |
Number |
ค่าเซ็นเซอร์ตัวเลขปัจจุบัน |
ดูเซ็นเซอร์ที่รองรับเพื่อดูรายละเอียดเพิ่มเติมเกี่ยวกับความสามารถและประเภทเซ็นเซอร์ต่างๆ ที่ฟีเจอร์นี้รองรับ
ตัวอย่าง
อุปกรณ์เซ็นเซอร์ที่รายงานค่าสถานะที่สื่อความหมาย
{ "currentSensorStateData": [ { "name": "AirQuality", "currentSensorState": "healthy" } ] }
อุปกรณ์เซ็นเซอร์ที่รายงานค่าสถานะที่เป็นตัวเลข
{ "currentSensorStateData": [ { "name": "CarbonMonoxideLevel", "rawValue": 200 } ] }
อุปกรณ์เซ็นเซอร์ที่รายงานค่าสถานะที่สื่อความหมายและเป็นตัวเลข
{ "currentSensorStateData": [ { "name": "SmokeLevel", "currentSensorState": "smoke detected", "rawValue": 200 } ] }
คําสั่งของอุปกรณ์
ไม่มี
การแจ้งเตือนของอุปกรณ์
อุปกรณ์ที่มีลักษณะนี้อาจแสดงเพย์โหลดการแจ้งเตือนต่อไปนี้เป็นส่วนหนึ่งของการเปลี่ยนแปลงสถานะอุปกรณ์ ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้งานการแจ้งเตือนได้ที่การแจ้งเตือนสําหรับการดําเนินการในบ้านอัจฉริยะ
ช่อง | ประเภท | คำอธิบาย |
---|---|---|
SensorState |
วัตถุ |
ต้องระบุ เพย์โหลดการแจ้งเตือน |
priority |
จำนวนเต็ม |
ต้องระบุ แสดงถึงระดับการแจ้งเตือน ค่าที่รองรับปัจจุบันคือ 0 ซึ่งบ่งชี้ว่าควรพูดการแจ้งเตือนดังกล่าว |
name |
สตริง |
ต้องระบุ ชื่อสถานะเซ็นเซอร์ ดูรายการประเภทเซ็นเซอร์ที่รองรับสําหรับการแจ้งเตือน |
currentSensorState |
สตริง |
ต้องระบุ ค่าสถานะที่สื่อความหมายในปัจจุบัน ดูรายการประเภทเซ็นเซอร์ที่รองรับสําหรับการแจ้งเตือน |
เพย์โหลดการแจ้งเตือนอาจมีประเภทเซ็นเซอร์ต่อไปนี้
AirQuality
CarbonMonoxideLevel
SmokeLevel
FilterCleanliness
WaterLeak
RainDetection
FilterLifeTime
ดูรายละเอียดเพิ่มเติมเกี่ยวกับความสามารถต่างๆ ที่เซ็นเซอร์แต่ละประเภทรองรับได้ในเซ็นเซอร์ที่รองรับ
ตัวอย่าง
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }