Skip to content

README-CN.md

Latest commit

 

History

History
185 lines (136 loc) · 4.47 KB

README-CN.md

File metadata and controls

185 lines (136 loc) · 4.47 KB

Android-Scanner

本扫描控件使用zbar解码,当然你也可以实现其他解码引擎

使用

1、仅使用zbar

添加依赖（Jcenter）：

  • Gradle

    compile 'io.vin.android:zbar:1.0.2'

  • Maven

    <dependency>
  <groupId>io.vin.android</groupId>
  <artifactId>zbar</artifactId>
  <version>1.0.2</version>
  <type>pom</type>
</dependency>

识别代码：

// 1.initialize ImageScanner
ImageScanner mDecoder = new ImageScanner();
mDecoder.setConfig(Symbol.NONE, Config.X_DENSITY, 3);
mDecoder.setConfig(Symbol.NONE, Config.Y_DENSITY, 3);
//Disable all the Symbols
 mDecoder.setConfig(Symbol.NONE, Config.ENABLE, 0);
// set support Symbols
mDecoder.setConfig(Symbology.CODE128, Config.ENABLE, 1)
mDecoder.setConfig(Symbology.QRCODE, Config.ENABLE, 1)

// 2.set image data
Image image = new Image(width, height, "Y800");
image.setData(data);
//image.setCrop(rotatedRect.left, rotatedRect.top, rotatedRect.width(), rotatedRect.height());

// 3.decode results
int result = this.mDecoder.scanImage(image);
if (result != 0) {
  SymbolSet resultSet = this.mDecoder.getResults();
}

注意：使用远程依赖方式会加载所有平台的so文件，如果你只想依赖其中某几个平台so文件，那么你需要添加编译配置：

defaultConfig {
  ndk {
    abiFilters 'armeabi', 'armeabi-v7a'
	}
}

2、使用整个控件

添加依赖：

  • Gradle

    compile 'io.vin.android:zbar:1.0.2'
compile 'io.vin.android:scanner:1.0.11'

  • Maven

    <dependency>
  <groupId>io.vin.android</groupId>
  <artifactId>zbar</artifactId>
  <version>1.0.2</version>
  <type>pom</type>
</dependency>

<dependency>
  <groupId>io.vin.android</groupId>
  <artifactId>scanner</artifactId>
  <version>1.0.11</version>
  <type>pom</type>
</dependency>

布局文件：

<RelativeLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <io.vin.android.scanner.ScannerView2
        android:id="@+id/zbar_scanner_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent">
    </io.vin.android.scanner.ScannerView2>
 </RelativeLayout>

代码实现：

public class Camera1TestActivity extends Activity implements View.OnClickListener,
ScannerView2.SingleScanCallBack,ScannerView2.MultipleScanCallBack{

    ScannerView2 mScannerView;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_camera_test);
        mScannerView = findViewById(R.id.sv_camera);
        initScanner();
    }

    private void initScanner(){
        List<Symbology> formats = new ArrayList<>();
        formats.add(Symbology.CODE128);
        formats.add(Symbology.QRCODE);
      	//设置支持的符号
        mScannerView.setSymbology(formats);
      	//设置相机参数模式
        mScannerView.setParametersMode(Camera1View.PARAMETERS_MODE_AUTO);
      	//设置自动对焦
        mScannerView.setAutoFocus(true);
        mScannerView.setAutoFocusInterval(1000l);
      	//设置解码区域
        mScannerView.setDecodeRect(findViewById(R.id.capture_crop_view));
      	//设置解码回调（单个）
        mScannerView.setSingleScanCallBack(this);
      	//设置解码回调（多个）
        mScannerView.setMultipleScanCallBack(this);
    }

    @Override
    public void singleScan(Result data) {
        // 一帧相机数据解析后只取一个结果
    }

    @Override
    public void multipleScan(List<Result> datas) {
        // 一帧相机数据解析后所有结果
    }
}

自定义解码引擎

如果你觉得zbar的解码你不是很满意，那你可以自己实现io.vin.android.scanner.engine.DecodeEngine接口,然后设置

mZBarScannerView.setDecoderEngine(engine);

这样在你的业务层面的代码不需要再做其他的改动。

参考以下

https://github.com/ZBar/ZBar

https://www.gnu.org/software/libiconv

https://github.com/prathanbomb/android-zbar-sdk

https://github.com/al4fun/SimpleScanner

PS.Zbar和libiconv都是基于LGPL-2.1协议开源的。因此本项目也是基于LGPL-2.1协议开源。