Schema della caratteristica StartStop per la smart home

action.devices.traits.StartStop: questo attributo 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 questa caratteristica funzionano in modo diverso quando sono accesi e quando vengono avviati. Ad esempio, alcune lavatrici possono essere accese e le relative impostazioni modificate prima dell'avvio effettivo del funzionamento.

A differenza dei dispositivi che hanno semplicemente uno stato di accensione e spegnimento, alcuni dispositivi che possono avviarsi e arrestarsi sono in grado di mettere in pausa durante l'esecuzione di un'operazione. I dispositivi che possono essere messi in pausa smetteranno di funzionare, ma al riavvio continueranno nello stesso stato in cui erano stati messi in pausa. La disattivazione della messa in pausa è diversa dall'avvio/riavvio perché, indipendentemente dall'attuale stato del dispositivo, l'operazione inizierà dall'inizio.

Alcuni dispositivi potrebbero supportare l'esecuzione in determinate zone. Ad esempio, un irrigatore potrebbe avere varie zone di irrigazione e supportare la possibilità di irrigare zone specifiche separatamente, mentre un aspirapolvere potrebbe supportare la pulizia di stanze specifiche.

ATTRIBUTI del dispositivo

I dispositivi con questa caratteristica possono segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Adempimento degli 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 attributo possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta Adempimento degli 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 possono rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta Adempimento degli intent.

action.devices.commands.StartStop

Avvia o interrompi il dispositivo.

Parametri

Esempi

Avvia il dispositivo.

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

Interrompi 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, in sala da pranzo e in soggiorno.

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

action.devices.commands.PauseUnpause

Mettere in pausa o riattivare 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 non è in uno stato in cui può essere messo in pausa.

Valori supportati:

unpausableState

Frasi di esempio

ERRORI del dispositivo