Partilhar via


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

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

Confira também