Todos os produtos
Search
Central de documentação

SuperApp:Code scanning

Última atualização: Jun 29, 2026

A API JavaScript WVScan permite iniciar um leitor de QR code ou código de barras em aplicativos HTML5 e miniapps.

WVScan.scan

Nota

Esta API requer WindVane Android 1.0.3.4 ou posterior, ou WindVane iOS 2.1.4 ou posterior.

Inicia o leitor de códigos. Os resultados são retornados por callback direto e eventos DOM. Registre os listeners de evento antes de chamar a API.

Código de exemplo

document.addEventListener('WVScan.Event.scanSuccess', function (e) {
        alert('event scanSuccess: ' + JSON.stringify(e.param));
});
document.addEventListener('WVScan.Event.scanFailed', function (e) {
        alert('event scanFailed: ' + JSON.stringify(e.param));
});

var params = {
  openFlight: true,
  title: 'XXX'
};
window.WindVane.call('WVScan', 'scan', params, function(e) {
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

Parâmetros de entrada

Parâmetro

Tipo

Obrigatório

Descrição

openFlight

boolean

Não

Define se o flash deve ser ativado. true ativa o flash; false o desativa. Padrão: false.

title

string

Não

Título da página de leitura. Padrão: "scan QR code or bar code".

compatible

boolean

Não

Defina como true ao chamar esta API após a apresentação de um miniapp.

  • [boolean ]openFlight: opcional. Define se o flash deve ser ativado. true ativa o flash; false o desativa. Padrão: false.

  • [string ]title: opcional. Título da página de leitura. Padrão: "scan QR code or bar code".

  • [boolean] compatible: opcional. Defina como true ao chamar esta API após a apresentação de um miniapp.

Parâmetros de callback

Callback de sucesso:

  • Nenhum parâmetro de callback. Utilize o evento DOM WVScan.Event.scanSuccess para obter o resultado da leitura.

Callback de falha:

  • [string]msg: mensagem de erro.

Escuta de eventos

WVScan.Event.scanSuccess: Código lido com sucesso.

Parâmetros do evento:

  • [string]content: conteúdo decodificado do código lido.

  • [string]format: formato do código de barras. Valores válidos:

    • [string]QR_CODE: QR code.

    • [string]AZTEC: Código de barras 2D Aztec.

    • [string]CODABAR: Código de barras Codabar.

    • [string]CODE_39: Código de barras Code 39.

    • [string]CODE_93: Código de barras Code 93.

    • [string]CODE_128: Código de barras Code 128.

    • [string]DATA_MATRIX: Código de barras 2D Data Matrix.

    • [string]EAN_8: Código de barras EAN-8.

    • [string]EAN_13: Código de barras EAN-13.

    • [string]ITF: Código de barras Interleaved 2 of 5 (ITF).

    • [string]MAXICODE: Código de barras 2D hexagonal MaxiCode.

    • [string]PDF_147: Código de barras 2D PDF417.

    • [string]RSS_14: Código de barras RSS 14.

    • [string]RSS_EXPANDED: Código de barras RSS Expanded.

    • [string]UPC_A: Código de barras UPC-A.

    • [string]UPC_E: Código de barras UPC-E.

WVScan.Event.scanFailed: Falha na leitura do código.

Parâmetros do evento:

  • [string]msg: mensagem de erro.

Formatos de código de barras compatíveis

Valor do enum

Formato

Tipo

QR_CODE

QR code

2D

AZTEC

Aztec

2D

DATA_MATRIX

Data Matrix

2D

PDF_147

PDF417

2D

MAXICODE

MaxiCode

2D

CODE_39

Code 39

1D

CODE_93

Code 93

1D

CODE_128

Code 128

1D

CODABAR

Codabar

1D

ITF

Interleaved 2 of 5 (ITF)

1D

EAN_8

EAN-8

1D

EAN_13

EAN-13

1D

UPC_A

UPC-A

1D

UPC_E

UPC-E

1D

RSS_14

RSS 14

1D

RSS_EXPANDED

RSS Expanded

1D