Esquema de atributos de AppSelector de Smart Home

action.devices.traits.AppSelector: Esta característica se usa para dispositivos que pueden alternar entre aplicaciones.

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 intents SYNC, consulta Cómo entregar 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	Es la aplicación con la que pueden interactuar los usuarios de este dispositivo.
key	String	Obligatorio. Es una clave única para la aplicación que no se expone a los usuarios en la voz o la respuesta.
names	Matriz	Obligatorio. Es el nombre de cada aplicación y sus sinónimos específicos de idioma.
[item, ...]	Objeto	Sinónimos de la aplicación.
name_synonym	Matriz	Obligatorio. Son sinónimos fáciles de usar para el nombre de la aplicación de un idioma determinado. Se usa el primer sinónimo en la respuesta.
[item, ...]	String	Es el 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"
        }
      ]
    }
  ]
}

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
currentApplication	String	Obligatorio. Es el valor clave de la aplicación actual que está activa en primer plano.

Ejemplos

Dispositivo con la app de YouTube activa en primer plano.

{
  "currentApplication": "YouTube"
}

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.appInstall

Instala la aplicación determinada.

Parámetros

Parámetros	Tipo	Descripción
newApplication	String	Clave de la aplicación que se instalará.
newApplicationName	String	Es el nombre de la aplicación que se instalará.

Ejemplos

Cómo instalar la app de YouTube por clave

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

Cómo instalar la app de YouTube por nombre

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

action.devices.commands.appSearch

Busca la aplicación determinada.

Parámetros

Parámetros	Tipo	Descripción
newApplication	String	Es la clave de la aplicación que se busca.
newApplicationName	String	Es el nombre de la aplicación que se buscará.

Ejemplos

Cómo buscar la app de YouTube por clave

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

Cómo buscar la app de YouTube por nombre

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

action.devices.commands.appSelect

Selecciona la aplicación en cuestión.

Parámetros

Parámetros	Tipo	Descripción
newApplication	String	Clave de la aplicación que se debe seleccionar.
newApplicationName	String	Es el nombre de la aplicación que se debe seleccionar.

Ejemplos

Cómo seleccionar la app de YouTube por clave

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

Cómo seleccionar 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 på TV:n

ERRORES del dispositivo

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.