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 vào khối dependencyResolutionManagement:

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

2. Thêm phần phụ thuộc Dịch vụ Google Play cho SDK play-services-code-scanner vào 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ủa mình tự động tải mô-đun trình quét xuống thiết bị trong khi ứng dụng đượ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 rõ ràng phạm vi cung cấp của mô-đun trình quét và yêu cầu tải xuống thông qua ModuleInstallClient API của Dịch vụ Google Play.

   Nếu bạn không bật tính năng tải mô-đun xuống tại thời điểm cài đặt hoặc yêu cầu tải xuống rõ ràng (và mô-đun trình quét chưa được cài đặt cho một trường hợp sử dụng khác), thì Dịch vụ Google Play sẽ tải mô-đun trình quét xuống vào lần đầu tiên mô-đun này được 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ững định dạng mã vạch mà bạn muốn đọc, bạn có thể cải thiện tốc độ 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 định dạng đó. Ví dụ: để chỉ phát hiện mã Aztec và mã QR, hãy tạo một đối tượng 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 sẽ tắt. Để bật chức năng tự động thu phóng bắt đầu từ phiên bản 16.1.0, hãy gọi enableAutoZoom() như minh hoạ trong ví dụ về mã 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. Lấy một thực thể của GmsBarcodeScanner, như minh hoạ trong ví dụ về mã:

   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();