Saiba como adicionar um leitor de código de barras ao seu aplicativo Tulip
Os leitores de código de barras são um mecanismo popular para identificar rapidamente diversos componentes no chão de fábrica.
A partir da versão r237 e LTS9, todos os leitores de código de barras podem se integrar ao Tulip (incluindo leitores de código de barras via Bluetooth) se estiverem:
- Configurados para terminar com um retorno de carro (tecla Enter)
- Isso pode ser verificado abrindo o Bloco de Notas em um dispositivo Windows ou um programa equivalente no seu sistema operacional. Leia um código de barras — se o cursor passar para uma nova linha após a leitura, você está pronto para usá-lo com o Tulip.
- Se o cursor não passar para uma nova linha, consulte o manual do seu leitor de código de barras e configure-o para terminar com um retorno de carro. Isso geralmente pode ser feito lendo um código de barras de configuração do manual do produto, mas, se tiver alguma dificuldade, entre em contato com o fabricante do seu leitor de código de barras.
- A partir das versões r332 e LTS15, o comprimento do código de barras que está sendo lido deve ser maior ou igual a 1 caractere.
- A detecção do código de barras é pausada se o elemento ativo em foco for um elemento de entrada, como uma caixa de texto, campo de entrada numérica etc.
Aqui está uma lista das plataformas do Player que oferecem suporte a esse novo comportamento de código de barras -
| Plataforma do Player | Compatível? |
|---|---|
| Player para desktop do Windows | Sim |
| Player para desktop do Mac | Sim |
| Reprodutor para celular Android | Sim |
| Reprodutor para navegador | Sim |
| Reprodutor EIO | Não |
| Reprodutor móvel para iOS | Sim |
Se você estiver usando uma versão anterior à LTS9 ou r237, consulte a seção abaixo.
O Tulip oferece dois métodos para escanear códigos de barras e códigos QR:
- Pela câmera embutida no seu dispositivo
- Por meio de um leitor físico de código de barras
Este artigo abordará o segundo método — o uso de um leitor físico de código de barras como um dispositivo no Tulip. A conexão dos leitores de código de barras pode variar dependendo de como você está executando o Tulip Player:
O Tulip é compatível com todos os leitores de código de barras que possam ser configurados para:
- Funcionar como um dispositivo de teclado HID
- Gerar uma nova linha após a leitura (ou sufixo de retorno de carro)
Para obter orientações adicionais sobre o diagnóstico de problemas com leitores de código de barras, consulte este guia
Tulip Player para Windows
O Windows Tulip Player oferece suporte pronto para uso a diversos leitores de código de barras, listados na Biblioteca de Dispositivos do Tulip.
Caso o leitor de código de barras não esteja listado na Biblioteca de Dispositivos, o Windows Tulip Player permite que os usuários conectem leitores de código de barras personalizados. Essa configuração é feita em cada Player individualmente, conforme a necessidade.
Para adicionar um leitor de código de barras personalizado, clique em “Ferramentas” na barra de navegação superior e, em seguida, selecione “Adicionar leitores de código de barras personalizados”.

A seguinte janela modal será exibida:

Nessa tela, o usuário poderá adicionar quantos leitores de código de barras desejar. No entanto, apenas um leitor deve ser usado por vez em cada computador que esteja executando o Player.
Cada leitor de código de barras adicionado deve incluir o seguinte
- Um nome
- Um ID do fornecedor
- Um ID de produto
O ID do fornecedor e o ID do produto podem ser inseridos no formato decimal (base 10) ou hexadecimal (base 16). Para forçar o ID do fornecedor e o ID do produto a serem hexadecimais, coloque “0x” antes do número.
Os IDs de fornecedor e de produto relevantes devem constar no manual do leitor de código de barras. Caso não consiga encontrá-los, use este guia para localizar os detalhes do dispositivo.
Por exemplo, se o seu leitor de código de barras tiver um VID de 0111, isso significa que ele usa o formato hexadecimal. Você precisará inseri-lo no Tulip como “0x0111”. Ou use este conversor para convertê-lo para o formato decimal.
Você deve clicar em “Salvar” para que seu novo dispositivo seja reconhecido pelo Tulip. Em seguida, você pode verificar se o leitor está funcionando ao escanear um código de barras. Se estiver funcionando, você verá um número de código de barras aparecer nesta tela.
NOTA: Ao retornar a esta página, o número será convertido para o formato decimal (base 10).
Exemplo

Reprodutores Tulip que não sejam do Windows
Para dispositivos Mac, Android e Tulip Web Player, ainda é possível usar leitores de código de barras conectados. Esses players não oferecem suporte a PIDs e VIDs personalizados, mas, desde que os leitores de código de barras atendam aos mesmos requisitos (HID de teclado, caractere de nova linha), eles funcionarão sem nenhuma configuração adicional.
This configuration was enabled by default for all instances in r232. If you're on a release pre-r232, reach out to support@tulip.co to enable.
Para configurar dispositivos Android da Zebra com leitores de código de barras integrados, consulte a Configuração do DataWedge para dispositivos Android da Zebra.
Dispositivos Edge
Caso o dispositivo físico que executa o Tulip Player não esteja disponível, os dispositivos de borda também podem ser usados para conectar leitores de código de barras ao Tulip. Assim como no Tulip Player para Windows, isso requer o fornecimento do VID e do PID do leitor.
Para habilitar, acesse o Edge Device Portal e, na lista de drivers, selecione USB-Barcode. Certifique-se de que o driver esteja habilitado e pressione o botão de mais para adicionar um novo leitor de código de barras.
Cada leitor de código de barras adicionado deve incluir o seguinte
- Um nome
- Um ID de fornecedor (base 10)
- Um ID de produto (base 10)
Depois que o código de barras for adicionado, pressione “Salvar”. Se o gatilho de leitura do código de barras estiver configurado para registrar a saída nesta “estação”, certifique-se de que o dispositivo Edge esteja atribuído à estação apropriada ao executar o aplicativo.

