Schema tratto di input della smart home
action.devices.traits.InputSelector
: questa caratteristica è usata per i dispositivi che possono cambiare ingresso.
Gli input multimediali possono avere nomi dinamici per dispositivo che rappresentano feed audio o video. Questi feed possono essere collegati in rete o tramite cavo, ma devono avere un nome e un permanente. Questa caratteristica non supporta i feed temporanei arbitrari, ad esempio una libreria con possibilità di ricerca in rete. Sono supportate origini Bluetooth accoppiate con nome. Le origini possono avere più nomi, pertanto sono supportati sia i nomi creati dall'utente che quelli rilevati, nonché i nomi predefiniti. Ad esempio, "hdmi_1" potrebbe anche essere "DVD player" o "usb_1" potrebbe anche essere "Disco rigido".
Gli input multimediali possono essere ordinati per supportare i comandi "successivo" e "precedente".
Come per Toggles e Modes, i nomi degli input devono essere forniti in tutte le lingue disponibili; questo è particolarmente importante per i nomi predefiniti.
ATTRIBUTE del dispositivo
I dispositivi con questa caratteristica potrebbero segnalare i seguenti
attributi come parte dell'operazione SYNC
. Per scoprire di più sulla gestione degli intent SYNC
, consulta Soddisfazione degli intent.
Attributi | Tipo | Descrizione |
---|---|---|
availableInputs |
Array |
Obbligatorio. Elenco di oggetti che rappresentano i feed audio o video di input. I feed possono essere collegati in rete o tramite cavo. Ogni feed deve avere un nome e un nome ragionevolmente persistente. Assicurati di definire attentamente i sinonimi per evitare l'attivazione indesiderata. |
[item, ...] |
Oggetto |
Input disponibile. |
key |
Stringa |
Obbligatorio. Chiave univoca per l'input. La chiave non deve essere esposta agli utenti nella voce o nella risposta. |
names |
Array |
Obbligatorio. Elenco di nomi per l'input per tutte le lingue disponibili. |
[item, ...] |
Oggetto |
Input per una determinata lingua disponibile. |
lang |
Stringa |
Obbligatorio. Codice lingua. |
name_synonym |
Array |
Obbligatorio. Nomi facili da usare per l'input, in una determinata lingua. Il primo sinonimo viene utilizzato nella risposta dell'Assistente Google all'utente. |
[item, ...] |
Stringa |
Nome inserito. |
commandOnlyInputSelector |
Booleano |
(Valore predefinito: Indica se il dispositivo supporta la comunicazione unidirezionale (vero) o bidirezionale (falso). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a uno stato del report per questa caratteristica. |
orderedInputs |
Booleano |
(Valore predefinito: True se l'elenco di output è ordinato. Questo indica anche che sono disponibili le funzionalità "Prossimo" e "Precedente". |
Esempi
Dispositivo con due ingressi ordinati.
{ "availableInputs": [ { "key": "hdmi_1", "names": [ { "lang": "en", "name_synonym": [ "HDMI 1", "1st HDMI", "DVD Player" ] }, { "lang": "de", "name_synonym": [ "HDMI 1", "Zuerst HDMI", "DVD Spieler" ] } ] }, { "key": "usb_1", "names": [ { "lang": "en", "name_synonym": [ "USB 1", "First USB", "Hard Drive" ] }, { "lang": "de", "name_synonym": [ "USB 1", "Zuerst USB", "Festplatte" ] } ] } ], "orderedInputs": true }
STATEs dispositivo
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 Soddisfazione degli intent.
Stati | Tipo | Descrizione |
---|---|---|
currentInput |
Stringa |
Obbligatorio. Chiave dell'ingresso attualmente in uso. |
Esempi
Dispositivo con ingresso HDMI attualmente selezionato.
{ "currentInput": "hdmi_1" }
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 Soddisfazione degli intent.
action.devices.commands.SetInput
Imposta l'input multimediale.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
newInput |
Stringa |
Obbligatorio. Tasto del nuovo input. |
Esempi
Seleziona ingresso USB
{ "command": "action.devices.commands.SetInput", "params": { "newInput": "usb_1" } }
action.devices.commands.NextInput
Seleziona l'ingresso successivo. Applicabile solo quando l'attributo orderedInputs
è impostato su true.
{ "orderedInputs": true }
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
Nessuna proprietà |
Esempi
Nessun parametro
{ "command": "action.devices.commands.NextInput", "params": {} }
action.devices.commands.PreviousInput
Seleziona l'input precedente. Applicabile solo quando l'attributo orderedInputs
è impostato su true.
{ "orderedInputs": true }
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
Nessuna proprietà |
Esempi
Nessun parametro
{ "command": "action.devices.commands.PreviousInput", "params": {} }
Esempi di frasi
de-DE
-
Ändere den Eingangskanal auf
AUX .
en-US
-
change input mode to
HDMI 1
es-ES
-
cambia a
hdmi 1
fr-FR
-
Activation du mode
HDMI1 . -
Mets
la télé surHDMI 1 .
hi-IN
-
टीवी की इनपुटHDMI 1 में स्विच करो
it-IT
-
metti ingresso
aux sulla tv
ja-JP
-
テレビ HDMI1 にして
ko-KR
-
TV HDMI 1 로 바꿔 줘
nl-NL
-
zet
de TV opbluetooth
pt-BR
-
Muda a entrada da
TV paraHDMI2 . -
mudar a entrada para
AUX
sv-SE
-
Sätt på
hdmi 1
ERRORI del dispositivo
Consulta l'elenco completo degli errori e delle eccezioni.unsupportedInput
: l'input non è attualmente supportato.