Schema delle caratteristiche InputSelector per la smart home

action.devices.traits.InputSelector: questa trait viene utilizzata per i dispositivi in grado di cambiare ingresso.

Gli input 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 avere un nome ragionevolmente permanente. Questa trait non supporta feed temporanei arbitrari, ad esempio una libreria in rete disponibile per la ricerca. Sono supportate origini Bluetooth accoppiate con nome. Le origini possono avere più nomi, pertanto sono supportati anche i nomi creati e rilevati dagli utenti, oltre ai nomi predefiniti; ad esempio, "hdmi_1" potrebbe essere anche "Lettore DVD" o "usb_1" potrebbe essere anche "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; ciò è particolarmente pertinente per i nomi predefiniti.

ATTRIBUTES del dispositivo

I dispositivi con questo trait potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta fulfillment dell'intent.

Attributi Tipo Descrizione
availableInputs Matrice

Obbligatorio.

Elenco di oggetti che rappresentano feed audio o video di input. I feed possono essere cablati o collegati in rete. Ogni feed deve avere un nome e deve essere ragionevolmente permanente. Assicurati di definire attentamente i sinonimi per evitare attivazioni indesiderate (eccessive).
[item, ...] Oggetto

Input disponibile.
key String

Obbligatorio.

Chiave univoca per l'input. La chiave non deve essere esposta agli utenti nel parlato o nella risposta.
names Matrice

Obbligatorio.

Elenco di nomi per l'input per tutte le lingue disponibili.
[item, ...] Oggetto

Inserisci l'input per una determinata lingua disponibile.
lang String

Obbligatorio.

Codice lingua.
name_synonym Matrice

Obbligatorio.

Nomi semplici 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 Booleano

(Valore predefinito: false)

Indica se il dispositivo supporta l'uso di una comunicazione unidirezionale (true) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a uno stato del report per questo trait.
orderedInputs Booleano

(Valore predefinito: false)

True se l'elenco di output è ordinato. Questo indica inoltre che sono disponibili le funzionalità "successivo" e "precedente".

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
}

Dispositivo STATES

Le entità con questo trait possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta fulfillment dell'intent.

Stati Tipo Descrizione
currentInput String

Obbligatorio.

Tasto dell'input attualmente in uso.

Esempi

Dispositivo con ingresso HDMI attualmente selezionato.

{
  "currentInput": "hdmi_1"
}

COMMANDS dispositivo

I dispositivi con questa caratteristica potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta fulfillment dell'intent.

action.devices.commands.SetInput

Imposta l'input multimediale.

Parametri

Parametri Tipo Descrizione
newInput String

Obbligatorio.

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

Espressioni 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

ERRORS dispositivo

Consulta l'elenco completo di errori ed eccezioni.

unsupportedInput: l'input non è attualmente supportato.