Esquema de atributo InputSelector da casa inteligente

action.devices.traits.InputSelector: essa característica é usada para dispositivos que podem alternar entradas.

As entradas de mídia podem ter nomes dinâmicos por dispositivo que representam feeds de áudio ou vídeo. Esses feeds podem ser conectados por cabo ou em rede, mas precisam ser nomeados e razoavelmente persistentes. Essa característica não oferece suporte a feeds temporários arbitrários, como uma biblioteca em rede pesquisável. Há suporte para fontes Bluetooth nomeadas e pareadas. As origens podem ter vários nomes, portanto, há suporte para nomes criados e descobertos pelo usuário, bem como 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 encomendadas para oferecer suporte aos comandos "Próxima" e "Anterior".

Assim como em Toggles e Modes, os nomes das entradas precisam ser fornecidos em todos os idiomas disponíveis. Isso é especialmente relevante 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 como processar intents SYNC, consulte Fulfillment de intents.

Atributos Tipo Descrição
availableInputs Array

Obrigatório.

Lista de objetos que representam feeds de áudio ou vídeo de entrada. Os feeds podem ser conectados por cabo ou em rede. Cada feed precisa ser nomeado e pode ser razoavelmente persistente. Defina seus sinônimos com cuidado para evitar acionamentos indesejados.
[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 a comunicação unidirecional (verdadeiro) ou bidirecional (falso). Defina esse atributo como verdadeiro se o dispositivo não puder responder a uma intent de QUERY ou ao estado de 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óxima" 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
}

ESTADOS DO DISPOSITIVO

Entidades com essa característica podem informar os estados a seguir como parte da operação QUERY. Para saber mais sobre o processamento de intents QUERY, consulte Fulfillment de intents.

Estados Tipo Descrição
currentInput String

Obrigatório.

Chave da entrada atualmente em uso.

Exemplos

Dispositivo com entrada HDMI selecionada.

{
  "currentInput": "hdmi_1"
}

COMANDOS do dispositivo

Dispositivos com essa característica podem responder aos comandos a seguir como parte da operação EXECUTE. Para saber mais sobre como processar 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 entrada USB

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

action.devices.commands.NextInput

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

Este 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 somente quando o atributo orderedInputs está definido como verdadeiro.

Este 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 no dispositivo

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

unsupportedInput: a entrada não tem suporte no momento.