Schema del tratto StartStop per la smart home

action.devices.traits.StartStop: questo tratto 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. Ad esempio, alcune lavatrici possono essere accese e le relative impostazioni possono essere modificate prima di avviare effettivamente il funzionamento.

A differenza dei dispositivi che hanno semplicemente uno stato di accensione e spegnimento, alcuni dispositivi che possono essere avviati e arrestati possono anche essere messi in pausa durante l'esecuzione di un'operazione. I dispositivi che possono essere messi in pausa interromperanno il funzionamento, ma quando verranno riattivati continueranno nello stesso stato in cui si trovavano quando sono stati messi in pausa. La riattivazione è diversa dall'avvio/riavvio perché, indipendentemente dallo stato attuale del dispositivo, l'operazione inizierà dall'inizio.

Alcuni dispositivi potrebbero supportare l'esecuzione in determinate zone. Ad esempio, un irrigatore potrebbe avere diverse 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 questo tratto 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 dei dispositivi

Le entità con questa caratteristica 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 potrebbero 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

Avviare o arrestare 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, in sala da pranzo e in Living Room.

{
  "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 questo si trova in uno stato in cui non può essere messo in pausa.

Valori supportati:

unpausableState

Frasi di esempio

ERRORI del dispositivo