Esquema de atributos de InputSelector de Smart Home

action.devices.traits.InputSelector: Este atributo se usa para 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 ser con cable o en red, pero deben tener un nombre y ser lo suficientemente persistentes. Esta característica no admite feeds efímeros arbitrarios, como una biblioteca conectada en red que se puede buscar. Se admiten fuentes Bluetooth vinculadas y con nombre. Las fuentes pueden tener varios nombres, por lo 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 puede ser "Disco duro".

Las entradas multimedia se pueden ordenar para admitir los comandos "siguiente" y "anterior".

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 cómo controlar los intents SYNC, consulta Entrega de intents.

Atributos Tipo Descripción
availableInputs Matriz

Obligatorio.

Es una lista de objetos que representan feeds de audio o video de entrada. Los feeds pueden ser con cable o en red. Cada feed debe tener un nombre y ser lo suficientemente persistente. Asegúrate de definir tus sinónimos con cuidado para evitar activaciones no deseadas (sobre).
[item, ...] Objeto

Entrada disponible.
key String

Obligatorio.

Clave única para la entrada. La clave no se debe exponer a los usuarios en voz ni respuesta.
names Matriz

Obligatorio.

Es la 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.

Son 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, ...] String

Ingresa un nombre.
commandOnlyInputSelector Booleano

(Predeterminado: false)

Indica si el dispositivo admite la comunicación unidireccional (verdadero) o bidireccional (falso). Establece este atributo como verdadero si el dispositivo no puede responder a un intent de QUERY o al estado de informe de esta característica.
orderedInputs Booleano

(Predeterminado: false)

Es verdadero si la lista de resultados está ordenada. Esto también indica que se encuentran disponibles las funciones "siguiente" y "anterior".

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
}

ESTADOS DEL DISPOSITIVO

Las entidades con este atributo pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo controlar intents QUERY, consulta Cómo entregar intents.

Estados Tipo Descripción
currentInput String

Obligatorio.

Es la clave de la entrada que se está usando.

Ejemplos

Hay un dispositivo con entrada HDMI seleccionado.

{
  "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 intents EXECUTE, consulta Cómo entregar 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

Cómo seleccionar la entrada USB

{
  "command": "action.devices.commands.SetInput",
  "params": {
    "newInput": "usb_1"
  }
}

action.devices.commands.NextInput

Selecciona la siguiente entrada. Solo es aplicable 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 es aplicable 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

ERRORES DE DISPOSITIVO

Consulta la lista completa de errores y excepciones.

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