Esquema de traço do AppSelector da casa inteligente

action.devices.traits.AppSelector: usado para 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 como processar intents SYNC, consulte Fulfillment de intent.

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 do aplicativo que não é exposta aos usuários na fala ou na resposta.
names Array

Obrigatório.

Nome de cada aplicativo e os 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 em um 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"
        }
      ]
    }
  ]
}

ESTADOS DO DISPOSITIVO

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

Estados Tipo Descrição
currentApplication String

Obrigatório.

Valor da chave do aplicativo atual 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 como processar intents EXECUTE, consulte Fulfillment de intent.

action.devices.commands.appInstall

Instale o aplicativo especificado.

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 por nome

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

action.devices.commands.appSearch

Pesquise o aplicativo especificado.

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.

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 por 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

Confira a lista completa de erros e exceções.
  • noAvailableApp: o aplicativo não existe ou não está disponível.
  • appLaunchFailed: não foi possível iniciar o aplicativo.
  • alreadyInstalledApp: o aplicativo já estava instalado.