Schema del tratto Smart Home StartStop

action.devices.traits.StartStop: questa caratteristica appartiene ai 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. I dispositivi che ereditano questo tratto funzionano in modo diverso quando vengono accesi e quando vengono avviati. Alcune lavatrici, ad esempio, possono essere accese e le loro impostazioni possono essere modificate prima di iniziare effettivamente il funzionamento.

A differenza dei dispositivi che hanno semplicemente uno stato di accensione e spegnimento, alcuni dispositivi che possono avviarsi e arrestarsi sono anche in grado di mettere in pausa durante l'esecuzione di un'operazione. I dispositivi che possono mettere in pausa smetteranno di funzionare, ma alla ripresa continueranno nello stesso stato in cui si trovavano quando sono stati messi in pausa. La riproduzione non è uguale all'avvio/riavvio, in quanto, indipendentemente dallo stato attuale del dispositivo, l'operazione inizierà dall'inizio.

Alcuni dispositivi potrebbero supportare la corsa in determinate zone. Ad esempio, un irrigatore può avere varie zone di irrigazione e supportare la possibilità di irrigare zone particolari separatamente, mentre un aspirapolvere può supportare la pulizia di stanze specifiche.

ATTRIBUTI dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per saperne di più sulla gestione degli intent SYNC, consulta Completamento dell'intent.

Esempi

Dispositivo che può essere messo in pausa e supporta il funzionamento in più zone.

{
  "pausable": true,
  "availableZones": [
    "Kitchen",
    "Living room",
    "Office",
    "Bedroom"
  ]
}

Stati del dispositivo

Le entità con questo tratto possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per saperne di più sulla gestione degli intent QUERY, consulta Completamento dell'intent.

Esempi

Il dispositivo è in pausa?

{
  "isRunning": false,
  "isPaused": true
}

Il dispositivo è in pausa?

{
  "isRunning": true,
  "isPaused": false
}

Il dispositivo è in esecuzione?

{
  "isRunning": true,
  "isPaused": false,
  "activeZones": [
    "Kitchen",
    "Living room"
  ]
}

COMANDI del dispositivo

I dispositivi con questa caratteristica potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per saperne di più sulla gestione degli intent EXECUTE, consulta Completamento dell'intent.

action.devices.commands.StartStop

Avvia o arresta il dispositivo.

Parametri

Esempi

Avvia il dispositivo.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true
  }
}

Arresta il dispositivo.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": false
  }
}

Avvia il dispositivo in ufficio.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "zone": "office"
  }
}

Avvia il dispositivo in cucina, sala da pranzo e soggiorno.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "multipleZones": [
      "Kitchen",
      "Dining room",
      "Living room"
    ]
  }
}

action.devices.commands.PauseUnpause

Mettere in pausa o riprendere il funzionamento del dispositivo.

{
  "pausable": true
}

Parametri

Esempi

Metti in pausa il dispositivo.

{
  "command": "action.devices.commands.PauseUnpause",
  "params": {
    "pause": true
  }
}

Errori correlati

L'utente ha provato a mettere in pausa un dispositivo, ma il dispositivo si trova in uno stato in cui non può essere messo in pausa.

Valori supportati:

unpausableState

Esempi di espressioni

ERRORI del dispositivo