Schema del trait del selettore di input per la smart home

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

Gli input multimediali possono avere nomi dinamici per dispositivo che rappresentano i feed audio o video. Questi feed possono essere cablate o connesse in rete, ma devono essere denominate ed essere ragionevolmente persistenti. Questo tratto non supporta feed temporanei arbitrari, come una libreria in rete disponibile per la ricerca. Associato, denominato Le sorgenti Bluetooth sono supportate. Le origini possono avere più nomi, quindi create e scoperte dall'utente oltre ai nomi predefiniti, ad esempio "hdmi_1" potrebbe essere anche "Lettore DVD", o "usb_1" potrebbe anche essere "Disco rigido".

Gli ingressi dei contenuti multimediali possono essere ordinati per supportare "next" e "precedente" tramite comandi SQL.

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

ATTRIBUTES dispositivo

I dispositivi con questo tratto potrebbero segnalare quanto segue nell'ambito dell'operazione SYNC. Per ulteriori informazioni scopri di più sulla gestione degli intent SYNC; consulta Completamento dell'intent.

Attributi Tipo Descrizione
availableInputs Array

Obbligatorio.

Elenco di oggetti che rappresentano feed audio o video di input. I feed possono essere cablati o in rete. Ogni feed deve essere denominato e ragionevolmente persistente. Assicurati di definire attentamente i sinonimi per evitare attivazioni indesiderate.

[item, ...] Oggetto

Input disponibile.

key String

Obbligatorio.

Chiave univoca per l'input. La chiave non deve essere esposta agli utenti durante il parlato o la 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 la comunicazione unidirezionale (vero) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a Segnalare lo stato per questo tratto.

orderedInputs Valore booleano

(Valore predefinito: false)

True se l'elenco di output è in ordine. Ciò indica anche che il comando "successivo" e "precedente" funzionalità di machine learning.

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 del dispositivo

Le entità con questo tratto possono segnalare quanto segue nell'ambito dell'operazione QUERY. Per ulteriori informazioni scopri di più sulla gestione degli intent QUERY; consulta Completamento dell'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 questo tratto potrebbero rispondere ai seguenti nell'ambito dell'operazione EXECUTE. Per ulteriori informazioni scopri di più sulla gestione degli intent EXECUTE; consulta Completamento dell'intent.

action.devices.commands.SetInput

Imposta l'input multimediale.

Parametri

Parametri Tipo Descrizione
newInput String

Obbligatorio.

Chiave del nuovo input.

Esempi

Seleziona 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 dispositivo

Consulta l'elenco completo errori ed eccezioni.

unsupportedInput: l'input non è attualmente supportato.