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

  • Artigo

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 na 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.

Você pode usar a biblioteca de clientes JavaScript do Microsoft Teams, que fornece as ferramentas necessárias para que seu aplicativo acesse os recursos de dispositivo nativo do usuário. 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 desenvolvedores de aplicativos Web na plataforma do Teams aproveitem a funcionalidade de verificação de QR ou código de barras com a biblioteca de clientes 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

Atualmente, o suporte do Microsoft Teams para o recurso QR ou scanner de código de barras está disponível apenas para clientes móveis.

Atualizar manifesto

Atualize seu aplicativo do Teams do arquivo manifest.json do adicionando a devicePermissions propriedade e especificando media. Ele permite que seu aplicativo peça permissões necessárias dos usuários antes que eles comecem a usar o recurso de scanner de QR ou de código de barras. 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 dá suporte à funcionalidade.
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 detectar o código de barras no intervalo de tempo determinado.
9000 ANTIGA_PLATAFORMA O código da plataforma está desatualizado e não implementa essa 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
Equipe de ingresso do bot por QR Este exemplo mostra como usar um recurso em que o usuário pode ingressar em uma equipe usando o código QR que contém a ID da equipe por meio do bot. View View View
Inspeção de produto tab Este aplicativo de exemplo mostra como usar um recurso em que o usuário pode examinar um produto, capturar uma imagem e marcá-la como aprovada/rejeitada. View View Exibir

Confira também