Esquema de la función InputSelector de la casa inteligente

action.devices.traits.InputSelector: Esta característica se usa en dispositivos que pueden cambiar de entrada.

Las entradas de medios pueden tener nombres dinámicos por dispositivo que representen feeds de audio o video. Estos feeds se pueden conectar o conectar, pero deben tener un nombre y ser bastante persistentes. Esta característica no admite feeds efímeros arbitrarios, como una biblioteca conectada en red para buscar. Se admiten las fuentes Bluetooth vinculadas. Las fuentes pueden tener varios nombres, por lo que se admiten los nombres que los usuarios crean y descubren, así como los nombres predeterminados. Por ejemplo, “hdmi_1” también podría ser “Reproductor de DVD”, o bien “usb_1” también podría ser “Disco duro”.

Se pueden ordenar las entradas de medios para admitir los comandos "next" y "previous".

Al igual que con Toggles y Modes, los nombres de las entradas deben proporcionarse en todos los idiomas disponibles. Esto es especialmente relevante para los nombres predeterminados.

ATRIBUTOS DEL DISPOSITIVO

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 el manejo de 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 mediante cable o por red. Cada feed debe tener un nombre que sea razonablemente persistente. Asegúrese de definir sus sinónimos cuidadosamente para evitar la activación no deseada (sobreactiva).
[item, ...]	Objeto	Entrada disponible.
key	String	Obligatorio. Clave única para la entrada. La clave no se debe exponer a los usuarios en voz o respuesta.
names	Matriz	Obligatorio. Lista de nombres de la entrada para todos los idiomas disponibles.
[item, ...]	Objeto	Entrada para un idioma disponible determinado.
lang	String	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 utiliza en la respuesta de Asistente de Google al usuario.
[item, ...]	String	Nombre de la entrada.
commandOnlyInputSelector	Booleano	(Predeterminado: false) 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 QUERY o al estado de informe para esta característica.
orderedInputs	Booleano	(Predeterminado: false) Verdadero si la lista de resultados está ordenada. Esto también indica que están disponibles la función “next” y “previous”.

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 el manejo de intents QUERY, consulta Entrega de intents.

Estados	Tipo	Descripción
currentInput	String	Obligatorio. Clave de la entrada actualmente en uso.

Ejemplos

Dispositivo con entrada HDMI actualmente seleccionada.

{
  "currentInput": "hdmi_1"
}

Dispositivo COMMANDS

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 el manejo de intents EXECUTE, consulta Entrega de intents.

action.devices.commands.SetInput

Establece la entrada multimedia.

Parámetros

Parámetros	Tipo	Descripción
newInput	String	Obligatorio. Clave de la entrada nueva.

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.

Este comando requiere los siguientes atributos:

{
  "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.

Este comando requiere los siguientes atributos:

{
  "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

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.

unsupportedInput: Por el momento, no se admite la entrada.