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