Google コードスキャナ（Android のみ）

Google Code Scanner API を使用すると、ユーザーのプライバシーを保護しながら、カメラの権限を要求せずにコードをスキャンできます。これを行うには、コードをスキャンするタスクを Google Play 開発者サービスに委任し、スキャン結果のみをアプリに返します（動画 1）。画像処理はすべてデバイス上で行われ、結果や画像データが Google に保存されることはありません。API は ML Kit Barcode Scanning API と同じコード形式をサポートし、同じ Barcode オブジェクトを返します。

この API は、カスタム UI やカメラ エクスペリエンスを必要とすることなく、シームレスなコードスキャンを行うアプリに最適です。実装はすべて Google Play 開発者サービス内に配置されるため、アプリのサイズへの影響を最小限に抑えることができます。

バージョン 16.1.0 以降では、オートズームを有効にして、Google コード スキャナでカメラから離れたバーコードを自動的にスキャンできます。ユーザーがデバイスをバーコードに向けていると、スキャナはバーコードをインテリジェントに検出して拡大します。これにより、ズームを手動で調整する必要がなくなり、バーコード スキャンの速度と精度が向上し、アクセスしやすくなります（動画 2 を参照）。

動画 1. Google コードスキャナの統合 動画 2. オートズーム効果

カスタム UI を必要とする複雑なユースケースでは、ML Kit Barcode Scanning API を直接使用することをおすすめします。

ご質問がある場合や、バグを送信する場合は、ML Kit コミュニティ ページをご覧ください。

始める前に

アプリを準備するには、以下のセクションに示す手順を完了します。

アプリを構成する

  1. トップレベルの settings.gradle ファイルの dependencyResolutionManagement ブロックの下に、Maven リポジトリと Maven セントラル リポジトリを含めます。

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

  2. play-services-code-scanner SDK の Google Play 開発者サービスの依存関係をモジュールの Gradle ビルドファイル（通常は app/build.gradle）に追加します。

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