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 la logica AND di tutte le condizioni secondarie.
assistant.command.Broadcast messaggio
assistant.command.OkGoogle okGoogle
assistant.event.OkGoogle query
device.command.ActivateScene attiva Attiva o disattiva 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 indicata.
device.command.ArmDisarm arm
armLevel
cancel
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 Avvia o interrompi 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
Avvia o interrompi la cottura.
device.command.Dispense amount
item
presetName
unit
Distribuire gli articoli.
device.command.Dock Aggancia il dispositivo alla base di ricarica.
device.command.EnableDisableGuestNetwork attiva Attiva o disattiva la rete ospite.
device.command.EnableDisableNetworkProfile attiva
profile
Attivare o disattivare un profilo di rete. Deve essere utilizzata la verifica utente secondaria con PIN. La sicurezza della casa di un utente può essere considerata interessata se altri dispositivi di sicurezza vengono disattivati tramite questi comandi.
device.command.Fill fill
fillLevel
Riempi o svuota il dispositivo.
device.command.FindMyDevice silenziare Individua il dispositivo di destinazione generando un avviso locale.
device.command.HumidityRelative relativeHumidityPercent
relativeHumidityWeight
Regola il livello di umidità rispetto al valore attuale.
device.command.LightEffectColorLoop durata Scorrere una serie di colori sul dispositivo.
device.command.LightEffectPulse durata L'intensità della luce aumenta dalla luminosità di livello medio a quella massima, per poi diminuire fino alla luminosità di livello medio, con un tempo di 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 Nell'arco di un determinato periodo di tempo, diminuisci gradualmente la luminosità del dispositivo e, se vuoi, modifica la temperatura del colore.
device.command.LightEffectWake durata Nell'arco di un determinato periodo di tempo, aumenta gradualmente la luminosità del dispositivo e, se vuoi, 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 Mettere in pausa la riproduzione dei contenuti multimediali.
device.command.MediaPrevious Vai all'elemento multimediale precedente.
device.command.MediaResume Riprendi la riproduzione dei contenuti multimediali.
device.command.MediaShuffle Riproduci in ordine casuale la playlist attuale.
device.command.MediaStop Interrompi la riproduzione di contenuti multimediali.
device.command.Mute disattiva l'audio Disattivare o riattivare l'audio del dispositivo specificato.
device.command.NextInput Passa all'input 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'input precedente.
device.command.Reboot Riavvia il dispositivo.
device.command.RelativeChannel channelCount Regola il canale corrente di un importo relativo.
device.command.ReturnChannel Torna al canale precedente su cui si trovava l'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 attuale su un valore specifico.
device.command.SetFanSpeed fanSpeed Imposta la velocità del ventilatore.
device.command.SetFanSpeedRelative fanSpeedRelativePercent
fanSpeedRelativeWeight
Imposta la velocità relativa della ventola.
device.command.SetHumidity umidità Imposta il livello di umidità su un valore assoluto.
device.command.SetInput newInput Imposta l'input dei contenuti multimediali.
device.command.SetVolume volumeLevel Imposta il volume di un determinato dispositivo.
device.command.StartStop start Avvia o arresta 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 target per un termostato.
device.command.ThermostatTemperatureSetRange thermostatTemperatureSetpointHigh
thermostatTemperatureSetpointLow
Imposta un intervallo di temperatura target per un termostato.
device.command.TimerAdjust durata Regola la durata del timer.
device.command.TimerCancel Annulla 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 sconosciuto.
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 un pacco consegnato.
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'inserimento e il disinserimento, indica se il dispositivo è inserito o disinserito.
device.state.Brightness luminosità L'impostazione della luminosità per 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 cucinare il cibo in base a varie preimpostazioni alimentari e modalità di cottura supportate.
device.state.Dock isDocked Per i dispositivi mobili autonomi a cui può essere ordinato di tornare per la ricarica.
device.state.EnergyStorage descriptiveCapacityRemaining
isCharging
isPluggedIn
Lo stato di un dispositivo di accumulo di energia come una batteria, inclusi la quantità di energia che sta accumulando, se è in carica e se è collegato.
device.state.FanSpeed currentFanSpeedPercent
currentFanSpeedSetting
Per i dispositivi che supportano l'impostazione della velocità di una ventola.
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 input. Gli input multimediali possono avere nomi dinamici per dispositivo che rappresentano feed audio o video. Questi feed possono essere cablati o in rete, ma devono essere denominati e ragionevolmente persistenti. Non supporta feed effimeri arbitrari, ad esempio una libreria di rete ricercabile. Sono supportate le sorgenti Bluetooth accoppiate e denominate. Le sorgenti possono avere più nomi, quindi sono supportati i nomi creati e scoperti dagli utenti, nonché i nomi predefiniti. Ad esempio, "hdmi_1" potrebbe essere anche "Lettore DVD" o "usb_1" potrebbe essere anche "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 diversi colori.
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, ad esempio se sono in riproduzione o meno.
device.state.MotionDetection motionDetectionEventInProgress Per i dispositivi in grado di rilevare il movimento.
device.state.OccupancySensing presenza Per i dispositivi in grado di rilevare l'occupazione, 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 che lo segnalano.
device.state.OnOff on La funzionalità di accensione e spegnimento di base per qualsiasi dispositivo che ha 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ù di una direzione.
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, come le veneziane con lamelle rotanti.
device.state.RunCycle currentCycleRemainingTime
currentTotalRemainingTime
Per i dispositivi per cui è in corso un'operazione con una durata definita che può essere interrogata. Dispositivi come questi segnaleranno 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 interruzione. 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 sono avviati. Ad esempio, alcune lavatrici possono essere accese e le loro impostazioni modificate prima di iniziare 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 irrigatori smart o un interruttore della luce smart potrebbe avere un timer integrato. Può essere utilizzato per interrogare il dispositivo in merito al tempo rimanente sul timer.
device.state.Volume currentVolume
isMuted
Per i dispositivi in grado di modificare il volume (ad esempio, impostare il volume a un determinato livello, disattivare o riattivare l'audio).
home.command.Notification body
members
title
Invia una notifica ai membri della casa specificati.
home.state.HomePresence homePresenceMode
not Una condizione per rappresentare la negazione logica di un'altra condizione.
o Una condizione composta per rappresentare l'operatore logico OR di tutte le condizioni secondarie.
time.between Rappresenta un intervallo di tempo.
time.delay Aggiunge una pausa all'esecuzione dell'automazione.
time.schedule Rappresenta un evento di programmazione oraria.