คู่มือเซ็นเซอร์สมาร์ทโฮม
action.devices.types.SENSOR
- เซ็นเซอร์เดียวสามารถทำหน้าที่ได้หลายอย่าง เช่น ตรวจสอบทั้งอุณหภูมิและความชื้น เซ็นเซอร์อาจรายงานข้อมูลเชิงปริมาณอย่างใดอย่างหนึ่งหรือทั้ง 2 อย่าง เช่น ระดับคาร์บอนมอนอกไซด์และควันซึ่งวัดเป็นหน่วยส่วนในล้านส่วน และการวัดเชิงคุณภาพ (เช่น คุณภาพอากาศอยู่ในระดับดีต่อสุขภาพหรือไม่ดีต่อสุขภาพ)
ประเภทนี้ระบุว่าอุปกรณ์ได้รับไอคอนเซ็นเซอร์ รวมถึงคำพ้องความหมายและอีเมลแทนที่เกี่ยวข้อง
ความสามารถของอุปกรณ์
โปรดดูรายละเอียดการใช้งานในเอกสารประกอบของลักษณะที่เกี่ยวข้อง เช่น แอตทริบิวต์และสถานะที่บริการควรรองรับ และวิธีสร้างการตอบกลับ EXECUTE และ QUERY
ลักษณะที่แนะนำ
เราขอแนะนำให้ใช้ลักษณะเหล่านี้หากอุปกรณ์ของคุณมี อย่างไรก็ตาม คุณผสมและจับคู่จากลักษณะทั้งหมดที่มีอยู่เพื่อให้ตรงกับฟังก์ชันการทำงานของผลิตภัณฑ์ที่มีอยู่มากที่สุดได้
เซ็นเซอร์อาจใช้ลักษณะอื่นๆ ที่ครอบคลุมข้อมูลที่รายงานได้ เช่น
ข้อกำหนดด้านคุณภาพ
- เวลาในการตอบสนอง: ต้องน้อยกว่าหรือเท่ากับ 1000 มิลลิวินาที
- ความน่าเชื่อถือ: ต้องมากกว่าหรือเท่ากับ 97%
ตัวอย่างอุปกรณ์: เซ็นเซอร์แบบง่าย
ส่วนนี้มีตัวอย่างเพย์โหลด Intent ที่แสดง "เซ็นเซอร์" ทั่วไป โดยอิงตามประเภทอุปกรณ์และลักษณะข้างต้น หากคุณเพิ่มหรือนําลักษณะในการนําไปใช้ออก ให้แก้ไขคําตอบให้สอดคล้องกับการเปลี่ยนแปลงเหล่านั้น
ตัวอย่างการตอบกลับ SYNC
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.SENSOR", "traits": [ "action.devices.traits.EnergyStorage", "action.devices.traits.OccupancySensing", "action.devices.traits.SensorState" ], "name": { "name": "Simple sensor" }, "willReportState": true, "attributes": { "sensorStatesSupported": [ { "name": "AirQuality", "descriptiveCapabilities": { "availableStates": [ "healthy", "moderate", "unhealthy", "very unhealthy" ] } } ], "queryOnlyEnergyStorage": true, "occupancySensorConfiguration": [ { "occupancySensorType": "PIR", "occupiedToUnoccupiedDelaySec": 10, "unoccupiedToOccupiedDelaySec": 10, "unoccupiedToOccupiedEventThreshold": 2 } ] }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
ตัวอย่างการตอบกลับ QUERY
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "currentSensorStateData": [ { "name": "AirQuality", "currentSensorState": "healthy" } ], "descriptiveCapacityRemaining": "HIGH", "capacityRemaining": [ { "unit": "PERCENTAGE", "rawValue": 90 } ], "occupancy": "OCCUPIED" } } } }