Schema trait StartStop per la smart home

action.devices.traits.StartStop. Questo trait appartiene ai dispositivi che supportano l'avvio e l'interruzione delle operazioni.

L'avvio e l'interruzione di un dispositivo ha una funzione simile all'accensione e allo spegnimento. I dispositivi che ereditano questo trait funzionano in modo diverso quando vengono attivati e quando vengono avviati. Alcune lavatrici, ad esempio, possono essere accese e modificare le relative impostazioni prima di avviare effettivamente il funzionamento.

A differenza dei dispositivi che hanno solo uno stato acceso e spento, alcuni dispositivi che possono avviarsi e arrestarsi sono anche in grado di mettere in pausa durante l'esecuzione di un'operazione. I dispositivi su cui è possibile mettere in pausa smetteranno di funzionare, ma al momento del ripristino continueranno a essere nello stesso stato in cui erano in pausa. L'attivazione è 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 può avere varie zone di irrigazione e supportare la capacità di irrigare separatamente zone specifiche, mentre un aspirapolvere può supportare la pulizia di stanze specifiche.

ATTRIBUTES del dispositivo

I dispositivi con questo trait potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta fulfillment dell'intent.

Attributi Tipo Descrizione
pausable Booleano

(Valore predefinito: false)

Indica se il dispositivo può essere messo in pausa durante il funzionamento.

availableZones Matrice

Indica i nomi di zona supportati. Le stringhe devono essere localizzate come impostato dall'utente. Questo elenco non è esclusivo; gli utenti possono segnalare qualsiasi nome desiderato.

[item, ...] String

Nome di una zona in cui è supportato il dispositivo di avvio.

Esempi

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

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

Dispositivo STATES

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

Stati Tipo Descrizione
isRunning Booleano

Obbligatorio.

Indica se il dispositivo è attualmente in funzione.

isPaused Booleano

Indica se il dispositivo è in pausa esplicitamente. Se questo valore è true, significa che isRunning è false, ma può essere ripristinato.

activeZones Matrice

Indica le zone in cui il dispositivo è attualmente in esecuzione nell'elenco availableZones.

[item, ...] String

Il nome della zona.

Esempi

Il dispositivo è in pausa?

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

Il dispositivo è in pausa?

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

Il dispositivo è in funzione?

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

COMMANDS 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 fulfillment dell'intent.

action.devices.commands.StartStop

Avvia o arresta il dispositivo.

Parametri

Parametri Tipo Descrizione
start Booleano

Obbligatorio.

Vero per avviare il funzionamento del dispositivo, falso per interrompere.

zone String

Indica la zona in cui iniziare l'esecuzione.

multipleZones Matrice

Indica due o più zone in cui iniziare l'esecuzione. Verrà impostato al posto di zone parameter.

[item, ...] String

Nome di una zona in cui avviare il dispositivo.

Esempi

Avvia il dispositivo.

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

Spegni 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 salotto.

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

action.devices.commands.PauseUnpause

Metti in pausa o riattiva il funzionamento del dispositivo.

Questo comando richiede i seguenti attributi:
{
  "pausable": true
}

Parametri

Parametri Tipo Descrizione
pause Booleano

Obbligatorio.

Vero per mettere in pausa, falso per riattivare.

Esempi

Metti in pausa il dispositivo.

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

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

Valori supportati:

unpausableState

Espressioni di esempio

de-DE

  • Bitte starte den Staubsauger im Wohnzimmer .
  • Geschirrspüler wieder anstellen
  • Staubsauger abschalten
  • Staubsauger pausieren
  • bitte starte die Waschmaschine
  • ist die Waschmaschine fertig

en-US

  • I need my roomba to start running in the den
  • is the vacuum running
  • pause the dryer now
  • start the dryer now
  • stop the dishwasher
  • unpause the dishwasher

es-ES

  • dime si ha acabado el lavavajillas
  • parar la lavadora
  • pon el lavavajillas en pausa
  • quiero usar el friegaplatos
  • vuelve a encender la aspiradora

fr-FR

  • Allumer l'aspirateur dans le salon .
  • Continuer l'aspirateur .
  • arrête l'aspirateur
  • est-ce que l'aspirateur est en marche
  • lance la machine à laver
  • mets l'aspirateur en pause

hi-IN

  • कमरे में वैक्यूम चलाओगी
  • क्या वैक्यूम चल रहा है?
  • डिशवॉशर को कुछ देर रोको
  • वैक्यूम को अनपॉज़ करो
  • वैक्यूम को चालू कर दो
  • वैक्यूम को बंद कर दो

it-IT

  • Mi accendi l'aspirapolvere in cucina ?
  • fa' partire aspirapolvere
  • fai ripartire l'aspirapolvere
  • la lavatrice è in funzione
  • metti in pausa l'aspirapolvere
  • stoppa l'aspirapolvere

ja-JP

  • お掃除ロボット リビング で動かして
  • 台所の食洗機 を一時停止してください
  • 掃除機 は作動してる
  • 掃除機 を停止して
  • 掃除機 を再開してください
  • 洗濯機 をスタートさせて

ko-KR

  • 거실 에서 청소기 돌려
  • 건조기 돌아가고 있나
  • 세탁기 좀 돌려 줘
  • 식기 세척기 다시 시작해
  • 청소기 일시 정지
  • 청소기 작동 멈춰 줘

nl-NL

  • De schoonmaakrobot inschakelen in de keuken .
  • Is de stofzuiger klaar
  • hervat de stofzuiger
  • pauzeer de stofzuiger
  • start mijn stofzuiger
  • stop de stofzuiger

pt-BR

  • Inicia o aspersor no jardim
  • Iniciar o aspirador de pó na sala .
  • iniciar a máquina de lavar
  • o aspirador está parado?
  • parar a pausa na máquina de lavar roupa
  • parar o aspirador de pó
  • pausar o aspirador de pó

sv-SE

  • Kör igång sprinklern gräsmattan .
  • har dammsugaren i vardagsrummet startat?
  • kör igång dammsugaren igen
  • pausa dammsugaren
  • starta tvättmaskinen
  • stoppa dammsugaren

ERRORS dispositivo

Consulta l'elenco completo di errori ed eccezioni.