Kohlenmonoxidmelder-Leitfaden für Smart Homes
action.devices.types.CARBON_MONOXIDE_DETECTOR
– Kohlenmonoxidmelder melden, ob aktuell Kohlenmonoxid festgestellt wurde, ob der Kohlenmonoxidwert hoch ist und ob der aktuelle Kohlenmonoxidgehalt in Teilen pro Million angegeben wird.
Dieser Typ zeigt an, dass auf dem Gerät das Kohlenmonoxidmelder-Symbol und einige zugehörige Synonyme und Aliasse angezeigt werden.
Gerätefunktionen
In der zugehörigen Dokumentation zur Eigenschaft finden Sie Implementierungsdetails wie Attribute und Status, die Ihr Dienst unterstützen sollte, und zum Erstellen von EXECUTE- und QUERY-Antworten.
Erforderliche Eigenschaften
Diese Eigenschaften und Befehle sind erforderlich, falls sie auf Ihr Gerät zutreffen. Wenn Ihr Gerät diese Eigenschaften nicht unterstützt, geben Sie den Fehlercode functionNotSupported
in einer QUERY- oder EXECUTE-Antwort ein. Weitere Informationen finden Sie unter Fehler und Ausnahmen.
Qualitätsanforderungen
- Latenz: muss kleiner oder gleich 1.000 ms sein.
- Zuverlässigkeit:muss größer oder gleich 97% sein
Beispielgerät: Einfacher Kohlenmonoxidmelder
Dieser Abschnitt enthält beispielhafte Intent-Nutzlasten, die einen gemeinsamen „Kohlenmonoxidmelder“ auf Basis des Gerätetyps und der oben genannten Merkmale darstellen. Wenn du bei der Implementierung Eigenschaften hinzufügst oder entfernst, ändere deine Antworten entsprechend.
SYNC-Beispielantwort
{ "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" } } ] } }
Beispiel für eine QUERY-Antwort
{ "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 } ] } } } }