Esquema de atributo do AppSelector da Casa inteligente

action.devices.traits.AppSelector: essa característica é usada 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 o processamento 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 com suporte. O primeiro sinônimo é usado na resposta.
[item, ...] Object

Aplicativo com o qual os usuários deste dispositivo podem interagir.
key String

Obrigatório.

Chave exclusiva do aplicativo que não é exposta aos usuários em fala ou resposta.
names Array

Obrigatório.

Nome de cada aplicativo e sinônimos específicos do idioma.
[item, ...] Object

Sinônimos do aplicativo.
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 aplicativo.
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

As entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o processamento 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 comandos abaixo como parte da operação EXECUTE. Para saber mais sobre o processamento de intents EXECUTE, consulte Fulfillment de intents.

action.devices.commands.appInstall

Instale o aplicativo.

Parâmetros

Parâmetros Tipo Descrição
newApplication String

Chave do aplicativo a ser instalada.
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 indicado.

Parâmetros

Parâmetros Tipo Descrição
newApplication String

Chave do app a ser pesquisada.
newApplicationName String

Nome do aplicativo 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 selecionada.
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-DEen-USes-ESfr-FRhi-INit-ITja-JPko-KRnl-NLpt-BRsv-SE
  • Öffne Netflix auf dem Fernseher .
  • begin using YouTube app on the smart TV
  • pon netflix en la tele del salón
  • Mets Netflix sur la télé .
  • टीवी पर नेटफ्लिक्स ऍप लॉन्च करो
  • Apri Netflix sulla televisione della mia camera .
  • YouTube のアプリを テレビ でスタート
  • TV 에서 유튜브 앱 열어 줘
  • Start Netflix op mijn TV .
  • Abra o Netflix na TV para mim.
  • Abre o Youtube na televisão .
  • Ö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: o aplicativo não foi iniciado.
  • alreadyInstalledApp: o aplicativo já foi instalado.