Entradas Nomeadas
Entradas nomeadas são comandos que o PlayIt Live recebe de seus dispositivos externos. Cada entrada representa um sinal ou evento específico do hardware, como o pressionamento de um botão, a ativação de um sensor ou uma mudança de estado.
Ao criar uma entrada nomeada, você especifica:
- Hardware – O dispositivo de hardware configurado que enviará o comando.
- Nome da Entrada – Um nome descritivo exibido no PlayIt Live (ex.: «Botão de próxima faixa»).
- ID da Entrada – Um identificador único usado para acesso à API e registro (ex.: «BTN_NEXT»).
- Comando – A cadeia de texto exata que deve ser recebida do dispositivo para acionar esta entrada (ex.:
PLAY_NEXT\r\n).
Quando o PlayIt Live recebe dados do hardware que correspondem à cadeia de comando especificada, a entrada nomeada correspondente é acionada. Esse gatilho pode então executar ações por meio dos Gatilhos de entrada.
Configurar Entradas Nomeadas
Ao clicar em Adicionar Novo ou Editar na seção de Entradas Nomeadas, você configura as seguintes configurações:
Hardware
Selecione o dispositivo de hardware configurado que enviará este comando de entrada. A lista suspensa exibe todos os dispositivos de hardware que você configurou na seção Hardware. Você deve configurar pelo menos um dispositivo de hardware antes de criar entradas nomeadas.
Nome da Entrada
Um nome descritivo e legível para esta entrada que aparece em toda a interface do PlayIt Live. Esse nome é exibido ao criar gatilhos de entrada e ajuda a identificar o propósito de cada entrada.
ID da Entrada
Um identificador único usado para referenciar esta entrada em ações de eventos agendados, gatilhos e chamadas de API. Deve ser único entre todas as entradas nomeadas. Clique em Restaurar para gerar automaticamente um ID único com base no nome da entrada inserido.
Se você alterar o ID da entrada depois que ele já estiver sendo usado, todos os eventos agendados existentes ou itens do Playout Log que referenciam o ID de entrada antigo não funcionarão mais e deverão ser atualizados manualmente. Altere o ID da entrada apenas se for absolutamente necessário.
Configuração – Comando
O campo Comando contém a cadeia de texto exata que deve ser recebida do dispositivo de hardware para acionar esta entrada. Quando o PlayIt Live recebe dados do dispositivo que correspondem a essa cadeia de comando, a entrada nomeada correspondente é acionada.
Quando seu dispositivo externo (Arduino, painel de controle, etc.) envia dados ao PlayIt Live, esses dados são comparados com todos os comandos de entradas nomeadas configurados. Se uma correspondência for encontrada, a entrada é acionada e todos os gatilhos de entrada associados são executados.
Você pode incluir sequências de caracteres especiais para corresponder a caracteres não imprimíveis nos dados recebidos:
| Sequência | Caractere |
|---|---|
\r | Retorno de carro (CR) |
\n | Avanço de linha (LF) |
\t | Caractere de tabulação |
\\ | Barra invertida literal |
\xhh | Byte hexadecimal de 2 dígitos (ex.: \x0D) |
\uhhhh | Caractere Unicode de 4 dígitos |
Cada barra invertida deve ser precedida de escape como \\ ao digitar. Por exemplo, para corresponder à cadeia \COMMAND seguida de um retorno de carro e avanço de linha, digite: \\COMMAND\r\n
Correspondência de comandos
O comando deve corresponder exatamente para que a entrada seja acionada. Preste atenção a:
- Capitalização (a maioria dos sistemas diferencia maiúsculas de minúsculas)
- Finais de linha (
\r\nvs.\nvs. nenhum) - Caracteres de espaço em branco
- Quaisquer caracteres especiais ou sequências de escape