Android ZXing 解析

最新推荐文章于 2024-08-08 08:35:49 发布

薛瑄

最新推荐文章于 2024-08-08 08:35:49 发布

阅读量1.6w

点赞数 10

分类专栏： ZXing 文章标签： zxing 简化版界面

本文链接：https://blog.csdn.net/xx326664162/article/details/50952856

版权

ZXing 专栏收录该内容

1 篇文章 0 订阅

订阅专栏

转载请标明出处：http://blog.csdn.net/xx326664162/article/details/50952856 文章出自：薛瑄的博客

你也可以查看我的其他同类文章，也会让你有一定的收货！

ZXing

ZXing是由谷歌开发的一款二维码扫描工具
官方github地址： https://github.com/zxing/zxing

这个工程包含很多项目，这里主要说一下android方面的。在工程中的android 项目依赖core项目和android-core项目

core项目

ZXing使用maven构建整个工程，可以使用intelli IDEA 打开整个项目，编译打包core项目（核心解码库），得到jar
也可以使用maven中心库http://mvnrepository.com/artifact/com.google.zxing/core

android-core项目

这个项目中只有一个CameraConfigurationUtils类，主要是配置摄像头的一些参数，可以手动合并到android项目中

android项目

在这个工程中android项目也是使用maven构建的，Android Studio 中的项目是使用gradle构建的，使用file->new ->import project 导入项目，AS可以自动转换为gradle。
导入core项目的jar包，
导入android-core项目CameraConfigurationUtils类

至此就可以打包apk了

简化ZXing中的Android 项目

官方android项目，包含了剪切板，扫描历史，分享，扫描二维码，等等。
如果只使用扫码功能，需要剔除其他的功能，这里为大家提供一个封装好精简的ZXing Lib：

https://github.com/JantHsueh/ZxingAndroid

基于ZXing3.1封装，包含了最新的jar包和代码。

clone 项目。并导入AS后：
这里写图片描述

这里写图片描述

原版和简化版本共有类解析

CaptureActivity

原版本：ZXing的主Activity。ZXing启动后执行CaptureActivity，在handleDecode()方法中对扫码成功后的动作作处理。
简化后：主Activity是MainActivity，分别有扫描二维码和生成二维码，单击扫描二维码，也是执行CaptureActivity在handleDecode()方法中对扫码成功后的动作作处理。

ViewfinderView

原版本：ZXing扫码窗口的绘制，可以在这个类中改变原版扫描窗口的界面
简化后：ZXing扫码窗口，集成到了CaptureActivity中，抽取到了XML文件中，这样修改起来更加方便了。

CameraConfigurationManager

该类主要负责设置相机的参数信息，获取最佳的预览界面。修改横竖屏、处理变形效果的核心类。

1、public void setDesiredCameraParameters(Camera camera, boolean safeMode)方法中（读取配置设置相机的对焦模式、闪光灯模式等等），可以将扫描改为竖屏：

在方法最后加上：

/** 设置相机预览为竖屏 */
camera.setDisplayOrientation(90);

2、在public void initFromCameraParameters(Camera camera)方法中（计算了屏幕分辨率和当前最适合的相机像素），我们可以对修改为竖屏扫码后，由于像素信息点没有对调造成图像扭曲变形进行修改。

在Log.d(TAG, “Screen resolution: ” + screenResolution);后加上如下的代码：

/** 因为换成了竖屏显示，所以不替换屏幕宽高得出的预览图是变形的 */
Point screenResolutionForCamera = new Point();
screenResolutionForCamera.x = screenResolution.x;
screenResolutionForCamera.y = screenResolution.y;

if (screenResolution.x < screenResolution.y) {
    screenResolutionForCamera.x = screenResolution.y;
    screenResolutionForCamera.y = screenResolution.x;
}

将screenResolution替换为screenResolutionForCamera：

cameraResolution = findBestPreviewSizeValue(parameters, screenResolutionForCamera);

DecodeHandler.decode

ZXing解码的核心类

CaptureActivityHandler

当DecodeHandler.decode完成解码后，系统会向CaptureActivityHandler发消息。如果编码成功则调用CaptureActivity.handleDecode方法对扫描到的结果进行分类处理。

简化版本分析

MainActivity 主Activity

public class MainActivity extends Activity {

    private TextView resultTextView;
    private EditText qrStrEditText;
    private ImageView qrImgImageView;
    private CheckBox mCheckBox;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        resultTextView = (TextView) this.findViewById(R.id.tv_scan_result);
        qrStrEditText = (EditText) this.findViewById(R.id.et_qr_string);
        qrImgImageView = (ImageView) this.findViewById(R.id.iv_qr_image);
        mCheckBox = (CheckBox) findViewById(R.id.logo);

        //扫描二维码按钮
        Button scanBarCodeButton = (Button) this.findViewById(R.id.btn_scan_barcode);
        scanBarCodeButton.setOnClickListener(new OnClickListener() {

            @Override
            public void onClick(View v) {
                //打开扫描界面扫描条形码或二维码
                Intent openCameraIntent = new Intent(MainActivity.this, CaptureActivity.class);
                startActivityForResult(openCameraIntent, 0);
            }
        });

        //生成二维码按钮
        Button generateQRCodeButton = (Button) this.findViewById(R.id.btn_add_qrcode);
        generateQRCodeButton.setOnClickListener(new OnClickListener() {

            @Override
            public void onClick(View v) {
                String contentString = qrStrEditText.getText().toString();
                if (!contentString.equals("")) {
                    //根据字符串生成二维码图片并显示在界面上，第二个参数为图片的大小（350*350）
                    Bitmap qrCodeBitmap = EncodingUtils.createQRCode(contentString, 350, 350,
                            mCheckBox.isChecked() ?
                                    BitmapFactory.decodeResource(getResources(), R.mipmap.ic_launcher) :
                                    null);
                    qrImgImageView.setImageBitmap(qrCodeBitmap);
                } else {
                    Toast.makeText(MainActivity.this, "Text can not be empty", Toast.LENGTH_SHORT).show();
                }
            }
        });
    }


    //扫描二维码，返回的结果
    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (resultCode == RESULT_OK) {
            Bundle bundle = data.getExtras();
            String scanResult = bundle.getString("result");
            resultTextView.setText(scanResult);
        }
    }
}

扫描截取界面的计算

因为在通过相机预览画面识别二维码时，需要知道二维码在相机预览画面中的位置，就会有这么一个问题：相机的分辨率和屏幕的分辨率不一样，怎么使屏幕中显示的扫描框，就是相机所捕捉的扫描框？？

解决思路也很简单，按照比例去计算，相机预览画面尺寸/屏幕布局尺寸= 相机预览画面二维码位置/屏幕布局扫描框位置

这里写图片描述

pt:预览图中二维码图片的左上顶点坐标，也就是手机中相机预览中看到的待扫描二维码的位置
qrheight:预览图中二维码图片的高度
qrwidth:预览图中二维码图片的宽度
pheight:预览图的高度，也即camera的分辨率高度
pwidth:预览图的宽度，也即camera的分辨率宽度

st:布局文件中扫描框的左上顶点坐标
sheight:布局文件中扫描框的高度
swidth:布局文件中扫描框的宽度
cheight:布局文件中相机预览控件的高度
cwidth:布局文件中相机预览控件的宽度

存在下面的等比公式：

ptx / pwidth = stx / cwidth ;
pty / pheight = sty / cheight ;
qrwidth / pwidth = swidth / cwidth ;
qrheight / pheight = sheight / cheight ;

确定相机中捕捉的扫描框大小和尺寸：

ptx = stx * pwidth / cwidth ;
pty = sty * pheight / cheight ;
qrwidth = swidth * pwidth / cwidth ;
qrheight = sheight * pheight / cheight ;

CaptureActivity类

熟悉这个类中几个函数的使用，可以自由使用ZXing功能，改变UI

Android 状态栏、标题栏、屏幕高度、横竖屏

public final class CaptureActivity extends Activity implements SurfaceHolder.Callback {

    private static final String TAG = CaptureActivity.class.getSimpleName();

    private CameraManager cameraManager;
    private CaptureActivityHandler handler;
    private InactivityTimer inactivityTimer;
    private BeepManager beepManager;

    private SurfaceView scanPreview = null;
    private RelativeLayout scanContainer;
    private RelativeLayout scanCropView;
    private ImageView scanLine;

    private Rect mCropRect = null;
    private boolean isHasSurface = false;

    public Handler getHandler() {
        return handler;
    }

    public CameraManager getCameraManager() {
        return cameraManager;
    }

    @Override
    public void onCreate(Bundle icicle) {
        super.onCreate(icicle);

        Window window = getWindow();
        window.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
        setContentView(R.layout.activity_capture);
        //获得UI控件
        scanPreview = (SurfaceView) findViewById(R.id.capture_preview);
        scanContainer = (RelativeLayout) findViewById(R.id.capture_container);
        scanCropView = (RelativeLayout) findViewById(R.id.capture_crop_view);
        scanLine = (ImageView) findViewById(R.id.capture_scan_line);

        //结束闲置一段时间的activity，如果这个设备时电池供电
        inactivityTimer = new InactivityTimer(this);
        //蜂鸣器
        beepManager = new BeepManager(this);


        //扫描动画
        TranslateAnimation animation = new TranslateAnimation(Animation.RELATIVE_TO_PARENT, 0.0f, Animation
                .RELATIVE_TO_PARENT, 0.0f, Animation.RELATIVE_TO_PARENT, 0.0f, Animation.RELATIVE_TO_PARENT,
                0.9f);
         //动画持续的时间
        animation.setDuration(4500);
        //动画重复的此时
        animation.setRepeatCount(-1);
        //动画如何重复，从下到上，还是重新开始从上到下
        animation.setRepeatMode(Animation.RESTART);

        scanLine.startAnimation(animation);
    }

    @Override
    protected void onResume() {
        super.onResume();
     // 下面这句是我自行加入的，在原作者的代码中，转动屏幕，出现崩溃，所以使用下面这条语句，固定屏幕方向为竖屏
      setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT);

        // CameraManager must be initialized here, not in onCreate(). This is
        // necessary because we don't
        // want to open the camera driver and measure the screen size if we're
        // going to show the help on
        // first launch. That led to bugs where the scanning rectangle was the
        // wrong size and partially
        // off screen.
        cameraManager = new CameraManager(getApplication());

        handler = null;

        if (isHasSurface) {
            // The activity was paused but not stopped, so the surface still
            // exists. Therefore
            // surfaceCreated() won't be called, so init the camera here.
            initCamera(scanPreview.getHolder());
        } else {
            // Install the callback and wait for surfaceCreated() to init the
            // camera.
            scanPreview.getHolder().addCallback(this);
        }

        inactivityTimer.onResume();
    }

    @Override
    protected void onPause() {
        if (handler != null) {
            handler.quitSynchronously();
            handler = null;
        }
        inactivityTimer.onPause();
        beepManager.close();
        cameraManager.closeDriver();
        if (!isHasSurface) {
            scanPreview.getHolder().removeCallback(this);
        }
        super.onPause();
    }

    @Override
    protected void onDestroy() {
        inactivityTimer.shutdown();
        super.onDestroy();
    }

    //实现SurfaceHolder.Callback,需要实现下面三个函数
    @Override
    public void surfaceCreated(SurfaceHolder holder) {
        if (holder == null) {
            Log.e(TAG, "*** WARNING *** surfaceCreated() gave us a null surface!");
        }
        if (!isHasSurface) {
            isHasSurface = true;
            initCamera(holder);
        }
    }

    @Override
    public void surfaceDestroyed(SurfaceHolder holder) {
        isHasSurface = false;
    }

    @Override
    public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) {

    }

    /**
     * A valid barcode has been found, so give an indication of success and show the results.
     * 扫描完后的结果在这个函数处理
     * @param rawResult The contents of the barcode.
     * @param bundle    The extras
     */
    public void handleDecode(Result rawResult, Bundle bundle) {
        inactivityTimer.onActivity();
        beepManager.playBeepSoundAndVibrate();

        Intent resultIntent = new Intent();
        bundle.putInt("width", mCropRect.width());
        bundle.putInt("height", mCropRect.height());
        bundle.putString("result", rawResult.getText());
        resultIntent.putExtras(bundle);
        this.setResult(RESULT_OK, resultIntent);
        CaptureActivity.this.finish();
    }

   //初始化摄像机
    private void initCamera(SurfaceHolder surfaceHolder) {
        if (surfaceHolder == null) {
            throw new IllegalStateException("No SurfaceHolder provided");
        }
        if (cameraManager.isOpen()) {
            Log.w(TAG, "initCamera() while already open -- late SurfaceView callback?");
            return;
        }
        try {
            //设置取景的使用哪个surfaceView来取景
            cameraManager.openDriver(surfaceHolder);
            // Creating the handler starts the preview, which can also throw a
            // RuntimeException.
            if (handler == null) {
                //这个类处理所有包括状态机捕获的消息。
                handler = new CaptureActivityHandler(this, cameraManager, DecodeThread.ALL_MODE);
            }
            //初始化截取的矩形区域
            initCrop();
        } catch (IOException ioe) {
            Log.w(TAG, ioe);
            displayFrameworkBugMessageAndExit();
        } catch (RuntimeException e) {
            // Barcode Scanner has seen crashes in the wild of this variety:
            // java.?lang.?RuntimeException: Fail to connect to camera service
            Log.w(TAG, "Unexpected error initializing camera", e);
            displayFrameworkBugMessageAndExit();
        }
    }

    private void displayFrameworkBugMessageAndExit() {
        // camera error
        AlertDialog.Builder builder = new AlertDialog.Builder(this);
        builder.setTitle(getString(R.string.app_name));
        builder.setMessage("Camera error");
        builder.setPositiveButton("OK", new           DialogInterface.OnClickListener() {

            @Override
            public void onClick(DialogInterface dialog, int which) {
                finish();
            }

        });
        builder.setOnCancelListener(new DialogInterface.OnCancelListener() {

            @Override
            public void onCancel(DialogInterface dialog) {
                finish();
            }
        });
        builder.show();
    }

    public void restartPreviewAfterDelay(long delayMS) {
        if (handler != null) {
            handler.sendEmptyMessageDelayed(R.id.restart_preview, delayMS);
        }
    }

    public Rect getCropRect() {
        return mCropRect;
    }

    /**
     * 初始化截取的矩形区域
     */
    private void initCrop() {
        int cameraWidth = cameraManager.getCameraResolution().y;
        int cameraHeight = cameraManager.getCameraResolution().x;

        /** 获取布局中扫描框的位置信息 */
        int[] location = new int[2];
        scanCropView.getLocationInWindow(location);

        int cropLeft = location[0];
        int cropTop = location[1] - getStatusBarHeight();

        int cropWidth = scanCropView.getWidth();
        int cropHeight = scanCropView.getHeight();

        /** 获取布局容器的宽高 */
        int containerWidth = scanContainer.getWidth();
        int containerHeight = scanContainer.getHeight();

        /** 计算最终截取的矩形的左上角顶点x坐标 */
        int x = cropLeft * cameraWidth / containerWidth;
        /** 计算最终截取的矩形的左上角顶点y坐标 */
        int y = cropTop * cameraHeight / containerHeight;

        /** 计算最终截取的矩形的宽度 */
        int width = cropWidth * cameraWidth / containerWidth;
        /** 计算最终截取的矩形的高度 */
        int height = cropHeight * cameraHeight / containerHeight;

        /** 生成最终的截取的矩形 */
        mCropRect = new Rect(x, y, width + x, height + y);
    }


    //获取状态条的高度
    private int getStatusBarHeight() {
        try {
            Class<?> c = Class.forName("com.android.internal.R$dimen");
            Object obj = c.newInstance();
            Field field = c.getField("status_bar_height");
            int x = Integer.parseInt(field.get(obj).toString());
            return getResources().getDimensionPixelSize(x);
        } catch (Exception e) {
            e.printStackTrace();
        }
        return 0;
    }
}