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.

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",
],

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:

A imagem a seguir descreve a experiência do aplicativo da web com o recurso 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:

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

Confira também

• Funcionalidades de dispositivo
• Integrar recursos de mídia
• Integrar os recursos de localização
• Integrar o Seletor de Pessoas
• Esquema de manifesto do aplicativo para o Teams