Connettori
Integrazioni descritte con un file JSON, che girano sul cervello o sulla scheda in standalone.
Un connettore descrive con un file JSON una richiesta HTTP a una API e come trasformare la risposta nei campi di un widget: nessun codice. Lo stesso file lo esegue il cervello sul computer e, in standalone, un motore in C sulla scheda; i due motori danno esattamente gli stessi campi.
I connettori pronti
Usano API pubbliche (Open-Meteo) e non vogliono né chiavi né account.
| Connettore | Widget | Cosa porta |
|---|---|---|
meteo | Meteo | Adesso, minima e massima di oggi, le prossime sei ore e se piove prima di sera. |
aria_fuori | Aria fuori | Indice europeo della qualità dell'aria, PM2.5 e PM10. |
oggi_meteo | Oggi | Solo la riga del meteo della schermata Oggi. |
Configurazione
Senza configurazione valgono i predefiniti (Bologna). Per cambiare luogo, nella sezione connettori di config.json:
{ "connettori": { "meteo": { "latitudine": 45.46, "longitudine": 9.19, "localita": "Milano" }, "aria_fuori": { "attivo": false } } }"attivo": false spegne un connettore. I segreti di un connettore, se ne ha, stanno nel gestore delle chiavi come
quelli delle altre integrazioni.
Scriverne uno
La forma del file (richiesta, percorsi nel JSON, campi, liste, date, errori e attese), la validazione e i manifest sono nel riferimento sui connettori. Un connettore non ha bisogno di un manifest scritto a mano: lo si ricava dal connettore.
Sulla scheda
In standalone il connettore gira sulla scheda con Wi-Fi: le chiavi, se servono, arrivano dal portale cifrate con il
codice a 6 cifre e restano nella memoria cifrata della scheda. Solo le integrazioni che richiedono api (o scheda)
possono girare così: quelle che richiedono il computer (Discord, Chat, Linear, Batterie) no.