Schema dei fan
sdm.devices.traits.Fan
Questo tratto appartiene a qualsiasi dispositivo in grado di controllare la ventola.
Campi
Campo | Descrizione | Tipo di dati |
---|---|---|
timerMode |
La modalità attuale del timer. | string Valori: "ON", "OFF" |
timerTimeout |
Timestamp in formato RFC 3339 a cui la modalità timer diventa OFF. | string Esempio: "2019-05-10T03:22:54Z" |
Richiesta e risposta GET di esempio
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 di SetTimer
Richiesta
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.Fan.SetTimer
",
"params" : {
"timerMode" : "ON",
"duration" : "3600s"
}
}
Risposta
{}
Campi della 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: da "1s" a "43200s" Valore predefinito: "900s" |
Errori
In relazione a questo attributo, potrebbero essere restituiti i seguenti codici di errore:
Messaggio di errore | RPC | Risoluzione dei problemi |
---|---|---|
Ventola del termostato non disponibile. | FAILED_PRECONDITION |
Il termostato non ha la funzionalità di ventilazione. I comandi e le caratteristiche relativi ai fan non possono essere utilizzati per questo dispositivo. |
Consulta il riferimento ai codici di errore dell'API per un elenco completo dei codici di errore dell'API.