Esquema de traço do AppSelector para casa inteligente

action.devices.traits.AppSelector: essa característica é usada em dispositivos que podem alternar entre aplicativos.

ATRIBUTOS do dispositivo

Dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre o gerenciamento de intents SYNC, consulte fulfillment de intents.

Atributos	Tipo	Descrição
availableApplications	Array	Obrigatório. Uma lista de aplicativos. Cada aplicativo tem um ou mais sinônimos em cada idioma compatível. O primeiro sinônimo é usado na resposta.
[item, ...]	Object	Aplicativo com que os usuários deste dispositivo podem interagir.
key	String	Obrigatório. Chave exclusiva para o aplicativo que não é exposta aos usuários em fala ou resposta.
names	Array	Obrigatório. Nome de cada app e sinônimos específicos do idioma.
[item, ...]	Object	Sinônimos de aplicativos.
name_synonym	Array	Obrigatório. Sinônimos fáceis de usar para o nome do aplicativo de determinado idioma. O primeiro sinônimo é usado na resposta.
[item, ...]	String	Nome do app.
lang	String	Obrigatório. Código do idioma.

Exemplos

Dispositivo com o app YouTube

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

STATES do dispositivo

Entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o gerenciamento de intents QUERY, consulte fulfillment de intents.

Estados	Tipo	Descrição
currentApplication	String	Obrigatório. Valor da chave do aplicativo atual que está ativo em primeiro plano.

Exemplos

Dispositivo com o app YouTube ativo em primeiro plano.

{
  "currentApplication": "YouTube"
}

Comandos do dispositivo

Dispositivos com essa característica podem responder aos seguintes comandos como parte da operação EXECUTE. Para saber mais sobre o gerenciamento de intents EXECUTE, consulte fulfillment de intents.

action.devices.commands.appInstall

Instale o aplicativo em questão.

Parâmetros

Parâmetros	Tipo	Descrição
newApplication	String	Chave do aplicativo a ser instalado.
newApplicationName	String	Nome do aplicativo a ser instalado.

Exemplos

Instalar o app YouTube por chave

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

Instalar o app YouTube pelo nome

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

action.devices.commands.appSearch

Pesquise o aplicativo em questão.

Parâmetros

Parâmetros	Tipo	Descrição
newApplication	String	Chave do aplicativo a ser pesquisado.
newApplicationName	String	Nome do app a ser pesquisado.

Exemplos

Pesquisar o app YouTube por chave

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

Pesquisar o app YouTube pelo nome

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

action.devices.commands.appSelect

Selecione o aplicativo em questão.

Parâmetros

Parâmetros	Tipo	Descrição
newApplication	String	Chave do aplicativo a ser selecionado.
newApplicationName	String	Nome do aplicativo a ser selecionado.

Exemplos

Selecionar o app YouTube por chave

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

Selecionar o app YouTube pelo nome

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

Exemplos de declarações

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

ERROS DO Dispositivo

Veja a lista completa de erros e exceções.

• noAvailableApp: o aplicativo não existe ou não está disponível.
• appLaunchFailed: falha ao iniciar o aplicativo.
• alreadyInstalledApp: o aplicativo já estava instalado.