Leitfaden für Smart-Home-Rauchmelder
action.devices.types.SMOKE_DETECTOR: Rauchmelder können melden, ob Rauch erkannt wurde, ob die Rauchkonzentration hoch ist und wie hoch die aktuelle Rauchkonzentration in ppm ist.
Dieser Typ gibt an, dass das Gerät das Symbol für Rauchmelder und einige zugehörige Synonyme und Aliase erhält.
Gerätefunktionen
In der entsprechenden Trait-Dokumentation finden Sie Implementierungsdetails wie Attribute und Status, die Ihr Dienst unterstützen sollte, und Informationen zum Erstellen von EXECUTE- und QUERY-Antworten.
Erforderliche Merkmale
Diese Merkmale und Befehle sind erforderlich, sofern sie für Ihr Gerät zutreffen. Wenn dein Gerät diese Merkmale nicht unterstützt, gib den Fehlercode functionNotSupported in einer QUERY- oder EXECUTE-Antwort ein. Weitere Informationen finden Sie unter Fehler und Ausnahmen.
Beispielgerät: Einfacher Rauchmelder
Dieser Abschnitt enthält Beispiel-Intent-Nutzlasten für einen gängigen „Rauchmelder“ basierend auf dem Gerätetyp und den oben genannten Attributen. Wenn Sie Ihrer Implementierung Attribute hinzufügen oder daraus entfernen, müssen Sie Ihre Antworten entsprechend anpassen.
Beispiel für eine SYNC-Antwort
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.SMOKE_DETECTOR", "traits": [ "action.devices.traits.SensorState" ], "name": { "name": "Simple smoke detector" }, "willReportState": true, "attributes": { "sensorStatesSupported": [ { "name": "SmokeLevel", "descriptiveCapabilities": { "availableStates": [ "smoke detected", "high", "no smoke 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": "SmokeLevel", "currentSensorState": "high", "rawValue": 200 } ] } } } }