Schema della ventola
sdm.devices.traits.Fan
Questo tratto appartiene a qualsiasi dispositivo in grado di controllare la ventola.
Campi
Campo | Descrizione | Tipo di dati |
---|---|---|
timerMode |
Modalità timer attuale. | string Valori: "ON", "OFF" |
timerTimeout |
Timestamp, nel formato RFC 3339, relativo al quale la modalità timer viene disattivata. | string Esempio: "2019-05-10T03:22:54Z" |
Esempio di richiesta e risposta GET
Richiesta
GET /enterprises/project-id/devices/device-id
Risposta
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.Fan
" : {
"timerMode" : "ON",
"timerTimeout" : "2019-05-10T03:22:54Z"
}
}
}
Comandi
SetTimer
Modifica il timer della ventola.
Richiesta e risposta SetTimer
Richiesta
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.Fan.SetTimer
",
"params" : {
"timerMode" : "ON",
"duration" : "3600s"
}
}
Risposta
{}
Campi di richiesta SetTimer
Campo | Descrizione | Tipo di dati |
---|---|---|
timerMode |
La modalità per impostare il timer della ventola. | string Valori: "ON", "OFF" |
duration |
Facoltativo. Specifica la durata in secondi dell'esecuzione del timer. | string Intervallo: "1 s" su "43200s" Predefinito: "900s" |
Errori
Potrebbero essere restituiti i seguenti codici di errore in relazione a questo tratto:
Messaggio di errore | RPC | Risoluzione dei problemi |
---|---|---|
Ventola del termostato non disponibile. | FAILED_PRECONDITION |
Il termostato non ha una funzionalità di ventola. Per questo dispositivo non è possibile utilizzare i tratti e i comandi relativi ai fan. |
Consulta la documentazione sul codice di errore API per l'elenco completo dei codici di errore dell'API.