Google 扫码器(仅限 Android)

Google 扫码器(仅限 Android)

Google Code Scanner API 提供了全面的扫描解决方案,无需您的应用请求相机权限,同时保护用户隐私。这是通过将扫描代码委托给 Google Play 服务并仅将扫描结果返回给您的应用来完成的(视频 1)。 所有图片处理操作都在设备上进行,并且 Google 不会存储结果或图片数据。该 API 支持与机器学习套件条形码扫描 API 相同的代码格式,并返回相同的 Barcode 对象。

此 API 非常适合需要无缝代码扫描(无需自定义界面或相机体验)的应用。该实现完全属于 Google Play 服务,可以确保对应用大小的影响最小。

对于需要自定义界面的更复杂的使用场景,我们建议直接使用 ML Kit Barcode Scanning API

如果您有任何疑问、想要提交 bug 或需要帮助,请查看机器学习套件社区页面

此 API 使用未捆绑库,必须先下载才能使用。如需了解详情,请参阅此指南

须知事项

此 API 需要 Android API 级别 21 或更高级别。确保应用的 build 文件使用的 minSdkVersion 值不小于 21。

为了让您的应用做好准备,请完成以下部分中的步骤。

配置您的应用

  1. 在顶级 settings.gradle 文件的 dependencyResolutionManagement 代码块下,添加 Google 的 Maven 代码库Maven 中央代码库

    复制代码
    dependencyResolutionManagement {
      repositories {
        google()
        mavenCentral()
      }
    }
  2. play-services-code-scanner SDK 的 Google Play 服务依赖项添加到模块的 Gradle build 文件(通常为 app/build.gradle)中:

    复制代码
    dependencies {
      implementation 'com.google.android.gms:play-services-code-scanner:16.1.0'
    }
  3. 您可以将应用配置为让 Google Play 服务在您的应用从 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 对象:

    KotlinJava

    复制代码
    GmsBarcodeScannerOptions options = new GmsBarcodeScannerOptions.Builder()
       .setBarcodeFormats(
           Barcode.FORMAT_QR_CODE,
           Barcode.FORMAT_AZTEC)
       .build();

    默认情况下,自动缩放功能处于关闭状态。如需启用 16.1.0 及更高版本的自动缩放功能,请调用 enableAutoZoom(),如以下代码示例所示。

    KotlinJava

    复制代码
    GmsBarcodeScannerOptions options = new GmsBarcodeScannerOptions.Builder()
       .setBarcodeFormats(...)
       .enableAutoZoom() // available on 16.1.0 and higher
       .build();
  2. 获取 GmsBarcodeScanner 的实例,如代码示例所示:

    KotlinJava

    复制代码
    GmsBarcodeScanner scanner = GmsBarcodeScanning.getClient(this);
    // Or with a configured options
    // GmsBarcodeScanner scanner = GmsBarcodeScanning.getClient(context, options);
  3. 通过调用 startScan() 请求代码扫描。

    KotlinJava

    复制代码
    scanner
       .startScan()
       .addOnSuccessListener(
           barcode -> {
             // Task completed successfully
           })
       .addOnCanceledListener(
           () -> {
             // Task canceled
           })
       .addOnFailureListener(
           e -> {
             // Task failed with an exception
           });
  4. 处理生成的 Barcode

    KotlinJava

    复制代码
    String rawValue = barcode.getRawValue();
相关推荐
我叫小白菜28 分钟前
【Java_EE】单例模式、阻塞队列、线程池、定时器
java·开发语言
Albert Edison1 小时前
【最新版】IntelliJ IDEA 2025 创建 SpringBoot 项目
java·spring boot·intellij-idea
超级小忍2 小时前
JVM 中的垃圾回收算法及垃圾回收器详解
java·jvm
weixin_446122462 小时前
JAVA内存区域划分
java·开发语言·redis
勤奋的小王同学~2 小时前
(javaEE初阶)计算机是如何组成的:CPU基本工作流程 CPU介绍 CPU执行指令的流程 寄存器 程序 进程 进程控制块 线程 线程的执行
java·java-ee
TT哇2 小时前
JavaEE==网站开发
java·redis·java-ee
2401_826097622 小时前
JavaEE-Linux环境部署
java·linux·java-ee
缘来是庄3 小时前
设计模式之访问者模式
java·设计模式·访问者模式
雨白3 小时前
Jetpack系列(三):Room数据库——从增删改查到数据库平滑升级
android·android jetpack
Bug退退退1233 小时前
RabbitMQ 高级特性之死信队列
java·分布式·spring·rabbitmq