Schema del trait del selettore di input per la smart home

action.devices.traits.InputSelector: questo attributo viene utilizzato per i dispositivi in grado di cambiare input.

Gli ingressi multimediali possono avere nomi dinamici per dispositivo che rappresentano feed audio o video. Questi feed possono essere cablati o collegati in rete, ma devono avere un nome e devono essere ragionevolmente persistenti. Questo attributo non supporta feed effimeri arbitrari, ad esempio una raccolta in rete ricercabile. Sono supportate le sorgenti Bluetooth accoppiate e con nome. Le sorgenti possono avere più nomi, quindi sono supportati i nomi creati e scoperti dall'utente, nonché i nomi predefiniti. Ad esempio, "hdmi_1" potrebbe anche essere "Lettore DVD" o "usb_1" potrebbe anche essere "Hard disk".

Gli ingressi multimediali possono essere ordinati in modo da supportare i comandi "Avanti" 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.

ATTRIBUTI del dispositivo

I dispositivi con questo tratto potrebbero 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
availableInputs Array

Obbligatorio.

Elenco di oggetti che rappresentano i feed audio o video di input. I feed possono essere collegati tramite cavo o in rete. Ogni feed deve essere denominato e ragionevolmente persistente. Assicurati di definire attentamente i sinonimi per evitare attivazioni indesiderate.
[item, ...] Oggetto

Input disponibili.
key String

Obbligatorio.

Chiave univoca per l'input. La chiave non deve essere esposta agli utenti nel parlato 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 String

Obbligatorio.

Codice lingua.
name_synonym Array

Obbligatorio.

Nomi intuitivi dell'input, in una determinata lingua. Il primo sinonimo viene utilizzato nella risposta dell'Assistente Google all'utente.
[item, ...] String

Nome input.
commandOnlyInputSelector Valore booleano

(Valore predefinito: false)

Indica se il dispositivo supporta l'utilizzo della comunicazione unidirezionale (true) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intento QUERY o a uno stato Report per questa caratteristica.
orderedInputs Valore booleano

(Valore predefinito: false)

True se l'elenco di output è in ordine. Inoltre, indica che le funzionalità "Avanti" e "Indietro" sono disponibili.

Esempi

Dispositivo con due input 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
}

STATI del dispositivo

Le entità con questo attributo 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
currentInput String

Obbligatorio.

Chiave dell'input attualmente in uso.

Esempi

Dispositivo con ingresso HDMI attualmente selezionato.

{
  "currentInput": "hdmi_1"
}

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

Imposta l'input multimediale.

Parametri

Parametri Tipo Descrizione
newInput String

Obbligatorio.

Chiave del nuovo input.

Esempi

Selezionare l'ingresso USB

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

action.devices.commands.NextInput

Seleziona l'input 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 enunciato

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 di errori ed eccezioni.

unsupportedInput: l'input non è attualmente supportato.