A API JavaScript WVScan permite iniciar um leitor de QR code ou código de barras em aplicativos HTML5 e miniapps.
WVScan.scan
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. |
|
title |
string |
Não |
Título da página de leitura. Padrão: |
|
compatible |
boolean |
Não |
Defina como |
[
boolean]openFlight: opcional. Define se o flash deve ser ativado.trueativa o flash;falseo 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 comotrueao 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.scanSuccesspara 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 |
2D |
|
|
Aztec |
2D |
|
|
Data Matrix |
2D |
|
|
PDF417 |
2D |
|
|
MaxiCode |
2D |
|
|
Code 39 |
1D |
|
|
Code 93 |
1D |
|
|
Code 128 |
1D |
|
|
Codabar |
1D |
|
|
Interleaved 2 of 5 (ITF) |
1D |
|
|
EAN-8 |
1D |
|
|
EAN-13 |
1D |
|
|
UPC-A |
1D |
|
|
UPC-E |
1D |
|
|
RSS 14 |
1D |
|
|
RSS Expanded |
1D |