掃一掃，原來這麼簡單

HMSCore發表於2023-03-28

二維碼識別技術已廣泛應用在移動支付、實用工具、電商購物、社交通訊等場景。然而，在實際生活中，二維碼容易遇到距離遠、暗光、強光、汙損、模糊和大角度傾斜等複雜場景，導致識別困難，掃碼體驗差。華為HMS Core 統一掃碼服務（Scan Kit）為開發者們的APP帶來一站式掃碼解決方案，並且擁有高識別率和快速識別等特點。

距離太遠、碼圖過小？

在停車場掃碼繳費、上課掃碼簽到、廣告牌宣傳等實際生活場景中，二維碼的尺寸不一，一般的掃碼功能需手動調節手機相機框與二維碼的距離直到合適的掃碼大小，實屬不便。統一掃碼服務基於自研的深度學習演算法模型，遇到遠距離場景、碼圖過小、甚至肉眼無法分辨的情況，支援自動檢測放大，智慧識別。

多角度、光線不佳、模糊等複雜場景無法識別？

餐桌、共享單車、充電樁等裝置上的二維碼，易受環境或人為影響，導致汙損、模糊、反光，無法清晰展示，造成識別困難。統一掃碼服務基於多項計算機視覺技術，可以大幅提升複雜場景識別率，統一掃碼服務可以自動檢測及旋轉糾正，能夠在識別任意角度的同時保證準確率。

單個掃碼效率低？

在錄入商品資訊、快遞資訊等需要頻繁掃碼的場景中，一般的掃碼功能識別成功後會自動跳轉，操作不便。統一掃碼服務為您帶來連續掃碼功能，對相機內連續出現的二維碼識別檢測，避免識別成功自動跳轉的問題。同時，多碼識別模式下，統一掃碼服務最多可同時識別不限種類的5個碼，大幅提升工作效率。

另外，HMS Core 統一掃碼服務為助力開發者們構建流暢的掃碼體驗，帶來更加完善的功能：

① 支援識別/生成13種主流碼格式；

② 支援自定義掃碼介面；

③ 支援分析12個場景的碼內容，提取結構化資料；

④ 提供記憶體 1.1M / 3.3M 兩種SDK及4種不同型別的呼叫方式，安卓版本最少5行程式碼即可快速接入。

下面是接入 HMS Core 統一掃碼服務的開發步驟，以Default View Mode為例，只需簡單的整合就可為應用構建掃碼能力。

開發步驟

1. 開發準備

詳細準備步驟可參考華為開發者聯盟官網。

2. 整合準備

Default View Mode提供相機掃碼和匯入圖片掃碼兩個功能，提供完整的Activity，不需要您開發掃碼介面。

注意：使用此種模式請確保您的應用沒有關閉硬體加速，即“hardwareAccelerated”為“true”。否則在個別機型可能會出現黑屏問題。

3. 業務流程

使用Default View Mode的主要業務流程如下：

1) 使用者開啟App發起掃碼申請。

2) 校驗是否有相機許可權。

3) 許可權驗證透過後，呼叫HMS Core SDK的startScan掃碼介面，啟動掃碼介面。若需要滿足最小許可權和場景化觸發要求，檔案讀取許可權在使用者點選後觸發場景，需要設定錯誤監聽，檢測到無檔案讀取許可權，Scan Kit報錯退出Default View。

4) 判斷掃碼頁面啟動狀態。

5) HMS Core SDK回撥應用的“onActivityResult”介面。

6) 根據掃碼狀態RESULT_CODE獲取掃碼結果：若SUCCESS返回結果給使用者；若結果為ERROR_NO_READ_PERMISSION，需要應用主動申請檔案讀取許可權，重新進入Default View。

7) App封裝掃碼結果返回給使用者。

  1. 開發步驟

1) （可選）根據實際需求建立掃碼選項引數。

Scan Kit預設支援13種碼制式，您也可以指定Scan Kit只掃描特定的碼制式以提高掃碼速度。例如，當僅需要檢測QR碼和DataMatrix碼時，請按照以下示例構建HmsScanAnalyzerOptions物件。如果不限制檢測碼格式，您可以不建立HmsScanAnalyzerOptions物件。“1”為您設定的掃碼標題樣式引數，對應setViewType方法中的“var1”引數。

// “QRCODE_SCAN_TYPE”和“DATAMATRIX_SCAN_TYPE”表示只掃描QR和DataMatrix的碼，setViewType設定掃碼標題，0表示設定掃碼標題為”掃描二維碼/條碼“，1表示設定掃碼標題為”掃描二維碼“，預設為0；setErrorCheck設定錯誤監聽，true表示監聽錯誤並退出掃碼頁面，false表示不上報錯誤，僅檢查到識別結果後退出掃碼頁面，預設為false

HmsScanAnalyzerOptions options = new HmsScanAnalyzerOptions.Creator().setHmsScanTypes(HmsScan.QRCODE_SCAN_TYPE,HmsScan.DATAMATRIX_SCAN_TYPE).setViewType(1).setErrorCheck(true).create();

2) 呼叫ScanUtil的靜態方法startScan啟動Default View掃碼頁面。使用者可以使用相機掃碼，也可以透過該頁面的“匯入圖片”按鈕檢測圖片中的碼。

“REQUEST_CODE_SCAN_ONE”為您設定的請求碼引數，對應“onActivityResult”方法中的“requestCode”引數，用於判斷“onActivityResult”呼叫是否來自Scan Kit掃碼結果回撥。若“requestCode”引數等於您設定的請求碼引數，則表示本次“onActivityResult”是Scan Kit的掃碼結果回撥。

如果您沒有指定只檢測特定的碼制式，此處的options可以置為“null”，表示預設檢測Scan Kit支援的碼制式。

ScanUtil.startScan(this, REQUEST_CODE_SCAN_ONE, options);

3) 實現回撥介面接收掃碼結果，相機掃碼和匯入圖片掃碼均透過該介面返回。

呼叫Activity的“onActivityResult”方法獲取Intent引數，掃描結果物件HmsScan封裝在其中。如何獲取Intent引數請參見[RESULT](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-References/scan-scanutil4-0000001050167699#section13418152610215?ha_source=hms1)。

若“requestCode”等於步驟2中定義的“REQUEST_CODE_SCAN_ONE”請求碼引數，則表示本次接收的Intent是Scan Kit返回的結果。

透過Intent中的RESULT_CODE獲取掃碼狀態。

透過Intent中的RESULT獲取掃碼結果HmsScan，其中包含的資訊參見碼值解析。

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (resultCode != RESULT_OK || data == null) {
        return;
    }
    if (requestCode == REQUEST_CODE_SCAN_ONE) {
        // 匯入圖片掃描返回結果
        int errorCode = data.getIntExtra(ScanUtil.RESULT_CODE, ScanUtil.SUCCESS);
        if (errorCode == ScanUtil.SUCCESS) {
        Object obj = data.getParcelableExtra(ScanUtil.RESULT);
        if (obj != null) {
                // 展示掃碼結果
        ...
            }
    }
        if (errorCode == ScanUtil.ERROR_NO_READ_PERMISSION) {
            // 無檔案許可權，請求檔案許可權
        ...
        }
    }
}

瞭解更多詳情>>

訪問華為開發者聯盟官網
獲取開發指導文件
華為移動服務開源倉庫地址：GitHub、Gitee

關注我們，第一時間瞭解 HMS Core 最新技術資訊~

相關文章