Esquema do traço do seletor de entrada da casa inteligente

action.devices.traits.InputSelector: essa característica é usada para dispositivos capazes de alternar entre entradas.

As entradas de mídia podem ter nomes dinâmicos por dispositivo que representam feeds de áudio ou vídeo. Esses feeds podem ter fio ou ser conectados em rede, mas precisam ser nomeados e razoavelmente persistentes. Essa característica não é compatível com feeds temporários arbitrários, como uma biblioteca em rede pesquisável. Fontes Bluetooth pareadas e nomeadas são compatíveis. As origens podem ter vários nomes. Portanto, nomes criados e descobertos pelo usuário são aceitos, além de nomes padrão. Por exemplo, "hdmi_1" também pode ser "DVD player", ou "usb_1" também pode ser "disco rígido".

As entradas de mídia podem ser ordenadas para oferecer suporte aos comandos "next" e "previous".

Assim como em Toggles e Modes, os nomes das entradas precisam ser fornecidos em todos os idiomas disponíveis. Isso é relevante principalmente para nomes padrão.

ATRIBUTOS do dispositivo

Dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre o gerenciamento de intents SYNC, consulte fulfillment de intents.

Atributos Tipo Descrição
availableInputs Array

Obrigatório.

Lista de objetos que representam feeds de entrada de áudio ou vídeo. Os feeds podem ser conectados por cabo ou em rede. Cada feed deve ser nomeado e razoavelmente persistente. Defina seus sinônimos com cuidado para evitar acionamento indesejado (em excesso).

[item, ...] Object

Entrada disponível.

key String

Obrigatório.

Chave exclusiva para a entrada. A chave não deve ser exposta aos usuários em fala ou resposta.

names Array

Obrigatório.

Lista de nomes da entrada para todos os idiomas disponíveis.

[item, ...] Object

Entrada para um determinado idioma disponível.

lang String

Obrigatório.

Código do idioma.

name_synonym Array

Obrigatório.

Nomes fáceis de usar para a entrada, em um determinado idioma. O primeiro sinônimo é usado na resposta do Google Assistente ao usuário.

[item, ...] String

Nome da entrada.

commandOnlyInputSelector Booleano

Padrão: false.

Indica se o dispositivo oferece suporte ao uso de comunicação unidirecional (verdadeiro) ou bidirecional (falso). Defina esse atributo como verdadeiro se o dispositivo não puder responder a uma intent QUERY ou ao estado do relatório dessa característica.

orderedInputs Booleano

Padrão: false.

Verdadeiro se a lista de saída estiver ordenada. Isso também indica que as funcionalidades "próximo" e "anterior" estão disponíveis.

Exemplos

Dispositivo com duas entradas ordenadas.

{
  "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 do dispositivo

Entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o gerenciamento de intents QUERY, consulte fulfillment de intents.

Estados Tipo Descrição
currentInput String

Obrigatório.

Chave da entrada em uso no momento.

Exemplos

Dispositivo com entrada HDMI selecionado no momento.

{
  "currentInput": "hdmi_1"
}

Comandos do dispositivo

Dispositivos com essa característica podem responder aos seguintes comandos como parte da operação EXECUTE. Para saber mais sobre o gerenciamento de intents EXECUTE, consulte fulfillment de intents.

action.devices.commands.SetInput

Define a entrada de mídia.

Parâmetros

Parâmetros Tipo Descrição
newInput String

Obrigatório.

Chave da nova entrada.

Exemplos

Selecionar a entrada USB

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

action.devices.commands.NextInput

Selecione a próxima entrada. Aplicável apenas quando o atributo orderedInputs está definido como verdadeiro.

Esse comando requer os seguintes atributos:
{
  "orderedInputs": true
}

Parâmetros

Parâmetros Tipo Descrição

Não há propriedades

Exemplos

Nenhum parâmetro

{
  "command": "action.devices.commands.NextInput",
  "params": {}
}

action.devices.commands.PreviousInput

Selecione a entrada anterior. Aplicável apenas quando o atributo orderedInputs está definido como verdadeiro.

Esse comando requer os seguintes atributos:
{
  "orderedInputs": true
}

Parâmetros

Parâmetros Tipo Descrição

Não há propriedades

Exemplos

Nenhum parâmetro

{
  "command": "action.devices.commands.PreviousInput",
  "params": {}
}

Exemplos de declarações

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

ERROS DO Dispositivo

Veja a lista completa de erros e exceções.

unsupportedInput: a entrada não é aceita no momento.