Comandi iniziali, condizioni e azioni supportati

Le automazioni supportano i seguenti comandi iniziali e azioni. Tutti gli stati sono supportati anche come condizioni.

Stato / evento (comando iniziale)
Condizione
Comando (azione)
Campi supportati Descrizione
e Una condizione composta per rappresentare l'AND logico di tutte le condizioni secondarie.
assistant.command.Broadcast messaggio
assistant.command.OkGoogle okGoogle
assistant.event.OkGoogle query
device.command.ActivateScene attiva Attivare o disattivare una scena.
device.command.AppInstall newApplicationName Installa un'applicazione sul dispositivo specificato.
device.command.AppSearch applicationName Cerca l'applicazione specificata.
device.command.AppSelect applicationName Seleziona l'applicazione specificata.
device.command.ArmDisarm abilita
armLevel
annulla
Imposta il livello di allarme del dispositivo.
device.command.BrightnessAbsolute luminosità Regola la luminosità assoluta del dispositivo. Quando la luminosità è impostata su un valore maggiore di 0, se il dispositivo è spento, si accende e [`OnOffState.state`](./on_off_state) cambia per indicare che il dispositivo è acceso. Allo stesso modo, quando la luminosità è impostata su 0, il dispositivo si spegne e [`OnOffState.state`](./on_off_state) cambia di conseguenza.
device.command.BrightnessRelative brightnessRelativePercent
brightnessRelativeWeight
Regola la luminosità relativa del dispositivo. Quando la luminosità è impostata su un valore maggiore di 0, se il dispositivo è spento, si accende e [`OnOffState.state`](./on_off_state) cambia per indicare che il dispositivo è acceso. Allo stesso modo, quando la luminosità è impostata su 0, il dispositivo si spegne e [`OnOffState.state`](./on_off_state) cambia di conseguenza.
device.command.Charge carica Avviare o interrompere la ricarica.
device.command.ColorAbsolute color.name
color.spectrumHSV.hue
color.spectrumHSV.saturation
color.spectrumHSV.value
color.spectrumRGB
color.temperature
Imposta il colore sulla tonalità specificata. Quando il colore viene impostato su un dispositivo spento, il dispositivo si accende e [`OnOffState.state`](./on_off_state) cambia di conseguenza. Allo stesso modo, quando la luminosità è impostata su 0, il dispositivo si spegne e [`OnOffState.state`](./on_off_state) cambia di conseguenza.
device.command.Cook cookingMode
foodPreset
quantity
start
unit
Avviare o interrompere la cottura.
device.command.Dispense amount
item
presetName
unit
Erogare articoli.
device.command.Dock Aggancia il dispositivo.
device.command.EnableDisableGuestNetwork attiva Attiva o disattiva la rete ospite.
device.command.EnableDisableNetworkProfile enable
profile
Attivare o disattivare un profilo di rete. È necessario utilizzare la verifica utente secondaria con PIN. La sicurezza della casa di un utente può essere considerata compromessa se altri dispositivi di sicurezza vengono disattivati tramite questi comandi.
device.command.Fill fill
fillLevel
Riempire o svuotare il dispositivo.
device.command.FindMyDevice silenziare Localizza il dispositivo di destinazione generando un avviso locale.
device.command.HumidityRelative relativeHumidityPercent
relativeHumidityWeight
Regola il livello di umidità in base al valore attuale.
device.command.LightEffectColorLoop durata Il dispositivo passa da un colore all'altro.
device.command.LightEffectPulse durata L'intensità della luce aumenta dalla luminosità di livello medio alla luminosità massima, quindi diminuisce alla luminosità di livello medio con una durata del ciclo totale di un impulso al secondo. Durante ogni ciclo, la luminosità massima deve durare 200 ms e la luminosità di livello medio, escluso il periodo di transizione, deve durare almeno 500 ms.
device.command.LightEffectSleep durata In un determinato periodo di tempo, riduci gradualmente la luminosità del dispositivo e, facoltativamente, modifica la temperatura di colore.
device.command.LightEffectWake durata In un determinato periodo di tempo, aumenta gradualmente la luminosità del dispositivo e, se il dispositivo supporta l'effetto, modifica la temperatura di colore.
device.command.LockUnlock serratura Bloccare o sbloccare il dispositivo.
device.command.MediaNext Passa all'elemento multimediale successivo.
device.command.MediaPause Metti in pausa la riproduzione di contenuti multimediali.
device.command.MediaPrevious Passa all'elemento multimediale precedente.
device.command.MediaResume Riprendi la riproduzione di contenuti multimediali.
device.command.MediaShuffle Riproduci la playlist corrente in ordine casuale.
device.command.MediaStop Interrompi la riproduzione di contenuti multimediali.
device.command.Mute disattiva l'audio Disattiva o riattiva l'audio del dispositivo specificato.
device.command.NextInput Passa all'ingresso successivo.
device.command.OnOff on Accendi o spegni il dispositivo.
device.command.OpenClose openDirection
openPercent
Imposta lo stato di apertura/chiusura del dispositivo
device.command.PauseUnpause metti in pausa Mettere in pausa o riprendere il funzionamento del dispositivo.
device.command.PreviousInput Passa all'ingresso precedente.
device.command.Reboot Riavvia il dispositivo.
device.command.RelativeChannel channelCount Regola il canale corrente di un valore relativo.
device.command.ReturnChannel Torna al canale precedente dell'utente.
device.command.ReverseFan Inverti la direzione della ventola.
device.command.RotateAbsolute rotationDegrees
rotationPercent
Imposta la rotazione assoluta del dispositivo.
device.command.SelectChannel channelCode
channelName
channelNumber
Imposta il canale corrente su un valore specifico.
device.command.SetFanSpeed fanSpeed Imposta la velocità della ventola.
device.command.SetFanSpeedRelative fanSpeedRelativePercent
fanSpeedRelativeWeight
Imposta la velocità relativa del ventilatore.
device.command.SetHumidity humidity Imposta il livello di umidità su un valore assoluto.
device.command.SetInput newInput Imposta l'input multimediale.
device.command.SetVolume volumeLevel Imposta il volume di un determinato dispositivo.
device.command.StartStop start Avviare o arrestare il dispositivo.
device.command.StopLightEffect Interrompi l'effetto luce corrente.
device.command.ThermostatSetMode thermostatMode Imposta la modalità di funzionamento target per un termostato.
device.command.ThermostatTemperatureSetpoint thermostatTemperatureSetpoint Imposta la temperatura ottimale per un termostato.
device.command.ThermostatTemperatureSetRange thermostatTemperatureSetpointHigh
thermostatTemperatureSetpointLow
Imposta un intervallo di temperature ottimale per un termostato.
device.command.TimerAdjust durata Regola la durata del timer.
device.command.TimerCancel Annullare il timer.
device.command.TimerPause Metti in pausa il timer.
device.command.TimerResume Riprendi il timer.
device.command.TimerStart durata Avvia un nuovo timer.
device.event.AnimalOtherDetection La videocamera ha rilevato un cane o un gatto. Il rilevamento di altri tipi di animali non è supportato.
device.event.DoorbellPress È stato premuto un campanello.
device.event.FaceFamiliarDetection La videocamera ha rilevato un volto riconosciuto.
device.event.FaceUnfamiliarDetection La videocamera ha rilevato un volto non riconosciuto.
device.event.MotionDetection Il dispositivo ha rilevato un movimento.
device.event.MovingVehicleDetection La videocamera ha rilevato un veicolo in movimento.
device.event.PackageDelivered La videocamera ha rilevato la consegna di un pacco.
device.event.PersonDetection La videocamera ha rilevato una persona.
device.event.PersonTalking Il dispositivo ha rilevato il suono di una persona che parla.
device.event.Sound Il dispositivo ha rilevato un suono.
device.state.AppSelector currentApplication Per i dispositivi in grado di passare da un'applicazione all'altra.
device.state.ArmDisarm currentArmLevel
isArmed
Per i dispositivi come i sistemi di sicurezza che supportano l'abilitazione e la disabilitazione, indica se il dispositivo è abilitato o disabilitato.
device.state.Brightness luminosità L'impostazione della luminosità di un dispositivo.
device.state.Channel Per i dispositivi che supportano i canali su un dispositivo multimediale.
device.state.ColorSetting color.colorTemperature
color.spectrumHsv.hue
color.spectrumHsv.saturation
color.spectrumHsv.value
color.spectrumRgb
Lo stato di un'impostazione del colore.
device.state.Cook currentCookingMode
currentFoodPreset
Per i dispositivi che possono cuocere il cibo in base a varie preimpostazioni e modalità di cottura supportate.
device.state.Dock isDocked Per i dispositivi mobili autonomi che possono essere comandati per tornare alla ricarica.
device.state.EnergyStorage descriptiveCapacityRemaining
isCharging
isPluggedIn
Lo stato di un dispositivo di accumulo di energia, ad esempio una batteria, inclusa la quantità di energia che sta immagazzinando, se è in carica o meno e se è collegato o meno.
device.state.FanSpeed currentFanSpeedPercent
currentFanSpeedSetting
Per i dispositivi che supportano l'impostazione della velocità di un ventilatore.
device.state.Fill currentFillLevel
currentFillPercent
isFilled
Per i dispositivi che supportano il riempimento, come una vasca da bagno.
device.state.HumiditySetting humidityAmbientPercent
humiditySetpointPercent
Per i dispositivi che supportano le impostazioni di umidità, come umidificatori e deumidificatori.
device.state.InputSelector currentInput Consente di eseguire query sui dispositivi in grado di cambiare ingresso. Gli ingressi multimediali possono avere nomi dinamici per dispositivo che rappresentano feed audio o video. Questi feed possono essere cablati o collegati in rete, ma devono avere un nome ed essere ragionevolmente persistenti. Non supporta feed temporanei arbitrari, come una libreria di rete in cui è possibile eseguire ricerche. Sono supportate le sorgenti Bluetooth accoppiate e con nome. Le sorgenti possono avere più nomi, pertanto sono supportati i nomi creati e rilevati dagli utenti, nonché i nomi predefiniti; ad esempio, "hdmi_1" potrebbe anche essere "Lettore DVD" o "usb_1" potrebbe anche essere "disco rigido". Gli input multimediali possono essere ordinati per supportare i comandi "successivo" e "precedente". Nota: InputSelector non supporta la grammatica delle query.
device.state.LightEffects activeLightEffect Per i dispositivi che possono supportare comandi di illuminazione complessi per cambiare stato, ad esempio il succedersi di diverse colorazioni della luce.
device.state.LockUnlock isJammed
isLocked
Per i dispositivi che supportano il blocco e lo sblocco e/o la segnalazione di uno stato di blocco.
device.state.MediaState playbackState Per i dispositivi che riproducono contenuti multimediali, lo stato dei contenuti multimediali, ad esempio se sono in riproduzione o meno.
device.state.MotionDetection motionDetectionEventInProgress Per i dispositivi in grado di rilevare il movimento.
device.state.OccupancySensing occupancy Per i dispositivi in grado di rilevare la presenza di persone, tramite sensori PIR, a ultrasuoni o di contatto fisico.
device.state.Online online Per i dispositivi che supportano lo stato online e offline e/o segnalano lo stato online e offline.
device.state.OnOff on La funzionalità di accensione e spegnimento di base per qualsiasi dispositivo con accensione e spegnimento binari, inclusi prese e interruttori, nonché molti dispositivi futuri.
device.state.OpenClose openPercent Per i dispositivi che supportano l'apertura e la chiusura e, in alcuni casi, l'apertura e la chiusura parziale o potenzialmente in più direzioni.
device.state.Record isCurrentlyRecording Per i dispositivi che supportano la registrazione su contenuti multimediali.
device.state.Rotation rotationDegrees
rotationPercent
Per i dispositivi che supportano la rotazione, ad esempio le veneziane con lamelle orientabili.
device.state.RunCycle currentCycleRemainingTime
currentTotalRemainingTime
Per i dispositivi che hanno una durata continua per il loro funzionamento, che può essere interrogata. Dispositivi come questi segnalano il numero totale di cicli all'inizio del funzionamento e ogni ciclo in cui si trova il dispositivo durante l'esecuzione.
device.state.SensorState currentSensorStateData.key
currentSensorStateData.value.currentSensorState
currentSensorStateData.value.rawValue
Una misurazione prodotta da un sensore. Ad esempio, la quantità di fumo misurata da un rilevatore di fumo o la quantità di monossido di carbonio misurata da un rilevatore di monossido di carbonio e così via.
device.state.StartStop isPaused
isRunning
Per i dispositivi che supportano le operazioni di avvio e arresto. L'avvio e l'arresto di un dispositivo hanno una funzione simile all'accensione e allo spegnimento. Indica che i dispositivi funzionano in modo diverso quando sono accesi e quando vengono avviati. Ad esempio, alcune lavatrici possono essere accese e le relative impostazioni possono essere modificate prima di avviare effettivamente il funzionamento.
device.state.TemperatureControl temperatureAmbient
temperatureSetpoint
Controlla la temperatura di un dispositivo diverso da un termostato (ad esempio un forno), all'interno o intorno al dispositivo.
device.state.TemperatureSetting activeThermostatMode
thermostatHumidityAmbient
thermostatMode
thermostatTemperatureAmbient
thermostatTemperatureSetpoint
thermostatTemperatureSetpointHigh
thermostatTemperatureSetpointLow
Per i dispositivi che supportano punti e modalità di temperatura.
device.state.Timer timerPaused Per i dispositivi che supportano la funzionalità timer. Ad esempio, un controller per irrigatore smart o un interruttore della luce smart potrebbe avere un timer integrato. Può essere utilizzato per chiedere al dispositivo quanto tempo rimane nel timer.
device.state.Volume currentVolume
isMuted
Per i dispositivi in grado di regolare il volume (ad esempio, impostare il volume su un determinato livello, disattivare o attivare l'audio).
home.command.Notification body
members
title
Invia una notifica ai membri della casa specificati utilizzando il loro indirizzo email.
home.state.HomePresence homePresenceMode
not Una condizione per rappresentare il NOT logico di un'altra condizione.
oppure Una condizione composta per rappresentare l'OR logico di tutte le condizioni secondarie.
time.between Rappresenta un intervallo di tempo.
time.delay Aggiunge una pausa nell'esecuzione dell'automazione.
time.schedule Rappresenta un evento di pianificazione temporale.