Integrar QR ou capacidade de leitura de código de barras

Artigo
06/24/2024

Código de barras é um método de representação de dados em um formato visual e legível por computador. O código de barras contém informações sobre um produto, como um tipo, tamanho, fabricante e País ou região de origem sob a forma de barras e espaços. O código é lido usando o scanner óptico na câmera nativa do dispositivo. Para obter uma experiência colaborativa mais avançada, você pode integrar a funcionalidade de scanner de código de barras ou QR fornecida na plataforma Teams ao seu aplicativo Teams.

Pode utilizar a biblioteca de cliente JavaScript do Microsoft Teams, que fornece as ferramentas necessárias para que a sua aplicação aceda às capacidades nativas do dispositivo do utilizador. Use a API scanBarCode para integrar o recurso de scanner em seu aplicativo.

Vantagem de integrar a funcionalidade do scanner de código de barras ou QR

A seguir estão as vantagens da integração dos recursos de QR ou scanner de código de barras:

A integração permite que os programadores de aplicações Web na plataforma Teams tirem partido da funcionalidade de análise de códigos de barras ou QR com a biblioteca de cliente JavaScript do Teams.
Com esse recurso, o usuário só precisa alinhar um QR ou código de barras dentro de um quadro no centro da interface do usuário do scanner e o código é verificado automaticamente. Os dados armazenados são compartilhados novamente com o aplicativo Web de chamada. Isso evita o inconveniente e os erros humanos de inserir códigos de produto longos ou outras informações relevantes manualmente.

Para integrar o recurso de scanner de código de barras ou QR, você deve atualizar o arquivo de manifesto do aplicativo e chamar a API scanBarCode. Para uma integração eficaz, você deve ter um bom entendimento do trecho de código para chamar a API scanBarCode, que permite usar o recurso de scanner de código de barras ou QR nativo. A API fornece um erro para um padrão de código de barras sem suporte. É importante se familiarizar com os erros de resposta da API para lidar com os erros no seu aplicativo do Teams.

Observação

O suporte do Microsoft Teams para a capacidade de leitor de código de barras ou QR só está disponível para clientes móveis.

Atualizar manifesto

Atualize seu aplicativo do Teams do arquivo manifest.json do adicionando a devicePermissions propriedade e especificando media. Permite que a sua aplicação peça permissões necessárias aos utilizadores antes de começarem a utilizar a capacidade de análise de código de barras ou QR. A atualização para o manifesto do aplicativo é a seguinte:

"devicePermissions": [
    "media",
],

Observação

O prompt de Solicitar Permissões é exibido automaticamente quando uma API do Teams relevante é iniciada. Para obter mais informações, consulte Solicitar permissões de dispositivo.

ScanBarCode API

A API scanBarCode invoca o controle de scanner que permite que o usuário digitalize diferentes tipos de código de barras e retorna o resultado como uma cadeia de caracteres.

Para personalizar a experiência de verificação de código de barras, configuração de código de barras é passada como entrada para a API scanBarCode. Você pode especificar o intervalo de tempo limite da verificação em segundos usando timeOutIntervalInSec. Seu valor padrão é 30 segundos e o valor máximo é de 60 segundos.

A API scanBarCode() dá suporte aos seguintes tipos de código de barras:

Tipo de Código de Barras	Com suporte no Android	Com suporte no iOS
Barra de código	Sim	Não
Código 39	Sim	Sim
Código 93	Sim	Sim
Código 128	Sim	Sim
EAN-13	Sim	Sim
EAN-8	Sim	Sim
ITF	Não	Sim
Código QR	Sim	Sim
RSS expandido	Sim	Não
RSS-14	Sim	Não
UPC-A	Sim	Sim
UPC-E	Sim	Sim

A imagem a seguir descreve a experiência do aplicativo da web com o recurso de scanner de código de barras ou QR:

experiência de aplicativo da web para capacidade de scanner de código de barras ou qr

Tratamento de erros

Você deve garantir que lide com esses erros adequadamente em seu aplicativo do Teams. A tabela a seguir lista os códigos de erro e as condições sob quais os erros são gerados:

Código de erro	Nome do erro	Condição
100	NÃO_SUPORTADO_NA_PLATAFORMA	A API não é compatível com a plataforma atual.
500	INTERNAL_ERROR	Erro interno encontrado durante a execução da operação necessária.
1.000	PERMISSION_DENIED	A permissão foi negada pelo usuário.
3000	NO_HW_SUPPORT	O hardware subjacente não suporta a capacidade.
4000	ARGUMENTOS_INVÁLIDOS	Um ou mais argumentos são inválidos.
8000	ABORTAR_USUÁRIO	O usuário anula a operação.
8001	OPERATION_TIMED_OUT	Não foi possível detetar o código de barras no intervalo de tempo especificado.
9000	ANTIGA_PLATAFORMA	O código da plataforma está desatualizado e não implementa esta API.

Trecho de código

Chamada ScanBarCode() API para verificação de QR ou código de barras usando a câmera:

const config: microsoftTeams.media.BarCodeConfig = {
  timeOutIntervalInSec: 30};
microsoftTeams.media.scanBarCode((error: microsoftTeams.SdkError, decodedText: string) => {
  if (error) {
    if (error.message) {
      output(" ErrorCode: " + error.errorCode + error.message);
    } else {
      output(" ErrorCode: " + error.errorCode);
    }
  } else if (decodedText) {
    output(decodedText);
  }
}, config);

Exemplo de código

Nome do exemplo	Descrição	.NET	Node.js	Manifesto
Equipa de associação de bots por QR	Este exemplo mostra como utilizar uma funcionalidade em que o utilizador pode aderir a uma equipa através do código QR que contém o ID da equipa através do bot.	View	View	View
Inspeção do produto de tabulação	Esta aplicação de exemplo mostra como utilizar uma funcionalidade onde o utilizador pode digitalizar um produto, capturar uma imagem e marcá-la como aprovada/rejeitada.	View	View	Exibir

Compartilhar via