Schema dei tratti del volume per la smart home
action.devices.traits.Volume
- Questa trait appartiene ai dispositivi in grado di regolare il volume (ad esempio, impostare il volume a un determinato livello oppure disattivare o riattivare l'audio).
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 |
---|---|---|
volumeMaxLevel |
Intero |
Obbligatorio. Il livello di volume massimo, presupponendo una base di 0 (audio disattivato). L'assistente regolerà i comandi avvverbi (ad es. "alza un po' la TV") di conseguenza. |
volumeCanMuteAndUnmute |
Booleano |
Obbligatorio. Indica se il dispositivo può disattivare e riattivare l'audio del volume. La disattivazione dell'audio è un'opzione separata, dato che con l'opzione "Disattiva l'audio" il volume è impostato su 0 mantenendo il volume precedente, in modo che la riattivazione dell'audio lo ripristini. Questo si riflette nello stato del volume: se il volume è impostato su 5 e l'utente disattiva l'audio, il volume rimane 5 e |
volumeDefaultPercentage |
Intero |
(Valore predefinito: Il volume (in percentuale) del volume predefinito definito dall'utente o dal produttore. La scala deve essere da 0 a 100. |
levelStepSize |
Intero |
(Valore predefinito: La dimensione predefinita del passaggio per le query di volume relativo, ad esempio "Alza il volume su <device_name>". |
commandOnlyVolume |
Booleano |
(Valore predefinito: Indica se il dispositivo funziona utilizzando una comunicazione unidirezionale (true) o bidirezionale (false). Ad esempio, se il controller è in grado di confermare il nuovo stato del dispositivo dopo l'invio della richiesta, questo campo è false. Se non è possibile confermare se la richiesta è stata eseguita correttamente o per recuperare lo stato del dispositivo (ad esempio, se il dispositivo è un tradizionale telecomando a infrarossi), imposta questo campo su true. |
Esempi
Speaker speaker che può essere disattivato e segnala lo stato attuale
{ "volumeMaxLevel": 11, "volumeCanMuteAndUnmute": true, "levelStepSize": 2, "commandOnlyVolume": false, "volumeDefaultPercentage": 6 }
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 |
---|---|---|
currentVolume |
Intero |
Obbligatorio. La percentuale del volume attuale. Il valore deve essere compreso tra |
isMuted |
Booleano |
Obbligatorio se l'attributo |
Esempi
Speaker speaker che può essere disattivato e segnala lo stato attuale
{ "currentVolume": 5, "isMuted": false }
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.mute
Disattiva o riattiva l'audio del dispositivo.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
mute |
Booleano |
Obbligatorio. Indica se disattivare o riattivare l'audio di un dispositivo. |
Esempi
Disattivare l'audio dello speaker
{ "command": "action.devices.commands.mute", "params": { "mute": true } }
action.devices.commands.setVolume
Imposta il volume al livello richiesto, in base a volumeMaxLevel
.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
volumeLevel |
Intero |
Obbligatorio. Nuovo volume, da |
Esempi
Impostare il volume assoluto dello speaker
{ "command": "action.devices.commands.setVolume", "params": { "volumeLevel": 6 } }
action.devices.commands.volumeRelative
Imposta n passi per alzare o abbassare il volume, in base a volumeMaxLevel
. Per i comandi che utilizzano una scala relativa, l'assistente selezionerà n in modo appropriato per scalare i passaggi disponibili. Ad esempio, se selezioni Aumenta il volume della TV, verrà impostato un numero di passi superiore rispetto a Alza il volume della TV un po' di meno.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
relativeSteps |
Intero |
Obbligatorio. negativo per "diminuisci". |
Esempi
Impostare il volume relativo dello speaker in modalità di solo comando
{ "command": "action.devices.commands.volumeRelative", "params": { "relativeSteps": -1 } }
ERRORS dispositivo
Consulta l'elenco completo di errori ed eccezioni.volumeAlreadyMax
: il dispositivo riceve il comandoVolumeUp
quando è già al massimo volume.volumeAlreadyMin
: il dispositivo riceve il comandoVolumeDown
quando è già al minimo.