Trình quét mã của Google (chỉ dành cho Android)

Trước khi bắt đầu

Để chuẩn bị cho ứng dụng của bạn, hãy hoàn tất các bước trong những phần sau.

Định cấu hình ứng dụng

1. Trong tệp settings.gradle cấp cao nhất, hãy thêm Kho lưu trữ Maven của Google và Kho lưu trữ trung tâm Maven trong Khối dependencyResolutionManagement:

   dependencyResolutionManagement {
     repositories {
       google()
       mavenCentral()
     }
   }
   

2. Thêm phần phụ thuộc Dịch vụ Google Play cho play-services-code-scanner SDK cho tệp bản dựng Gradle của mô-đun, thường là app/build.gradle:

   dependencies {
     implementation 'com.google.android.gms:play-services-code-scanner:16.1.0'
   }
   

3. Bạn có thể định cấu hình ứng dụng để các dịch vụ của Google Play tự động được bật tải mô-đun máy quét xuống thiết bị trong khi ứng dụng của bạn được cài đặt từ Cửa hàng Play.

   <application ...>
     ...
     <meta-data
         android:name="com.google.mlkit.vision.DEPENDENCIES"
         android:value="barcode_ui"/>
     ...
   </application>
   

   Bạn cũng có thể kiểm tra một cách rõ ràng tính sẵn có của mô-đun máy quét và yêu cầu tải xuống thông qua ModuleInstallClient của dịch vụ Google Play .

   Nếu bạn không bật tải xuống mô-đun tại thời điểm cài đặt hoặc yêu cầu nội dung tục tĩu tải xuống—và mô-đun máy quét chưa được cài đặt cho trường hợp sử dụng – Dịch vụ Google Play tải mô-đun máy quét xuống trước tiên thời gian sử dụng.

Quét mã

Thực hiện các bước sau để quét mã vạch.

1. Không bắt buộc: Định cấu hình trình quét mã.

   Nếu biết định dạng mã vạch nào bạn muốn đọc, bạn có thể cải thiện của trình phát hiện mã vạch bằng cách định cấu hình để chỉ phát hiện những . Ví dụ: để chỉ phát hiện mã Aztec và mã QR, hãy tạo một GmsBarcodeScannerOptions như trong ví dụ sau:

   Kotlin

   val options = GmsBarcodeScannerOptions.Builder()
      .setBarcodeFormats(
          Barcode.FORMAT_QR_CODE,
          Barcode.FORMAT_AZTEC)
      .build()
   

   Java

   GmsBarcodeScannerOptions options = new GmsBarcodeScannerOptions.Builder()
      .setBarcodeFormats(
          Barcode.FORMAT_QR_CODE,
          Barcode.FORMAT_AZTEC)
      .build();
   

   Theo mặc định, tính năng tự động thu phóng được tắt. Để bật chức năng tự động thu phóng kể từ phiên bản 16.1.0, hãy gọi enableAutoZoom() như trong đoạn mã ví dụ sau.

   Kotlin

   val options = GmsBarcodeScannerOptions.Builder()
      .setBarcodeFormats(...)
      .enableAutoZoom() // available on 16.1.0 and higher
      .build()
   

   Java

   GmsBarcodeScannerOptions options = new GmsBarcodeScannerOptions.Builder()
      .setBarcodeFormats(...)
      .enableAutoZoom() // available on 16.1.0 and higher
      .build();
   

2. Nhận một thực thể của GmsBarcodeScanner, như minh hoạ trong đoạn mã ví dụ:

   Kotlin

   val scanner = GmsBarcodeScanning.getClient(this)
   // Or with a configured options
   // val scanner = GmsBarcodeScanning.getClient(this, options)
   

   Java

   GmsBarcodeScanner scanner = GmsBarcodeScanning.getClient(this);
   // Or with a configured options
   // GmsBarcodeScanner scanner = GmsBarcodeScanning.getClient(context, options);
   

3. Yêu cầu quét mã bằng cách gọi startScan().

   Kotlin

   scanner.startScan()
      .addOnSuccessListener { barcode ->
          // Task completed successfully
      }
      .addOnCanceledListener {
          // Task canceled
      }
      .addOnFailureListener { e ->
          // Task failed with an exception
      }
   

   Java

   scanner
      .startScan()
      .addOnSuccessListener(
          barcode -> {
            // Task completed successfully
          })
      .addOnCanceledListener(
          () -> {
            // Task canceled
          })
      .addOnFailureListener(
          e -> {
            // Task failed with an exception
          });
   

4. Xử lý Barcode thu được.

   Kotlin

   val rawValue: String? = barcode.rawValue
   

   Java

   String rawValue = barcode.getRawValue();