Schema del tratto InputSelector 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 in rete, ma devono essere denominati e ragionevolmente permanenti. Questo tratto non supporta feed effimeri arbitrari, ad esempio una raccolta in rete ricercabile. Sono supportate le fonti 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 "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.

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

Obbligatorio.

Elenco di oggetti che rappresentano i feed audio o video di input. I feed possono essere cablati o in rete. Ogni feed deve avere un nome e deve essere ragionevolmente persistente. Assicurati di definire attentamente i sinonimi per evitare attivazioni (sovra)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 per l'input, in una determinata lingua. Il primo sinonimo viene utilizzato nella risposta dell'Assistente Google all'utente.
[item, ...] String

Inserisci il nome.
commandOnlyInputSelector Valore booleano

(valore predefinito: false)

Indica se il dispositivo supporta la 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)

Vero se l'elenco di output è ordinato. 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 tratto 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 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.SetInput

Imposta l'input multimediale.

Parametri

Parametri Tipo Descrizione
newInput String

Obbligatorio.

Chiave del nuovo input.

Esempi

Seleziona 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": {}
}

Frasi di esempio

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.