Google 코드 스캐너 (Android만 해당)

시작하기 전에

앱을 준비하려면 다음 섹션의 단계를 완료하세요.

앱 구성

1. 최상위 수준 settings.gradle 파일의 dependencyResolutionManagement 블록 아래에 Google Maven 저장소와 Maven 중앙 저장소를 포함합니다.

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

2. 모듈의 Gradle 빌드 파일(일반적으로 app/build.gradle임)에 play-services-code-scanner SDK의 Google Play 서비스 종속 항목을 추가합니다.

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

3. Play 스토어에서 앱이 설치되는 동안 Google Play 서비스가 기기에 스캐너 모듈을 자동으로 다운로드하도록 앱을 구성할 수 있습니다.

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

   스캐너 모듈 사용 가능 여부를 명시적으로 확인하고 Google Play 서비스 ModuleInstallClient API를 통해 다운로드를 요청할 수도 있습니다.

   설치 시 모듈 다운로드를 사용 설정하지 않거나 명시적 다운로드를 요청하지 않고 다른 사용 사례에 스캐너 모듈이 아직 설치되어 있지 않은 경우 Google Play 서비스는 스캐너 모듈을 처음 사용할 때 다운로드합니다.

코드 스캔

다음 단계를 구현하여 바코드를 스캔합니다.

1. 선택사항: 코드 스캐너를 구성합니다.

   읽으려는 바코드 형식을 알고 있는 경우 해당 형식만 감지하도록 구성하여 바코드 감지기의 속도를 높일 수 있습니다. 예를 들어 Aztec 코드와 QR 코드만 인식하려면 다음 예와 같이 GmsBarcodeScannerOptions 객체를 빌드합니다.

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

   기본적으로 자동 확대/축소는 사용 중지되어 있습니다. 버전 16.1.0부터 자동 확대/축소 기능을 사용 설정하려면 다음 코드 예와 같이 enableAutoZoom()를 호출하세요.

   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. 코드 예와 같이 GmsBarcodeScanner의 인스턴스를 가져옵니다.

   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. 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. 결과로 반환되는 Barcode를 처리합니다.

   Kotlin

   val rawValue: String? = barcode.rawValue
   

   Java

   String rawValue = barcode.getRawValue();