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 tratto di input della smart home

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

Gli input multimediali possono avere nomi dinamici per dispositivo che rappresentano feed audio o video. Questi feed possono essere collegati in rete o tramite cavo, ma devono avere un nome e un permanente. Questa caratteristica non supporta i feed temporanei arbitrari, ad esempio una libreria con possibilità di ricerca in rete. Sono supportate origini Bluetooth accoppiate con nome. Le origini possono avere più nomi, pertanto sono supportati sia i nomi creati dall'utente che quelli rilevati, nonché i nomi predefiniti. Ad esempio, "hdmi_1" potrebbe anche essere "DVD player" o "usb_1" potrebbe anche essere "Disco rigido".

Gli input multimediali possono essere ordinati per supportare i comandi "successivo" e "precedente".

Come per Toggles e Modes, i nomi degli input devono essere forniti in tutte le lingue disponibili; questo è particolarmente importante per i nomi predefiniti.

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
availableInputs Array

Obbligatorio.

Elenco di oggetti che rappresentano i feed audio o video di input. I feed possono essere collegati in rete o tramite cavo. Ogni feed deve avere un nome e un nome ragionevolmente persistente. Assicurati di definire attentamente i sinonimi per evitare l'attivazione indesiderata.

[item, ...] Oggetto

Input disponibile.

key Stringa

Obbligatorio.

Chiave univoca per l'input. La chiave non deve essere esposta agli utenti nella voce o nella risposta.

names Array

Obbligatorio.

Elenco di nomi per l'input per tutte le lingue disponibili.

[item, ...] Oggetto

Input per una determinata lingua disponibile.

lang Stringa

Obbligatorio.

Codice lingua.

name_synonym Array

Obbligatorio.

Nomi facili da usare per l'input, in una determinata lingua. Il primo sinonimo viene utilizzato nella risposta dell'Assistente Google all'utente.

[item, ...] Stringa

Nome inserito.

commandOnlyInputSelector Booleano

(Valore predefinito: false)

Indica se il dispositivo supporta la comunicazione unidirezionale (vero) o bidirezionale (falso). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a uno stato del report per questa caratteristica.

orderedInputs Booleano

(Valore predefinito: false)

True se l'elenco di output è ordinato. Questo indica anche che sono disponibili le funzionalità "Prossimo" e "Precedente".

Esempi

Dispositivo con due ingressi ordinati.

{
  "availableInputs": [
    {
      "key": "hdmi_1",
      "names": [
        {
          "lang": "en",
          "name_synonym": [
            "HDMI 1",
            "1st HDMI",
            "DVD Player"
          ]
        },
        {
          "lang": "de",
          "name_synonym": [
            "HDMI 1",
            "Zuerst HDMI",
            "DVD Spieler"
          ]
        }
      ]
    },
    {
      "key": "usb_1",
      "names": [
        {
          "lang": "en",
          "name_synonym": [
            "USB 1",
            "First USB",
            "Hard Drive"
          ]
        },
        {
          "lang": "de",
          "name_synonym": [
            "USB 1",
            "Zuerst USB",
            "Festplatte"
          ]
        }
      ]
    }
  ],
  "orderedInputs": true
}

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
currentInput Stringa

Obbligatorio.

Chiave dell'ingresso attualmente in uso.

Esempi

Dispositivo con ingresso HDMI attualmente selezionato.

{
  "currentInput": "hdmi_1"
}

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

Imposta l'input multimediale.

Parametri

Parametri Tipo Descrizione
newInput Stringa

Obbligatorio.

Tasto del nuovo input.

Esempi

Seleziona ingresso USB

{
  "command": "action.devices.commands.SetInput",
  "params": {
    "newInput": "usb_1"
  }
}

action.devices.commands.NextInput

Seleziona l'ingresso successivo. Applicabile solo quando l'attributo orderedInputs è impostato su true.

Questo comando richiede i seguenti attributi:
{
  "orderedInputs": true
}

Parametri

Parametri Tipo Descrizione

Nessuna proprietà

Esempi

Nessun parametro

{
  "command": "action.devices.commands.NextInput",
  "params": {}
}

action.devices.commands.PreviousInput

Seleziona l'input precedente. Applicabile solo quando l'attributo orderedInputs è impostato su true.

Questo comando richiede i seguenti attributi:
{
  "orderedInputs": true
}

Parametri

Parametri Tipo Descrizione

Nessuna proprietà

Esempi

Nessun parametro

{
  "command": "action.devices.commands.PreviousInput",
  "params": {}
}

Esempi di frasi

de-DE

  • Ändere den Eingangskanal auf AUX .

en-US

  • change input mode to HDMI 1

es-ES

  • cambia a hdmi 1

fr-FR

  • Activation du mode HDMI1 .
  • Mets la télé sur HDMI 1 .

hi-IN

  • टीवी की इनपुट HDMI 1 में स्विच करो

it-IT

  • metti ingresso aux sulla tv

ja-JP

  • テレビ HDMI1 にして

ko-KR

  • TV HDMI 1 로 바꿔 줘

nl-NL

  • zet de TV op bluetooth

pt-BR

  • Muda a entrada da TV para HDMI2 .
  • mudar a entrada para AUX

sv-SE

  • Sätt på hdmi 1

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.

unsupportedInput: l'input non è attualmente supportato.