Salta ai contenuti

Editor di espressioni

Scrivi le espressioni che guidano i livelli automatizzati, con il risultato in tempo reale e i tag di dati da usare.

Un’espressione è una breve formula che calcola un valore a partire dall’ora e dai dati. [m] * 6 fa girare un livello di 6 gradi per ogni minuto, cioè una lancetta dei minuti. [bat_w] < 20 è true finché la batteria dello smartwatch è sotto il 20%, quindi un livello con questa visibilità compare solo quando la batteria si sta scaricando.

L’editor di espressioni si apre dal menu di automazione, dai pulsanti per automatizzare nelle pagine di stile, e per l’oggetto globale. Il suo titolo indica che cosa stai automatizzando («Automatizza Rotazione»).

L'editor di espressioni che automatizza una rotazione con [m] * 6: il campo dell'espressione, la riga di inserimento rapido, il risultato 270 e i tag dell'oraL'editor di espressioni che automatizza una rotazione con [m] * 6: il campo dell'espressione, la riga di inserimento rapido, il risultato 270 e i tag dell'ora
  • Chiudi

    Chiude l’editor. Se hai modificato l’espressione, chiede prima se vuoi scartare le modifiche.

  • Salva

    Salva l’espressione. Un’espressione che non funziona non può essere salvata: la riga del risultato dice che cosa non va.

  • Espressione

    Dove digiti l’espressione. I tag compaiono come chip, e la tastiera non suggerisce parole, quindi non corregge il tuo codice.

  • Cancella

    Svuota il campo, dopo aver chiesto conferma. Salvare un’espressione vuota rimuove l’automazione.

  • Guida

    Apre la documentazione sull’automazione.

  • Inserimento rapido

    Operatori, parentesi e snippet che altrimenti dovresti cercare sulla tastiera. Toccane uno per inserirlo nel punto in cui si trova il cursore. La riga offre solo ciò che un quadrante Wear OS 6 può usare.

  • Valore risultante

    Il risultato dell’espressione, calcolato mentre digiti con l’ora e i dati attuali (o con i valori del Simulatore). Quando l’espressione non funziona, questa riga dice invece perché.

  • Tag

    Tutti i tag, per categoria, ognuno con il suo valore attuale. Tocca un tag per inserirlo. Tocca il valore di un oggetto di dati per vedere i suoi membri e alcuni snippet di esempio.

Ogni proprietà si aspetta un solo tipo di risultato, e l’editor lo controlla mentre digiti:

ProprietàRisultatoEsempio
RotazioneUn numero di gradi, in senso orario attorno al centro di rotazione del livello[s] * 6
Sposta X e Sposta YUna distanza; destra e basso sono positivi[s] / 60 - 0.5
Scala, Scala X e Scala YUn fattore, dove 1 è la dimensione che hai disegnato[steps] / [step_goal]
VisibilitàTrue per mostrare il livello, false per nasconderlo[h] >= 22
Un coloreUn colore[color].rgb(255, [m] * 4, 0)
Un testoUn testo[m] > 30 ? "late" : "early"

Quando il tipo è sbagliato, la riga del risultato dice che cosa si aspettava. Per ottenere un testo da un numero, uniscilo a un testo: [m] + " min".

Un’espressione è un piccolo pezzo di JavaScript. Su un quadrante Wear OS 6 viene convertita nel formato proprio dello smartwatch, che capisce solo la parte del linguaggio elencata qui. Questo elenco è esatto: qualsiasi cosa non vi compaia impedisce di inviare il quadrante a uno smartwatch Wear OS 6. Se fai scrivere le espressioni a un’IA, dalle questa sezione.

  • Numeri: 12, 12.5, -3. Tutti i numeri sono decimali, quindi 7 / 2 è 3.5.
  • Testi tra virgolette doppie o singole: "Low", 'Low'. Un testo non può contenere un ritorno a capo.
  • True e false: true, false.
  • Tag di dati: [bat_w], [steps], [h]. Ognuno è un numero o un testo; l’elenco dei tag indica quale.
  • Valori globali: [global].progress, impostati nell’oggetto globale.
  • Aritmetica: +, -, *, /, % (resto), e un - iniziale per cambiare segno.
  • Unire testi: + unisce quando uno dei due lati è un testo: [m] + " min", "Steps: " + [steps].
  • Confronto: ==, !=, <, <=, >, >=. Funzionano anche === e !==, e hanno lo stesso significato di == e !=.
  • Logica: && (e), || (o), ! (non).
  • Scelta: condition ? a : b dà a quando la condizione è vera, altrimenti b. Le scelte possono essere annidate.
  • Raggruppamento: parentesi tonde, ([s] + 30) % 60.

-, *, /, % e i confronti vogliono due numeri o due testi: [steps] == "5" non funziona.

Un’espressione può occupare più righe, per dare un nome a un valore quando lo usi più di una volta:

var goal = [step_goal] / 2
const done = [steps] / goal
return Math.min(1, done)
  • Dichiara i valori con var o const (non let). Modificane uno con =, +=, -=, *=, /= o %=.
  • La riga del risultato inizia con return non appena c’è più di una riga.
  • Un valore può contenere un oggetto, che leggi con un punto: var size = { small: 10, big: 20 }, poi size.big. Un elenco si può leggere solo in una posizione fissa: var steps = [10, 20], poi steps[0].
  • Il punto e virgola alla fine di una riga è facoltativo.
  • Commenti: /* … */ ovunque, e // ovunque tranne che alla fine dell’ultima riga (nasconderebbe la fine dell’espressione).

Tutte queste funzioni prendono numeri e danno un numero:

  • Math.min(a, b) e Math.max(a, b): esattamente due valori ciascuna. Annidale per usarne di più.
  • Math.round, Math.floor, Math.ceil, Math.trunc, Math.abs, Math.sign.
  • Math.sqrt, Math.cbrt, Math.pow(x, y), Math.exp, Math.expm1, Math.log, Math.log2, Math.log10.
  • Math.sin, Math.cos, Math.tan, Math.asin, Math.acos, Math.atan, Math.atan2(y, x), in radianti.
  • Math.random(): un nuovo numero da 0 a 1.
  • Costanti: Math.PI, Math.E, Math.LN2, Math.LN10, Math.LOG2E, Math.LOG10E, Math.SQRT1_2, Math.SQRT2.
  • x.toFixed(2) trasforma un numero in un testo con quel numero di decimali; x.toFixed() senza decimali. Il numero di decimali deve essere un numero semplice.
  • t.length: il numero di caratteri.
  • t.substring(start, end) e t.substr(start, length): una parte di un testo. Ometti il secondo valore per ottenere il resto del testo.
  • t.charAt(i): un solo carattere.
  • t.startsWith("a") e t.endsWith("a"): true o false.
  • t.repeat(3): il testo ripetuto tre volte. Il numero di ripetizioni deve essere un numero semplice.
  • parseInt(t) legge un numero intero da un testo (arrotonda); parseFloat(t) legge un numero decimale.
  • x.toString() trasforma un valore in un testo.

Un testo unito ("a" + x, o x.toString()) può essere il risultato, ma le funzioni di testo qui sopra non possono lavorarci, e nemmeno un confronto o la condizione di una scelta. Per trasformare un numero in un testo su cui lavorare, usa toFixed(): scrivi [steps].toFixed(0).length, non [steps].toString().length.

  • [frmt].lzero(x, 2) scrive x con almeno due cifre, aggiungendo zeri iniziali: [m] a 5 dà 05. Il numero di cifre deve essere un numero semplice.
  • [frmt].frmt_ms(ms) scrive una durata in millisecondi come mm:ss:mmm. Scegli le parti e il separatore con [frmt].frmt_ms(ms, { hh: true, mm: true, ss: true, sep: "." }); una parte che ometti non viene mostrata.
  • [frmt].frmt_number(x, "#,###") scrive x con un formato numerico: "#,###" aggiunge i separatori delle migliaia (12345 dà 12,345), "0.00" mostra sempre due decimali e "0.###E0" scrive in notazione scientifica. Il formato deve essere testo semplice tra virgolette, non costruito da altri valori. I separatori seguono la lingua dello smartwatch: uno smartwatch in olandese mostra 12.345 e 3,14.
  • [color].rgb(r, g, b) crea un colore da rosso, verde e blu, ognuno da 0 a 255.
  • [color].argb(a, r, g, b) crea un colore che può essere trasparente: l’alfa a viene per primo, da 0 (invisibile) a 255 (opaco). [color].argb(128, 255, 0, 0) è rosso a metà opacità.

Un’espressione che usa qualcosa che non è in elenco funziona comunque nell’anteprima dell’editor, ma il quadrante non può essere inviato a uno smartwatch Wear OS 6 finché non la riscrivi: l’elenco Non ancora compatibile sulla riga del livello dice quale espressione correggere.

Per mantenere un valore entro certi limiti, combina le due funzioni: Math.min(100, Math.max(0, [steps] / 100)).

L’oggetto globale contiene i valori e i calcoli che i livelli di un elemento condividono, così li scrivi una volta sola. Aprilo dal pulsante alla fine della lettura sopra l’area di disegno. Ogni riga imposta un valore su [global]:

[global].progress = Math.min(1, [steps] / [step_goal])
[global].low = [bat_w] < 20

L’espressione di qualsiasi livello può poi usare [global].progress o [global].low. L’oggetto globale viene eseguito prima delle espressioni dei livelli, quindi i suoi valori sono sempre aggiornati quando vengono usati. Nell’elenco dei tag, [global] si trova sotto «Tag globali».

La riga del risultato spiega che cosa non funziona: un errore di battitura nell’espressione, un tag sconosciuto, o un risultato del tipo sbagliato. Non puoi salvare un’espressione che non funziona, quindi il quadrante non mostra mai un’automazione rotta. Un livello automatizzato la cui espressione smette di funzionare (per esempio dopo la rimozione di un tag che usa) riceve un’icona di avviso nell’elenco dei livelli.

Per controllare come si comporta un’espressione a un’altra ora o con altri dati, imposta i valori nel Simulatore (nel menu «Altro» della barra superiore) e osserva la riga del risultato.