Schema del tratto di selezione delle app per la smart home

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

ATTRIBUTI dispositivo

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

Attributi Tipo Descrizione
availableApplications Array

Obbligatorio.

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

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

Obbligatorio.

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

Obbligatorio.

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

Sinonimi dell'applicazione.
name_synonym Array

Obbligatorio.

Sinonimi intuitivi 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 questo tratto possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per saperne di più sulla gestione degli intent QUERY, consulta Completamento 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 potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per saperne di più sulla gestione degli intent EXECUTE, consulta Completamento degli intent.

action.devices.commands.appInstall

Installa l'applicazione fornita.

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

Parametri

Parametri Tipo Descrizione
newApplication String

Chiave dell'applicazione da cercare.
newApplicationName String

Nome dell'applicazione da cercare.

Esempi

Cercare l'app YouTube tramite tasto

{
  "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 tasto

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

Seleziona l'app YouTube per nome

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

Esempi di frasi

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

ERRORI del dispositivo

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