คู่มือเซ็นเซอร์บ้านอัจฉริยะ
action.devices.types.SENSOR
- เซ็นเซอร์เดียวจะทําหน้าที่เป็นฟังก์ชันได้หลายอย่าง เช่น การตรวจสอบทั้งอุณหภูมิและความชื้น หรืออุณหภูมิและอัตราการเข้าพัก เซ็นเซอร์อาจรายงานเชิงปริมาณหรือเชิงปริมาณ เช่น ระดับคาร์บอนมอนอกไซด์และควันที่วัดได้ที่ส่วนต่อล้าน และการวัดเชิงคุณภาพ เช่น คุณภาพอากาศดีหรือไม่ดี
ประเภทนี้บ่งชี้ว่าอุปกรณ์จะได้รับไอคอนเซ็นเซอร์ รวมถึงคําพ้องความหมายและชื่อแทนที่เกี่ยวข้องบางส่วน
ความสามารถของอุปกรณ์
โปรดดูเอกสารประกอบที่เกี่ยวข้องสําหรับรายละเอียดการใช้งาน เช่น แอตทริบิวต์และสถานะที่บริการของคุณควรมี และวิธีการสร้างการตอบกลับและคําขอ EXECUTE
ลักษณะเฉพาะที่แนะนํา
เราขอแนะนําให้มีคุณสมบัติเหล่านี้ (หากใช้ร่วมกับอุปกรณ์ของคุณ) อย่างไรก็ตาม คุณสามารถผสมผสานคุณลักษณะที่มีอยู่ทั้งหมดได้เพื่อจับคู่กับฟังก์ชันการทํางานของผลิตภัณฑ์ที่มีอยู่
-
action.devices.traits.SensorState
-
action.devices.traits.EnergyStorage
-
action.devices.traits.OccupancySensing
เซ็นเซอร์อาจใช้ลักษณะอื่นๆ ที่ครอบคลุมข้อมูลที่รายงานได้ เช่น
ข้อกำหนดด้านคุณภาพ
- เวลาในการตอบสนอง: ต้องมีค่าน้อยกว่าหรือเท่ากับ 1000ms
- ความเสถียร: ต้องมากกว่าหรือเท่ากับ 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.SensorState" ], "name": { "name": "Simple sensor" }, "willReportState": true, "attributes": { "sensorStatesSupported": [ { "name": "AirQuality", "descriptiveCapabilities": { "availableStates": [ "healthy", "moderate", "unhealthy", "very unhealthy" ] } } ], "queryOnlyEnergyStorage": true }, "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 } ] } } } }