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 función AppSelector de casa inteligente

action.devices.traits.AppSelector: Esta característica se usa para los dispositivos que pueden cambiar de entrada.

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 manejar los intents SYNC, consulta Entrega de intents.

Atributos Tipo Descripción
availableApplications Matriz

Obligatorio.

Una lista de aplicaciones. Cada aplicación tiene uno o más sinónimos en cada idioma admitido. Se usa el primer sinónimo en la respuesta.

[item, ...] Objeto

Aplicación con la que pueden interactuar los usuarios de este dispositivo.

key String

Obligatorio.

Clave única para la aplicación que no se expone a los usuarios en voz o respuesta.

names Matriz

Obligatorio.

Nombre de cada aplicación y sus sinónimos específicos del idioma.

[item, ...] Objeto

Sinónimos de aplicaciones.

name_synonym Matriz

Obligatorio.

Sinónimos fáciles de usar para el nombre de la aplicación para un idioma determinado. Se usa el primer sinónimo en la respuesta.

[item, ...] String

Nombre de la aplicación.

lang String

Obligatorio.

Código de idioma.

Ejemplos

Dispositivo con la app de YouTube

{
  "availableApplications": [
    {
      "key": "youtube",
      "names": [
        {
          "name_synonym": [
            "YouTube",
            "YouTube US"
          ],
          "lang": "en"
        },
        {
          "name_synonym": [
            "YouTube",
            "YouTube DE"
          ],
          "lang": "de"
        }
      ]
    }
  ]
}

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

Estados Tipo Descripción
currentApplication String

Obligatorio.

La clave-valor de la aplicación actual que está activa en primer plano.

Ejemplos

Por el momento, el dispositivo con la app de YouTube está activo en primer plano.

{
  "currentApplication": "YouTube"
}

Dispositivo COMMAND

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 manejar los intents EXECUTE, consulta Entrega de intents.

action.devices.commands.appInstall

Instala la aplicación determinada.

Parámetros

Parámetros Tipo Descripción
newApplication String

Clave de la aplicación a instalar.

newApplicationName String

Nombre de la aplicación que se instalará.

Ejemplos

Instala la app de YouTube por clave

{
  "command": "action.devices.commands.appInstall",
  "params": {
    "newApplication": "YouTube"
  }
}

Instala la app de YouTube por nombre

{
  "command": "action.devices.commands.appInstall",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

action.devices.commands.appSearch

Busca la aplicación especificada.

Parámetros

Parámetros Tipo Descripción
newApplication String

La clave de la aplicación que se buscará.

newApplicationName String

Nombre de la aplicación que se buscará.

Ejemplos

Busca la app de YouTube por clave

{
  "command": "action.devices.commands.appSearch",
  "params": {
    "newApplication": "YouTube"
  }
}

Busca la app de YouTube por nombre

{
  "command": "action.devices.commands.appSearch",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

action.devices.commands.appSelect

Selecciona la aplicación determinada.

Parámetros

Parámetros Tipo Descripción
newApplication String

Clave de la aplicación que deseas seleccionar.

newApplicationName String

Nombre de la aplicación que se seleccionará.

Ejemplos

Selecciona la app de YouTube por clave.

{
  "command": "action.devices.commands.appSelect",
  "params": {
    "newApplication": "YouTube"
  }
}

Selecciona la app de YouTube por nombre.

{
  "command": "action.devices.commands.appSelect",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

Expresiones de muestra

de-DE

  • Öffne Netflix auf dem Fernseher .

en-US

  • begin using YouTube app on the smart TV

es-ES

  • pon netflix en la tele del salón

fr-FR

  • Mets Netflix sur la télé .

hi-IN

  • टीवी पर नेटफ्लिक्स ऍप लॉन्च करो

it-IT

  • Apri Netflix sulla televisione della mia camera .

ja-JP

  • YouTube のアプリを テレビ でスタート

ko-KR

  • TV 에서 유튜브 앱 열어 줘

nl-NL

  • Start Netflix op mijn TV .

pt-BR

  • Abra o Netflix na TV para mim.
  • Abre o Youtube na televisão .

sv-SE

  • Öppna Youtube TV:n

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.
  • noAvailableApp: La aplicación no existe o no está disponible.
  • appLaunchFailed: No se pudo iniciar la aplicación.
  • alreadyInstalledApp: La aplicación ya estaba instalada.