Guida per la macchina da caffè Smart Home

action.devices.types.COFFEE_MAKER: le interazioni con le macchine per il caffè possono includere l'accensione e lo spegnimento del dispositivo, la regolazione delle modalità di cottura e delle preimpostazioni degli alimenti, la regolazione della temperatura ottimale e la regolazione di varie impostazioni delle modalità di cottura.

Questo tipo indica che sul dispositivo viene mostrata l'icona della macchina per il caffè e alcuni sinonimi e alias correlati.

Funzionalità dispositivo

Fai riferimento alla documentazione delle caratteristiche corrispondente per i dettagli dell'implementazione, come attributi e stati che il servizio deve supportare e come creare risposte EXECUTE e QUERY.

Caratteristiche obbligatorie

Questi tratti e comandi sono obbligatori, se applicabili al tuo dispositivo. Se il tuo dispositivo non supporta queste caratteristiche, inserisci il codice di errore functionNotSupported in una risposta QUERY o EXECUTE. Per ulteriori informazioni, consulta Errori ed eccezioni.

Queste caratteristiche sono consigliate, se applicabili al tuo dispositivo. Tuttavia, puoi combinare tutte le caratteristiche disponibili per trovare la corrispondenza con le tue funzionalità esistenti del prodotto.

Requisiti di qualità

  • Latenza: il valore deve essere inferiore o uguale a 800 ms.
  • Affidabilità: deve essere superiore o uguale al 97%.

Dispositivo di esempio: macchina per il caffè semplice

Questa sezione contiene alcuni payload di esempio che rappresentano una macchina da caffè comune in base al tipo di dispositivo e alle caratteristiche precedenti. Se aggiungi o rimuovi delle caratteristiche nell'implementazione, modifica le risposte di conseguenza per riflettere tali modifiche.

Esempio di risposta SYNC

Richiedi
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
Risposta
{
  "requestId": "6894439706274654512",
  "payload": {
    "agentUserId": "user123",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.COFFEE_MAKER",
        "traits": [
          "action.devices.traits.Cook",
          "action.devices.traits.TemperatureControl",
          "action.devices.traits.OnOff"
        ],
        "name": {
          "name": "Simple coffee maker"
        },
        "willReportState": true,
        "attributes": {
          "temperatureRange": {
            "minThresholdCelsius": 0,
            "maxThresholdCelsius": 100
          },
          "temperatureUnitForUX": "F",
          "supportedCookingModes": [
            "BREW"
          ],
          "foodPresets": [
            {
              "food_preset_name": "coffee_key",
              "supported_units": [
                "NO_UNITS",
                "CUPS"
              ],
              "food_synonyms": [
                {
                  "synonym": [
                    "Coffee"
                  ],
                  "lang": "en"
                }
              ]
            }
          ]
        },
        "deviceInfo": {
          "manufacturer": "smart-home-inc",
          "model": "hs1234",
          "hwVersion": "3.2",
          "swVersion": "11.4"
        }
      }
    ]
  }
}

Esempio di risposta QUERY

Richiedi
{
  "requestId": "6894439706274654514",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123"
          }
        ]
      }
    }
  ]
}
Risposta
{
  "requestId": "6894439706274654514",
  "payload": {
    "devices": {
      "123": {
        "status": "SUCCESS",
        "online": true,
        "on": true,
        "temperatureSetpointCelsius": 70,
        "currentCookingMode": "BREW",
        "currentFoodPreset": "coffee_key",
        "currentFoodQuantity": 2,
        "currentFoodUnit": "CUPS"
      }
    }
  }
}

Comandi ESEGUI di esempio

Cucina

Per ulteriori dettagli sui parametri di comando, consulta il riferimento action.devices.traits.Cook.

Richiedi
{
  "requestId": "6894439706274654516",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.Cook",
                "params": {
                  "start": false,
                  "cookingMode": "BREW"
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Risposta
{
  "requestId": "6894439706274654516",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "currentCookingMode": "NONE",
          "currentFoodPreset": "NONE"
        }
      }
    ]
  }
}

Imposta Temperatura

Per ulteriori dettagli sui parametri di comando, consulta il riferimento action.devices.traits.TemperatureControl.

Richiedi
{
  "requestId": "6894439706274654518",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.SetTemperature",
                "params": {
                  "temperature": 85
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Risposta
{
  "requestId": "6894439706274654518",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "temperatureSetpointCelsius": 85
        }
      }
    ]
  }
}

On-Off

Per ulteriori dettagli sui parametri di comando, consulta il riferimento action.devices.traits.OnOff.

Richiedi
{
  "requestId": "6894439706274654520",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.OnOff",
                "params": {
                  "on": true
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Risposta
{
  "requestId": "6894439706274654520",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "on": true
        }
      }
    ]
  }
}

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.