מדריך לגלאי פחמן חד-חמצני לבית חכם
action.devices.types.CARBON_MONOXIDE_DETECTOR – גלאי פחמן חד-חמצני עשויים לדווח אם זוהה פחמן חד-חמצני, אם רמת הפחמן החד-חמצני גבוהה ומה רמת הפחמן החד-חמצני הנוכחית בחלקים למיליון.
הסוג הזה מציין שהמכשיר מקבל את הסמל של גלאי פחמן חד-חמצני וכמה מילים נרדפות וכינויים שקשורים אליו.
תכונות המכשיר
במסמכי התיעוד של התכונה המתאימה מפורטים פרטי ההטמעה, כמו מאפיינים ומצבים שהשירות שלכם צריך לתמוך בהם, והסבר על אופן יצירת תשובות של EXECUTE ו-QUERY.
מאפיינים נדרשים
התכונות והפקודות האלה נדרשות, אם הן רלוונטיות למכשיר שלכם. אם המכשיר לא תומך בתכונות האלה, צריך להזין את קוד השגיאה functionNotSupported בתגובה של QUERY או EXECUTE. מידע נוסף זמין במאמר שגיאות וחריגים.
דוגמה למכשיר: גלאי פחמן חד-חמצני פשוט
בקטע הזה מופיעות דוגמאות למטענים ייעודיים (payloads) של כוונות שמייצגים 'גלאי פחמן חד-חמצני' נפוץ, על סמך סוג המכשיר והמאפיינים שצוינו למעלה. אם מוסיפים או מסירים מאפיינים בהטמעה, צריך לשנות את התגובות בהתאם כדי לשקף את השינויים האלה.
דוגמה לתגובת סנכרון
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.CARBON_MONOXIDE_DETECTOR", "traits": [ "action.devices.traits.SensorState" ], "name": { "name": "Simple carbon monoxide detector" }, "willReportState": true, "attributes": { "sensorStatesSupported": [ { "name": "CarbonMonoxideLevel", "descriptiveCapabilities": { "availableStates": [ "carbon monoxide detected", "high", "no carbon monoxide detected" ] }, "numericCapabilities": { "rawValueUnit": "PARTS_PER_MILLION" } } ] }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
דוגמה לתשובה של שאילתה
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "currentSensorStateData": [ { "name": "CarbonMonoxideLevel", "currentSensorState": "high", "rawValue": 200 } ] } } } }