Google 程式碼掃描器 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 社群頁面。
事前準備
如要讓應用程式做好準備,請完成下列各節的步驟。
設定應用程式
在頂層
settings.gradle
檔案的dependencyResolutionManagement
區塊下方,加入 Google Maven 存放區和 Maven 中央存放區:dependencyResolutionManagement { repositories { google() mavenCentral() } }
將
play-services-code-scanner
SDK 的 Google Play 服務依附元件,新增至模組的 Gradle 建構檔案,通常為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 服務會在首次使用掃描器模組時下載該模組。
掃描 QR code
請執行下列步驟來掃描條碼。
選用:設定程式碼掃描器。
如果您知道預期讀取的條碼格式,可以設定僅偵測這些格式,改善條碼偵測工具的速度。舉例來說,如果只要偵測 Aztec code 和 QR code,請建構
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()
即可要求掃描 QR code。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();