Schema del tratto AppSelector per la smart home

action.devices.traits.AppSelector: questo attributo viene utilizzato per i dispositivi in grado di passare da un'applicazione all'altra.

ATTRIBUTI del dispositivo

I dispositivi con questa caratteristica possono segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Adempimento degli intent.

Attributi Tipo Descrizione
availableApplications Array

Obbligatorio.

Un elenco di applicazioni. Ogni applicazione ha uno o più sinonimi in ogni lingua supportata. Il primo sinonimo viene utilizzato nella risposta.
[item, ...] Oggetto

Applicazione con cui gli utenti di questo dispositivo possono interagire.
key String

Obbligatorio.

Chiave univoca per l'applicazione che non è esposta agli utenti nel parlato o nella risposta.
names Array

Obbligatorio.

Nome di ogni applicazione e relativi sinonimi specifici per lingua.
[item, ...] Oggetto

Sinonimi di applicazione.
name_synonym Array

Obbligatorio.

Sinonimi facili da usare per il nome dell'applicazione per una determinata lingua. Nella risposta viene utilizzato il primo sinonimo.
[item, ...] String

Nome dell'applicazione.
lang String

Obbligatorio.

Codice lingua.

Esempi

Dispositivo con l'app YouTube

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

STATI del dispositivo

Le entità con questa caratteristica possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta Adempimento degli intent.

Stati Tipo Descrizione
currentApplication String

Obbligatorio.

Valore della chiave dell'applicazione corrente attiva in primo piano.

Esempi

Dispositivo con l'app YouTube attualmente attiva in primo piano.

{
  "currentApplication": "YouTube"
}

COMANDI del dispositivo

I dispositivi con questa caratteristica possono rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta Adempimento degli intent.

action.devices.commands.appInstall

Installa l'applicazione indicata.

Parametri

Parametri Tipo Descrizione
newApplication String

Chiave dell'applicazione da installare.
newApplicationName String

Nome dell'applicazione da installare.

Esempi

Installare l'app YouTube tramite chiave

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

Installare l'app YouTube per nome

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

action.devices.commands.appSearch

Cerca l'applicazione indicata.

Parametri

Parametri Tipo Descrizione
newApplication String

Chiave dell'applicazione da cercare.
newApplicationName String

Nome dell'applicazione da cercare.

Esempi

Cercare l'app YouTube per chiave

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

Cercare l'app YouTube per nome

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

action.devices.commands.appSelect

Seleziona l'applicazione indicata.

Parametri

Parametri Tipo Descrizione
newApplication String

Chiave dell'applicazione da selezionare.
newApplicationName String

Nome dell'applicazione da selezionare.

Esempi

Selezionare l'app YouTube tramite chiave

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

Selezionare l'app YouTube per nome

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

Frasi di esempio

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

ERRORI del dispositivo

Consulta l'elenco completo di errori ed eccezioni.
  • noAvailableApp: l'applicazione non esiste o non è disponibile.
  • appLaunchFailed: l'applicazione non è stata avviata.
  • alreadyInstalledApp: l'applicazione era già installata.