Riferimento all'operatore DSL Android

Gli operatori ti consentono di controllare il valore degli attributi dei tratti rispetto a valori specifici, di confrontarli tra loro e di combinare le espressioni utilizzate nei nodi condition.

Gli operatori sono disponibili tramite le seguenti istruzioni import:

import com.google.home.automation.and
import com.google.home.automation.between
import com.google.home.automation.contains
import com.google.home.automation.equals
import com.google.home.automation.greaterThan
import com.google.home.automation.greaterThanOrEquals
import com.google.home.automation.lessThan
import com.google.home.automation.not
import com.google.home.automation.notEquals
import com.google.home.automation.or

Operatori di confronto

tra

Restituisce true quando il valore di Expression 1 è compreso tra quello di Expression 2 e Expression 3 (inclusi). Le espressioni vengono classificate in modo diverso a seconda del tipo di dati. I tipi di dati semplici, come numeri e stringhe, vengono classificati nello stesso modo in cui vengono classificati in Kotlin.

Esempio di DSL

val time = stateReader<_>(structure, Time)
condition() {
  expression = time.currentTime
     .between(
      time.sunsetTime,
      time.sunriseTime)
}

Utilizzare le date con between()

Quando utilizzi l'operatore between(), puoi specificare un intervallo di date:

val exp2 =
  time.currentDate.between(
    LocalDate.of(2025, Month.OCTOBER, 1),
    LocalDate.of(2025, Month.DECEMBER, 15),
  )

Tuttavia, non sei limitato alle date complete. La DSL di automazione ti consente anche di esprimere un intervallo di date in vari modi:

• Utilizzando solo anno e mese:

val exp2 =
  time.currentDate.yearMonth.between(
    YearMonth.of(2024, Month.OCTOBER),
    YearMonth.of(2026, Month.JANUARY),
  )

• Utilizzando solo mese e giorno:

val exp2 =
  time.currentDate.monthDay.between(
    MonthDay.of(Month.OCTOBER, 1),
    MonthDay.of(Month.DECEMBER, 15),
  )

• Utilizzando solo il giorno del mese:

val exp2 = time.currentDate.day.between(1, 15)

uguale a

Restituisce true quando Expression 1 è uguale a Expression 2.

Esempio di DSL

washer.operationalState equals STOPPED

greaterThan

Restituisce true quando Expression 1 è maggiore di Expression 2.

Esempio di DSL

( blindsPosition.currentPositionLift greaterThan 0u )

greaterThanOrEquals

Restituisce true quando Expression 1 è maggiore o uguale a Expression 2.

Esempio di DSL

( starterNode.measuredValue greaterThanOrEquals 50 )

lessThan

Restituisce true quando Expression 1 è minore di Expression 2.

Esempio di DSL

time.currentTime lessThan LocalTime.of(22,0,0,0)

lessThanOrEquals

Restituisce true quando Expression 1 è minore o uguale a Expression 2.

Esempio di DSL

( starterNode.measuredValue lessThanOrEquals 25 )

notEquals

Restituisce true quando Expression 1 non è uguale a Expression 2.

Esempio di DSL

occupancyStateChange.occupied notEquals 0

Operatori aritmetici

Aggiungi

L'operatore di addizione ( + ).

Esempio di DSL

var totalCount = 0
...
totalCount = totalCount + 1

Sottrazione

L'operatore di sottrazione ( - ).

Esempio di DSL

var countdown = 10
...
countdown = countdown - 1

Moltiplica

L'operatore di moltiplicazione ( * ).

Esempio di DSL

val millis = seconds * 1000

Divisione

L'operatore di divisione ( / ).

Esempio di DSL

val rpm = revolutions / minutes

Operatori logici

e

Combina due espressioni in un'espressione logica AND, che restituisce true quando entrambe le espressioni sono true.

Esempio di DSL

((device.occupied notEquals 0) and
   time.currentTime.between(time.sunriseTime, time.sunsetTime))

non

Nega il valore logico di un'espressione.

Esempio di DSL

time.currentTime not (between(time.sunriseTime, time.sunsetTime))

o

Combina due espressioni in un'espressione logica OR.

Esempio di DSL

(time.currentTime equals LocalTime.of(10,0,0,0)) or
  (time.currentTime equals LocalTime.of(22,0,0,0))