Esquema de características do seletor de entrada para casa inteligente
action.devices.traits.InputSelector
: essa característica é usada para dispositivos que conseguem 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 ter fio ou rede, mas precisam ter nomes e ser razoavelmente permanentes. Essa característica não é compatível com feeds temporários temporários, como uma biblioteca em rede pesquisável. Origens Bluetooth pareadas e nomeadas são aceitas. As fontes podem ter vários nomes. Portanto, os nomes criados e descobertos pelo usuário são compatíveis, bem como nomes padrão. Por exemplo, "hdmi_1" também pode ser "DVD player", ou "usb_1" também pode ser "Hard drive".
As entradas de mídia podem ser ordenadas para suportar comandos "próximo" e "anterior".
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 como processar intents SYNC
, consulte
fulfillment de intent.
Atributos | Tipo | Descrição |
---|---|---|
availableInputs |
Array |
Obrigatório. Lista de objetos que representam entradas de áudio ou vídeo de entrada. Os feeds podem ter fio ou rede. Cada feed precisa ser nomeado e razoavelmente persistente. Defina os sinônimos com cuidado para evitar o acionamento indesejado. |
[item, ...] |
Object |
Entrada disponível. |
key |
String |
Obrigatório. Chave exclusiva para a entrada. A chave não pode ser exposta aos usuários na fala ou resposta. |
names |
Array |
Obrigatório. Lista de nomes de 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: Indica se o dispositivo suporta o 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 a um estado de relatório para essa característica. |
orderedInputs |
Booleano |
Padrão: Verdadeiro se a lista de saída for ordenada. Isso também indica que a funcionalidade "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 relatar os estados
a seguir como parte da operação QUERY
. Para saber
mais sobre como processar intents QUERY
, consulte
fulfillment de intent.
Estados | Tipo | Descrição |
---|---|---|
currentInput |
String |
Obrigatório. Chave da entrada em uso no momento. |
Exemplos
Dispositivo com entrada HDMI selecionado.
{ "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 como processar intents EXECUTE
, consulte
fulfillment de intent.
action.devices.commands.SetInput
Defina 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
Selecione a próxima entrada. Aplicável somente quando o atributo orderedInputs
está definido como verdadeiro.
{ "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.
{ "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é surHDMI 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 opbluetooth
pt-BR
-
Muda a entrada da
TV paraHDMI2 . -
mudar a entrada para
AUX
sv-SE
-
Sätt på
hdmi 1
Dispositivo ERRORS
Veja a lista completa de erros e exceções.unsupportedInput
: a entrada não é compatível no momento.