Schema delle caratteristiche InputSelector per la smart home
action.devices.traits.InputSelector
: questa trait viene utilizzata per i dispositivi in grado di cambiare ingresso.
Gli input multimediali possono avere nomi dinamici per dispositivo che rappresentano feed audio o video. Questi feed possono essere cablati o collegati in rete, ma devono avere un nome e avere un nome ragionevolmente permanente. Questa trait non supporta feed temporanei arbitrari, ad esempio una libreria in rete disponibile per la ricerca. Sono supportate origini Bluetooth accoppiate con nome. Le origini possono avere più nomi, pertanto sono supportati anche i nomi creati e rilevati dagli utenti, oltre ai nomi predefiniti; ad esempio, "hdmi_1" potrebbe essere anche "Lettore DVD" o "usb_1" potrebbe essere anche "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; ciò è particolarmente pertinente per i nomi predefiniti.
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 |
---|---|---|
availableInputs |
Matrice |
Obbligatorio. Elenco di oggetti che rappresentano feed audio o video di input. I feed possono essere cablati o collegati in rete. Ogni feed deve avere un nome e deve essere ragionevolmente permanente. Assicurati di definire attentamente i sinonimi per evitare attivazioni indesiderate (eccessive). |
[item, ...] |
Oggetto |
Input disponibile. |
key |
String |
Obbligatorio. Chiave univoca per l'input. La chiave non deve essere esposta agli utenti nel parlato o nella risposta. |
names |
Matrice |
Obbligatorio. Elenco di nomi per l'input per tutte le lingue disponibili. |
[item, ...] |
Oggetto |
Inserisci l'input per una determinata lingua disponibile. |
lang |
String |
Obbligatorio. Codice lingua. |
name_synonym |
Matrice |
Obbligatorio. Nomi semplici per l'input, in una determinata lingua. Il primo sinonimo viene utilizzato nella risposta dell'Assistente Google all'utente. |
[item, ...] |
String |
Inserisci il nome. |
commandOnlyInputSelector |
Booleano |
(Valore predefinito: Indica se il dispositivo supporta l'uso di una comunicazione unidirezionale (true) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a uno stato del report per questo trait. |
orderedInputs |
Booleano |
(Valore predefinito: True se l'elenco di output è ordinato. Questo indica inoltre che sono disponibili le funzionalità "successivo" e "precedente". |
Esempi
Dispositivo con due input 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 }
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 |
---|---|---|
currentInput |
String |
Obbligatorio. Tasto dell'input attualmente in uso. |
Esempi
Dispositivo con ingresso HDMI attualmente selezionato.
{ "currentInput": "hdmi_1" }
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.SetInput
Imposta l'input multimediale.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
newInput |
String |
Obbligatorio. Tasto del nuovo input. |
Esempi
Seleziona l'ingresso USB
{ "command": "action.devices.commands.SetInput", "params": { "newInput": "usb_1" } }
action.devices.commands.NextInput
Seleziona l'input 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": {} }
Espressioni di esempio
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é sur HDMI 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 op bluetooth
pt-BR
- Muda a entrada da TV para HDMI2 .
- mudar a entrada para AUX
sv-SE
- Sätt på hdmi 1
ERRORS dispositivo
Consulta l'elenco completo di errori ed eccezioni.unsupportedInput
: l'input non è attualmente supportato.