Google 扫码器 API 提供了一种完整的代码扫描解决方案,无需应用请求相机权限,同时可保护用户隐私。为此,您可以将扫描代码的任务委托给 Google Play 服务,并且仅将扫描结果返回给您的应用(视频 1)。所有图片处理操作都在设备上进行,Google 不会存储结果或图片数据。该 API 支持与 ML Kit Barcode Scanning API 相同的代码格式,并返回相同的 Barcode
对象。
此 API 非常适合需要无缝代码扫描而不需要自定义界面或相机体验的应用。实现完全在 Google Play 服务中,确保对应用大小的影响微乎其微。
从版本 16.1.0 开始,您可以启用自动缩放功能,以便 Google 扫码器自动扫描远离摄像头的条形码。当用户将设备指向条形码时,扫描器将智能地检测并放大条形码。这样就无需手动调整缩放,使条形码扫描更快、更准确、更易于访问(请参阅视频 2)。
视频 1. Google 扫码器集成 | 视频 2. 自动缩放效果 |
对于需要自定义界面的更复杂的用例,我们建议您直接使用机器学习套件 Barcode Scanning API。
如果您有任何疑问、想要提交 bug 或需要帮助,请查看机器学习套件社区页面。
准备工作
为了让您的应用做好准备,请完成以下部分中的步骤。
配置您的应用
在顶级
settings.gradle
文件的dependencyResolutionManagement
代码块下,添加 Google 的 Maven 制品库和 Maven 中央制品库:dependencyResolutionManagement { repositories { google() mavenCentral() } }
将
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' }
您可以对应用进行配置,让 Google Play 服务在您从 Play 商店安装您的应用时,自动将扫描器模块下载到设备。
<application ...> ... <meta-data android:name="com.google.mlkit.vision.DEPENDENCIES" android:value="barcode_ui"/> ... </application>
您还可以明确检查扫描器模块可用性,并请求通过 Google Play 服务 ModuleInstallClient API 进行下载。
如果您未启用安装时模块下载或请求明确下载,并且尚未针对其他用例安装扫描器模块,Google Play 服务会在扫描器模块首次使用时下载该模块。
扫描二维码
请按照以下步骤扫描条形码。
可选:配置扫码器。
如果您知道要读取哪些条形码格式,则可以将条形码检测器配置为仅检测这些格式,从而提高条形码检测器的速度。例如,如需仅检测 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();
获取
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);
通过调用
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 });
处理生成的
Barcode
。Kotlin
val rawValue: String? = barcode.rawValue
Java
String rawValue = barcode.getRawValue();