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.