Schema delle caratteristiche AppSelector per la smart home

action.devices.traits.AppSelector: questa caratteristica viene utilizzata per i dispositivi in grado di passare da un'applicazione all'altra.

ATTRIBUTES del dispositivo

I dispositivi con questo trait potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta fulfillment dell'intent.

Attributi	Tipo	Descrizione
availableApplications	Matrice	Obbligatorio. Un elenco di applicazioni. Ogni applicazione contiene 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 nella voce o nella risposta.
names	Matrice	Obbligatorio. Nome di ogni applicazione e relativi sinonimi specifici per la lingua.
[item, ...]	Oggetto	Sinonimi dell'applicazione.
name_synonym	Matrice	Obbligatorio. Sinonimi intuitivi del 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 app YouTube

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

Dispositivo STATES

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

Stati	Tipo	Descrizione
currentApplication	String	Obbligatorio. Valore chiave dell'applicazione corrente attiva in primo piano.

Esempi

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

{
  "currentApplication": "YouTube"
}

COMMANDS dispositivo

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

action.devices.commands.appInstall

Installa 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 per 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	Il nome dell'applicazione da cercare.

Esempi

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

Parametri

Parametri	Tipo	Descrizione
newApplication	String	Chiave dell'applicazione da selezionare.
newApplicationName	String	Il nome dell'applicazione da selezionare.

Esempi

Seleziona l'app YouTube per chiave

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

Seleziona l'app YouTube per nome

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

Espressioni 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

ERRORS 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 è già stata installata.