Esquema de trait InputSelector de casa inteligente
action.devices.traits.InputSelector
: Esta característica se usa en los dispositivos que pueden cambiar de entrada.
Las entradas de contenido multimedia pueden tener nombres dinámicos por dispositivo que representen feeds de audio o video. Estos feeds pueden estar conectados por cable o en red, pero deben tener un nombre y ser razonablemente persistentes. Esta característica no admite feeds efímeros arbitrarios, como una biblioteca conectada en red con búsqueda. Se admiten fuentes Bluetooth sincronizadas con nombre. Las fuentes pueden tener varios nombres, de manera que se admiten los nombres creados y descubiertos por el usuario, así como los nombres predeterminados; por ejemplo, "hdmi_1" también puede ser "Reproductor de DVD", o "usb_1" también pueden ser "Disco duro".
Se pueden ordenar las entradas de medios para admitir los comandos “siguiente” y “anterior”.
Al igual que con Toggles y Modes, los nombres de las entradas se deben proporcionar en todos los idiomas disponibles; esto es relevante en especial para los nombres predeterminados.
Dispositivo ATTRIBUTES
Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC
. Para obtener más información sobre cómo controlar los intents SYNC
, consulta Entrega de intents.
Atributos | Tipo | Descripción |
---|---|---|
availableInputs |
Matriz |
Obligatorio. Lista de objetos que representan feeds de audio o video de entrada. Los feeds se pueden conectar por cable o en red. Cada feed debe tener un nombre y ser razonablemente persistente. Asegúrate de definir cuidadosamente tus sinónimos para evitar activaciones no deseadas (en exceso). |
[item, ...] |
Objeto |
Entrada disponible. |
key |
Cadena |
Obligatorio. Clave única para la entrada. La clave no se debe exponer a los usuarios en la voz ni en la respuesta. |
names |
Matriz |
Obligatorio. Lista de nombres de entrada para todos los idiomas disponibles. |
[item, ...] |
Objeto |
Es la entrada para un idioma disponible determinado. |
lang |
Cadena |
Obligatorio. Código de idioma. |
name_synonym |
Matriz |
Obligatorio. Nombres fáciles de usar para la entrada, en un idioma determinado. El primer sinónimo se usa en la respuesta de Asistente de Google al usuario. |
[item, ...] |
Cadena |
Nombre de la entrada. |
commandOnlyInputSelector |
Booleano |
(Predeterminado: Indica si el dispositivo admite el uso de comunicación unidireccional (verdadero) o bidireccional (falso). Establece este atributo como verdadero si el dispositivo no puede responder a un intent de QUERY o a un estado de informe de esta característica. |
orderedInputs |
Booleano |
(Predeterminado: Es verdadero si la lista de salida está ordenada. Esto también indica que las funcionalidades "siguiente" e "anterior" están disponibles. |
Ejemplos
Dispositivo con dos entradas ordenadas.
{ "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
Las entidades con esta característica pueden informar los siguientes estados como parte de la operación QUERY
. Para obtener más información sobre cómo controlar los intents QUERY
, consulta Entrega de intents.
Estados | Tipo | Descripción |
---|---|---|
currentInput |
Cadena |
Obligatorio. Clave de la entrada en uso actualmente. |
Ejemplos
Dispositivo con entrada HDMI seleccionada actualmente.
{ "currentInput": "hdmi_1" }
COMANDOS del dispositivo
Los dispositivos con esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE
. Para obtener más información sobre cómo controlar los intents EXECUTE
, consulta Entrega de intents.
action.devices.commands.SetInput
Configura la entrada multimedia.
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
newInput |
Cadena |
Obligatorio. Clave de la nueva entrada. |
Ejemplos
Seleccionar entrada USB
{ "command": "action.devices.commands.SetInput", "params": { "newInput": "usb_1" } }
action.devices.commands.NextInput
Selecciona la siguiente entrada. Solo se aplica cuando el atributo orderedInputs
se establece como verdadero.
{ "orderedInputs": true }
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
Sin propiedades |
Ejemplos
Sin parámetros
{ "command": "action.devices.commands.NextInput", "params": {} }
action.devices.commands.PreviousInput
Selecciona la entrada anterior. Solo se aplica cuando el atributo orderedInputs
se establece como verdadero.
{ "orderedInputs": true }
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
Sin propiedades |
Ejemplos
Sin parámetros
{ "command": "action.devices.commands.PreviousInput", "params": {} }
Expresiones de muestra
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 de dispositivos
Consulta la lista completa de errores y excepciones.unsupportedInput
: Actualmente, no se admite la entrada.