Ti diamo il benvenuto nel Centro sviluppatori Google Home, la nuova destinazione per imparare a sviluppare azioni per la smart home. Nota:continuerai a creare azioni nella Console Actions.
Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Schema trattino selettore Smart Home

action.devices.traits.AppSelector: questa caratteristica è usata per i dispositivi che possono cambiare ingresso.

ATTRIBUTE del dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti attributi come parte dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Soddisfazione 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 possono interagire con questo dispositivo.

key Stringa

Obbligatorio.

Chiave univoca per l'applicazione che non è esposta agli utenti nella sintesi vocale o nella risposta.

names Array

Obbligatorio.

Nome di ogni applicazione e relativi sinonimi specifici per la lingua.

[item, ...] Oggetto

Sinonimi dell'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, ...] Stringa

Nome applicazione.

lang Stringa

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

STATEs 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 Soddisfazione degli intent.

Stati Tipo Descrizione
currentApplication Stringa

Obbligatorio.

Valore chiave dell'applicazione corrente attivo in primo piano.

Esempi

Dispositivo con app YouTube attualmente attivo 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 Soddisfazione degli intent.

action.devices.commands.appInstall

Installa l'applicazione specificata.

Parametri

Parametri Tipo Descrizione
newApplication Stringa

Chiave dell'applicazione da installare.

newApplicationName Stringa

Nome dell'applicazione da installare.

Esempi

Installare l'app YouTube in base alle chiavi

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

Installare l'app YouTube in base al nome

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

action.devices.commands.appSearch

Cerca l'applicazione specificata.

Parametri

Parametri Tipo Descrizione
newApplication Stringa

Chiave dell'applicazione da cercare.

newApplicationName Stringa

Nome dell'applicazione da cercare.

Esempi

Cercare l'app YouTube in base alla 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 specificata.

Parametri

Parametri Tipo Descrizione
newApplication Stringa

Chiave dell'applicazione da selezionare.

newApplicationName Stringa

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

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 TV:n

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.
  • noAvailableApp: l'applicazione non esiste o non è disponibile.
  • appLaunchFailed: avvio dell'applicazione non riuscito.
  • alreadyInstalledApp: l'applicazione è già stata installata.