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 questo tratto potrebbero 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. 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 è 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. Il primo sinonimo viene utilizzato nella risposta.
[item, ...] String

Nome dell'applicazione.
lang String

Obbligatorio.

Codice lingua.

Esempi

Dispositivo con app YouTube

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

STATES del dispositivo

Le entità con questo attributo possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta Completamento dell'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 questo tratto potrebbero 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

Installare l'applicazione specificata.

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"
  }
}

Cerca l'app YouTube per nome

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

action.devices.commands.appSelect

Seleziona l'applicazione specifica.

Parametri

Parametri Tipo Descrizione
newApplication String

Chiave dell'applicazione da selezionare.
newApplicationName String

Nome dell'applicazione da selezionare.

Esempi

Selezionare l'app YouTube in base alla chiave

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

Selezionare l'app YouTube in base al nome

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

Frasi di esempio

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: l'applicazione non è stata avviata.
  • alreadyInstalledApp: l'applicazione era già installata.