Te damos la bienvenida al Centro para desarrolladores de Google Home, el nuevo destino para aprender a desarrollar acciones para el hogar inteligente. Nota: Continuarás compilando acciones en la Consola de Actions.
Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Esquema de la característica de entrada inteligente del hogar

action.devices.traits.InputSelector: Esta característica se usa para los 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 por cable o en red, pero deben tener un nombre y ser bastante persistentes. Esta característica no admite feeds efímeros arbitrarios, como una biblioteca conectada en red que permite búsquedas. Se admiten fuentes Bluetooth con nombre. Las fuentes pueden tener varios nombres, de manera que se admiten nombres creados y descubiertos por el usuario, así como 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 pedir 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, en particular, para los nombres predeterminados.

ATTRIBUTES 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 entrada de audio o video. Los feeds se pueden conectar por cable o en red. Cada feed debe tener un nombre y ser bastante persistente. Asegúrese de definir sus sinónimos cuidadosamente para evitar la activación no deseada (en exceso).

[item, ...] Objeto

Entrada disponible.

key String

Obligatorio.

Clave única para la entrada. La clave no se debe exponer a los usuarios en voz ni en 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. Se usa el primer sinónimo en la respuesta del Asistente de Google al usuario.

[item, ...] String

Nombre de entrada.

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 del informe para esta característica.

orderedInputs Booleano

(Predeterminado: false)

Verdadero si la lista de resultados está ordenada. Esto también indica que las funcionalidades "siguiente" y "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

Los dispositivos 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 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

Configura la entrada multimedia.

Parámetros

Parámetros Tipo Descripción
newInput String

Obligatorio.

Clave de la entrada nueva.

Ejemplos

Selecciona la 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 está configurado 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 está configurado 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

  • cambia el modo de entrada a HDMI 1

es-ES

  • cambia a HDMI 1

fr-FR

  • Modo de activación HDMI1
  • Mets la télé sur HDMI 1 .

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.

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