Smart-Home-Kühlschränke
action.devices.types.REFRIGERATOR – Kühlschränke sind Geräte zur Temperaturverwaltung und können verschiedene Modi/Einstellungen haben.
Dieser Typ gibt an, dass das Gerät das Kühlschranksymbol und einige verwandte Synonyme und Aliasse erhält.
Gerätefunktionen
Informationen zur Implementierung finden Sie in der entsprechenden Trait-Dokumentation, z. B. zu Attributen und Statusangaben, die Ihr Dienst unterstützen sollte, und zum Erstellen von EXECUTE- und QUERY-Antworten.
Erforderliche Merkmale
Diese Merkmale und Befehle sind bei Bedarf für Ihr Gerät erforderlich. Wenn dein Gerät diese Traits nicht unterstützt, gib 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 3.000 ms sein.
- Zuverlässigkeit: muss größer oder gleich 97% sein.
Beispielgerät: einfacher Kühlschrank
Dieser Abschnitt enthält Beispielnutzlasten für Intents, die einen gemeinsamen „Kühlschrank“ basierend auf dem oben genannten Gerätetyp und den obigen Eigenschaften darstellen. Wenn Sie in Ihrer Implementierung Traits hinzufügen oder entfernen, passen Sie Ihre Antworten entsprechend an.
Beispiel für SYNC-Antwort
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}
{
"requestId": "6894439706274654512",
"payload": {
"agentUserId": "user123",
"devices": [
{
"id": "123",
"type": "action.devices.types.REFRIGERATOR",
"traits": [
"action.devices.traits.TemperatureControl"
],
"name": {
"name": "Simple refrigerator"
},
"willReportState": true,
"attributes": {
"temperatureRange": {
"minThresholdCelsius": 0,
"maxThresholdCelsius": 10
},
"temperatureUnitForUX": "C"
},
"deviceInfo": {
"manufacturer": "smart-home-inc",
"model": "hs1234",
"hwVersion": "3.2",
"swVersion": "11.4"
}
}
]
}
}
Beispiel für QUERY-Antwort
{
"requestId": "6894439706274654514",
"inputs": [
{
"intent": "action.devices.QUERY",
"payload": {
"devices": [
{
"id": "123"
}
]
}
}
]
}
{
"requestId": "6894439706274654514",
"payload": {
"devices": {
"123": {
"status": "SUCCESS",
"online": true,
"temperatureSetpointCelsius": 5,
"temperatureAmbientCelsius": 7
}
}
}
}
Beispiele für EXECUTE-Befehle
SetTemperature
Weitere Informationen zu den Befehlsparametern finden Sie in der Referenz zu
action.devices.traits.TemperatureControl.
{
"requestId": "6894439706274654516",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.SetTemperature",
"params": {
"temperature": 4
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"temperatureSetpointCelsius": 4,
"temperatureAmbientCelsius": 7
}
}
]
}
}