【Zxing】二维码ZXing

近公司的Android项目需要用到摄像头做条码或二维码的扫描，Google一下，发现一个开源的 ZXing项目。它提供二维码和条形码的扫描。扫描条形码就是直接读取条形码的内容，扫描二维码是按照自己指定的二维码格式进行编码和解码。

1.什么是二维码和条形码？

                       

二维条形码最早发明于日本，它是用某种特定的几何图形按一定规律在平面（二维方向上）分布的黑白相间的图形记录数据符号信息的，在代码编制上巧妙地利用构成计算机内部逻辑基础的“0”、“1”比特流的概念，使用若干个与二进制相对应的几何形体来表示文字数值信息，通过图象输入设备或光电扫描设备自动识读以实现信息自动处理。它具有条码技术的一些共性：每种码制有其特定的字符集；每个字符占有一定的宽度；具有一定的校验功能等。同时还具有对不同行的信息自动识别功能、及处理图形旋转变化等特点。

条形码(barcode)是将宽度不等的多个黑条和空白，按照一定的编码规则排列，用以表达一组信息的图形标识符。常见的条形码是由反射率相差很大的黑条（简称条）和白条（简称空）排成的平行线图案。条形码可以标出物品的生产国、制造厂家、商品名称、生产日期、图书分类号、邮件起止地点、类别、日期等许多信息，因而在商品流通、图书管理、邮政管理、银行系统等许多领域都得到广泛的应用。

2.ZXing基本介绍

ZXing是一个开源Java类库用于解析多种格式的条形码和二维码.官网：http://code.google.com/p/zxing/

截止目前为止最新版本提供以下编码格式的支持：

• UPC-A and UPC-E
• EAN-8 and EAN-13
• Code 39
• Code 93
• Code 128
• QR Code
• ITF
• Codabar
• RSS-14 (all variants)
• Data Matrix
• PDF 417 ('alpha' quality)
• Aztec ('alpha' quality)

同时官网提供了 Android、cpp、C#、iPhone、j2me、j2se、jruby、objc、rim、symbian等多种应用的类库，具体详情可以参考下载的源码包中。

3.Android端编码演示

这里使用的ZXing是经过简化版的，去除了一些一般使用不必要的文件，项目工程和效果截图如下：

    

其中encoding包是在原基础上加上去的，功能是根据传入的字符串来生成二维码图片，返回一个Bitmap，其余的包是ZXing项目自带的。另外对扫描界面的布局也进行了修改，官方的扫描界面是横向的，我改成了纵向的，并加入了顶部的Tab和取消按钮（camera.xml），另外还需要的一些文件是colors.xml、ids.xml，这些都是原本ZXing项目中自带的，最后就是libs下面的jar包。

接下来看如何使用，首先是把ZXing项目中的一些文件拷贝到我们自己的项目中，然后在Mainifest文件中进行配置权限：

[html] view plaincopyprint?

1. <uses-permissionandroid:name="android.permission.VIBRATE"/> 
2. <uses-permissionandroid:name="android.permission.CAMERA"/> 
3. <uses-featureandroid:name="android.hardware.camera"/> 
4. <uses-featureandroid:name="android.hardware.camera.autofocus"/> 

还有就是扫描界面Activity的配置：

[html] view plaincopyprint?

1. <activity 
2.          android:configChanges="orientation|keyboardHidden" 
3.          android:name="com.zxing.activity.CaptureActivity" 
4.          android:screenOrientation="portrait" 
5.          android:theme="@android:style/Theme.NoTitleBar.Fullscreen" 
6.          android:windowSoftInputMode="stateAlwaysHidden"> 
7. </activity> 

接下来是我自己项目的布局文件：

[html] view plaincopyprint?

1. <?xmlversion="1.0"encoding="utf-8"?> 
2. <LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android" 
3.     android:layout_width="fill_parent" 
4.     android:layout_height="fill_parent" 
5.     android:background="@android:color/white" 
6.     android:orientation="vertical"> 
7.  
8.     <Button 
9.         android:id="@+id/btn_scan_barcode" 
10.         android:layout_width="fill_parent" 
11.         android:layout_height="wrap_content" 
12.         android:layout_marginTop="30dp" 
13.         android:text="Open camera"/> 
14.      
15.     <LinearLayout  
16.         android:orientation="horizontal" 
17.         android:layout_marginTop="10dp" 
18.         android:layout_width="fill_parent" 
19.         android:layout_height="wrap_content"> 
20.          
21.         <TextView  
22.         android:layout_width="wrap_content" 
23.         android:layout_height="wrap_content" 
24.         android:textColor="@android:color/black" 
25.         android:textSize="18sp" 
26.         android:text="Scan result："/> 
27.          
28.         <TextView  
29.         android:id="@+id/tv_scan_result" 
30.         android:layout_width="fill_parent" 
31.         android:textSize="18sp" 
32.         android:textColor="@android:color/black" 
33.         android:layout_height="wrap_content"/> 
34.     </LinearLayout> 
35.      
36.     <EditText  
37.         android:id="@+id/et_qr_string" 
38.         android:layout_width="fill_parent" 
39.         android:layout_height="wrap_content" 
40.         android:layout_marginTop="30dp" 
41.         android:hint="Input the text"/> 
42.      
43.     <Button 
44.         android:id="@+id/btn_add_qrcode" 
45.         android:layout_width="fill_parent" 
46.         android:layout_height="wrap_content" 
47.         android:text="Generate QRcode"/> 
48.      
49.     <ImageView  
50.         android:id="@+id/iv_qr_image" 
51.         android:layout_width="wrap_content" 
52.         android:layout_height="wrap_content" 
53.         android:layout_marginTop="10dp" 
54.         android:layout_gravity="center"/> 
55.  
56. </LinearLayout> 

下面是主Activity的代码，主要功能是打开扫描框、显示扫描结果、根据输入的字符串生成二维码图片：

[java] view plaincopyprint?

1. publicclass BarCodeTestActivity extends Activity { 
2.     /** Called when the activity is first created. */ 
3.     private TextView resultTextView; 
4.     private EditText qrStrEditText; 
5.     private ImageView qrImgImageView; 
6.      
7.     @Override 
8.     publicvoid onCreate(Bundle savedInstanceState) { 
9.         super.onCreate(savedInstanceState); 
10.         setContentView(R.layout.main); 
11.          
12.         resultTextView = (TextView) this.findViewById(R.id.tv_scan_result); 
13.         qrStrEditText = (EditText) this.findViewById(R.id.et_qr_string); 
14.         qrImgImageView = (ImageView) this.findViewById(R.id.iv_qr_image); 
15.          
16.         Button scanBarCodeButton = (Button) this.findViewById(R.id.btn_scan_barcode); 
17.         scanBarCodeButton.setOnClickListener(new OnClickListener() { 
18.              
19.             @Override 
20.             publicvoid onClick(View v) { 
21.                 //打开扫描界面扫描条形码或二维码  
22.                 Intent openCameraIntent = new Intent(BarCodeTestActivity.this,CaptureActivity.class); 
23.                 startActivityForResult(openCameraIntent, 0); 
24.             } 
25.         }); 
26.          
27.         Button generateQRCodeButton = (Button) this.findViewById(R.id.btn_add_qrcode); 
28.         generateQRCodeButton.setOnClickListener(new OnClickListener() { 
29.              
30.             @Override 
31.             publicvoid onClick(View v) { 
32.                 try { 
33.                     String contentString = qrStrEditText.getText().toString(); 
34.                     if (!contentString.equals("")) { 
35.                         //根据字符串生成二维码图片并显示在界面上，第二个参数为图片的大小（350*350）  
36.                         Bitmap qrCodeBitmap = EncodingHandler.createQRCode(contentString, 350); 
37.                         qrImgImageView.setImageBitmap(qrCodeBitmap); 
38.                     }else { 
39.                         Toast.makeText(BarCodeTestActivity.this, "Text can not be empty", Toast.LENGTH_SHORT).show(); 
40.                     } 
41.                      
42.                 } catch (WriterException e) { 
43.                     // TODO Auto-generated catch block  
44.                     e.printStackTrace(); 
45.                 } 
46.             } 
47.         }); 
48.     } 
49.  
50.     @Override 
51.     protectedvoid onActivityResult(int requestCode, int resultCode, Intent data) { 
52.         super.onActivityResult(requestCode, resultCode, data); 
53.         //处理扫描结果（在界面上显示）  
54.         if (resultCode == RESULT_OK) { 
55.             Bundle bundle = data.getExtras(); 
56.             String scanResult = bundle.getString("result"); 
57.             resultTextView.setText(scanResult); 
58.         } 
59.     } 
60. } 

其中生成二维码图片的代码在EncodingHandler.java中：

[java] view plaincopyprint?

1. publicfinalclass EncodingHandler { 
2.     privatestaticfinalint BLACK = 0xff000000; 
3.      
4.     publicstatic Bitmap createQRCode(String str,int widthAndHeight) throws WriterException { 
5.         Hashtable<EncodeHintType, String> hints = new Hashtable<EncodeHintType, String>();   
6.         hints.put(EncodeHintType.CHARACTER_SET, "utf-8");  
7.         BitMatrix matrix = new MultiFormatWriter().encode(str, 
8.                 BarcodeFormat.QR_CODE, widthAndHeight, widthAndHeight); 
9.         int width = matrix.getWidth(); 
10.         int height = matrix.getHeight(); 
11.         int[] pixels = newint[width * height]; 
12.          
13.         for (int y = 0; y < height; y++) { 
14.             for (int x = 0; x < width; x++) { 
15.                 if (matrix.get(x, y)) { 
16.                     pixels[y * width + x] = BLACK; 
17.                 } 
18.             } 
19.         } 
20.         Bitmap bitmap = Bitmap.createBitmap(width, height, 
21.                 Bitmap.Config.ARGB_8888); 
22.         bitmap.setPixels(pixels, 0, width, 0, 0, width, height); 
23.         return bitmap; 
24.     } 
25. } 

最后是在哪里对扫描结果进行解码，进入CaptureActivity.java找到下面这个方法便可以对自己对结果进行操作：

[java] view plaincopyprint?

1. /**
2. * Handler scan result
3. * @param result
4. * @param barcode
5. */ 
6. ublic void handleDecode(Result result, Bitmap barcode) { 
7. inactivityTimer.onActivity(); 
8. playBeepSoundAndVibrate(); 
9. String resultString = result.getText(); 
10. //FIXME  
11. if (resultString.equals("")) { 
12.     Toast.makeText(CaptureActivity.this, "Scan failed!", Toast.LENGTH_SHORT).show(); 
13. }else { 
14.             System.out.println("Result:"+resultString); 
15.     Intent resultIntent = new Intent(); 
16.     Bundle bundle = new Bundle(); 
17.     bundle.putString("result", resultString); 
18.     resultIntent.putExtras(bundle); 
19.     this.setResult(RESULT_OK, resultIntent); 
20. } 
21. CaptureActivity.this.finish(); 

4.Java端编码演示

在Java端上实现条形码（EAN-13）和二维码（QRCode） 的编码和解码的示例，以供大家参考，用到了源码中core和javase下面的相关源代码，附件提供自己编译之后的lib包：

• zxing.jar
• zxing-j2se.jar

  有关各种手机系统的应用，有兴趣的朋友可以下载官方源码包，包下有具体详细的应用介绍。

  1)二维码（QRCode）的编码和解码演示：

  编码示例：

  [java] view plaincopyprint?

  1. package michael.zxing; 
  2.  
  3. import java.io.File; 
  4. import java.util.Hashtable; 
  5.  
  6. import com.google.zxing.BarcodeFormat; 
  7. import com.google.zxing.EncodeHintType; 
  8. import com.google.zxing.MultiFormatWriter; 
  9. import com.google.zxing.client.j2se.MatrixToImageWriter; 
  10. import com.google.zxing.common.BitMatrix; 
  11. import com.google.zxing.qrcode.decoder.ErrorCorrectionLevel; 
  12.  
  13. /**
  14. * @blog http://sjsky.iteye.com
  15. * @author Michael
  16. */ 
  17. publicclass ZxingEncoderHandler { 
  18.  
  19.     /**
  20.      * 编码
  21.      * @param contents
  22.      * @param width
  23.      * @param height
  24.      * @param imgPath
  25.      */ 
  26.     publicvoid encode(String contents, int width, int height, String imgPath) { 
  27.         Hashtable<Object, Object> hints = new Hashtable<Object, Object>(); 
  28.         // 指定纠错等级  
  29.         hints.put(EncodeHintType.ERROR_CORRECTION, ErrorCorrectionLevel.L); 
  30.         // 指定编码格式  
  31.         hints.put(EncodeHintType.CHARACTER_SET, "GBK"); 
  32.         try { 
  33.             BitMatrix bitMatrix = new MultiFormatWriter().encode(contents, 
  34.                     BarcodeFormat.QR_CODE, width, height, hints); 
  35.  
  36.             MatrixToImageWriter 
  37.                     .writeToFile(bitMatrix, "png", new File(imgPath)); 
  38.  
  39.         } catch (Exception e) { 
  40.             e.printStackTrace(); 
  41.         } 
  42.     } 
  43.  
  44.     /**
  45.      * @param args
  46.      */ 
  47.     publicstaticvoid main(String[] args) { 
  48.         String imgPath = "d:/1.png"; 
  49.         String contents = "Hello Word!"; 
  50.         int width = 300, height = 300; 
  51.         ZxingEncoderHandler handler = new ZxingEncoderHandler(); 
  52.         handler.encode(contents, width, height, imgPath); 
  53.     } 
  54. } 

  运行后生成的二维码图片如下：

  用手机的二维码扫描软件（本人用的：android 快拍二维码 ）来测试下，识别成功的截图如下：

　　　

       解码示例：

• [java] view plaincopyprint?

  1. package michael.zxing; 
  2.  
  3. import java.awt.image.BufferedImage; 
  4. import java.io.File; 
  5. import java.util.Hashtable; 
  6.  
  7. import javax.imageio.ImageIO; 
  8.  
  9. import com.google.zxing.BinaryBitmap; 
  10. import com.google.zxing.DecodeHintType; 
  11. import com.google.zxing.LuminanceSource; 
  12. import com.google.zxing.MultiFormatReader; 
  13. import com.google.zxing.Result; 
  14. import com.google.zxing.client.j2se.BufferedImageLuminanceSource; 
  15. import com.google.zxing.common.HybridBinarizer; 
  16.  
  17. /**
  18. * @blog http://sjsky.iteye.com
  19. * @author Michael
  20. */ 
  21. publicclass ZxingDecoderHandler { 
  22.  
  23.     /**
  24.      * @param imgPath
  25.      * @return String
  26.      */ 
  27.     public String decode(String imgPath) { 
  28.         BufferedImage image = null; 
  29.         Result result = null; 
  30.         try { 
  31.             image = ImageIO.read(new File(imgPath)); 
  32.             if (image == null) { 
  33.                 System.out.println("the decode image may be not exit."); 
  34.             } 
  35.             LuminanceSource source = new BufferedImageLuminanceSource(image); 
  36.             BinaryBitmap bitmap = new BinaryBitmap(new HybridBinarizer(source)); 
  37.  
  38.             Hashtable<Object, Object> hints = new Hashtable<Object, Object>(); 
  39.             hints.put(DecodeHintType.CHARACTER_SET, "utf-8"); 
  40.  
  41.             result = new MultiFormatReader().decode(bitmap, hints); 
  42.             return result.getText(); 
  43.         } catch (Exception e) { 
  44.             e.printStackTrace(); 
  45.         } 
  46.         returnnull; 
  47.     } 
  48.  
  49.     /**
  50.      * @param args
  51.      */ 
  52.     publicstaticvoid main(String[] args) { 
  53.         String imgPath = "d:/1.png"; 
  54.         ZxingDecoderHandler handler = new ZxingDecoderHandler(); 
  55.         String decodeContent = handler.decode(imgPath); 
  56.         System.out.println("解码内容如下："); 
  57.         System.out.println(decodeContent); 
  58.     } 
  59. } 

  解码内容如下： Hello Word!

  2)条形码（EAN-13）的编码和解码演示：

  编码示例：

  [java] view plaincopyprint?

  1. package michael.zxing; 
  2.  
  3. import java.io.File; 
  4.  
  5. import com.google.zxing.BarcodeFormat; 
  6. import com.google.zxing.MultiFormatWriter; 
  7. import com.google.zxing.client.j2se.MatrixToImageWriter; 
  8. import com.google.zxing.common.BitMatrix; 
  9.  
  10. /**
  11. * @blog http://sjsky.iteye.com
  12. * @author Michael
  13. */ 
  14. publicclass ZxingEAN13EncoderHandler { 
  15.  
  16.     /**
  17.      * 编码
  18.      * @param contents
  19.      * @param width
  20.      * @param height
  21.      * @param imgPath
  22.      */ 
  23.     publicvoid encode(String contents, int width, int height, String imgPath) { 
  24.         int codeWidth = 3 + // start guard  
  25.                 (7 * 6) + // left bars  
  26.                 5 + // middle guard  
  27.                 (7 * 6) + // right bars  
  28.                 3; // end guard  
  29.         codeWidth = Math.max(codeWidth, width); 
  30.         try { 
  31.             BitMatrix bitMatrix = new MultiFormatWriter().encode(contents, 
  32.                     BarcodeFormat.EAN_13, codeWidth, height, null); 
  33.  
  34.             MatrixToImageWriter 
  35.                     .writeToFile(bitMatrix, "png", new File(imgPath)); 
  36.  
  37.         } catch (Exception e) { 
  38.             e.printStackTrace(); 
  39.         } 
  40.     } 
  41.  
  42.     /**
  43.      * @param args
  44.      */ 
  45.     publicstaticvoid main(String[] args) { 
  46.         String imgPath = "d:/2.png"; 
  47.         // 益达无糖口香糖的条形码  
  48.         String contents = "6923450657713"; 
  49.  
  50.         int width = 105, height = 50; 
  51.         ZxingEAN13EncoderHandler handler = new ZxingEAN13EncoderHandler(); 
  52.         handler.encode(contents, width, height, imgPath); 
  53.     } 
  54. } 

  运行后生成条形码图片如下：

• 

  用手机的条形码扫描软件（本人用的：android 快拍二维码 ）来测试下，识别成功的截图如下：

  

  解码示例：

  [java] view plaincopyprint?

  1. package michael.zxing; 
  2.  
  3. import java.awt.image.BufferedImage; 
  4. import java.io.File; 
  5.  
  6. import javax.imageio.ImageIO; 
  7.  
  8. import com.google.zxing.BinaryBitmap; 
  9. import com.google.zxing.LuminanceSource; 
  10. import com.google.zxing.MultiFormatReader; 
  11. import com.google.zxing.Result; 
  12. import com.google.zxing.client.j2se.BufferedImageLuminanceSource; 
  13. import com.google.zxing.common.HybridBinarizer; 
  14.  
  15. /**
  16. * @blog http://sjsky.iteye.com
  17. * @author Michael
  18. */ 
  19. publicclass ZxingEAN13DecoderHandler { 
  20.  
  21.     /**
  22.      * @param imgPath
  23.      * @return String
  24.      */ 
  25.     public String decode(String imgPath) { 
  26.         BufferedImage image = null; 
  27.         Result result = null; 
  28.         try { 
  29.             image = ImageIO.read(new File(imgPath)); 
  30.             if (image == null) { 
  31.                 System.out.println("the decode image may be not exit."); 
  32.             } 
  33.             LuminanceSource source = new BufferedImageLuminanceSource(image); 
  34.             BinaryBitmap bitmap = new BinaryBitmap(new HybridBinarizer(source)); 
  35.  
  36.             result = new MultiFormatReader().decode(bitmap, null); 
  37.             return result.getText(); 
  38.         } catch (Exception e) { 
  39.             e.printStackTrace(); 
  40.         } 
  41.         returnnull; 
  42.     } 
  43.  
  44.     /**
  45.      * @param args
  46.      */ 
  47.     publicstaticvoid main(String[] args) { 
  48.         String imgPath = "d:/2.png"; 
  49.         ZxingEAN13DecoderHandler handler = new ZxingEAN13DecoderHandler(); 
  50.         String decodeContent = handler.decode(imgPath); 
  51.         System.out.println("解码内容如下："); 
  52.         System.out.println(decodeContent); 
  53.     } 
  54. } 

  解码内容如下： 6923450657713

  5.源码说明和下载

  官方例子：

  BarcodeScanner (Barcode Scanner 4.31 for Android Featured 必须先将此apk安装才可以运行ZXingTest项目)

  ZXingTest (android端调用BarcodeScanner测试例子)

  简化例子：

  BarCodeTest (android端扫描和解码精简例子)

  QRcode (java端扫描和解码例子) 

  源码下载

转载请标明出处http://blog.csdn.net/shimiso 欢迎有识之士加入我们的技术交流群:173711587