目录

异步方式

业务流程

使用MultiProcessor Mode异步方式的主要业务流程如下:

  1. 用户打开App发起扫码请求。
  2. 校验是否有相机权限和文件读取权限。
  3. 权限验证通过后,初始化HmsScanAnalyzer。
  4. 将图像信息转换为MLFrame。
  5. 调用HmsScanAnalyzer的analyzInAsyn异步扫码接口。
  6. 华为统一扫码SDK回调应用的“onSuccess”或“onFailure”接口传递扫码结果。
  7. App封装扫码结果返回给用户。

开发步骤

  1. (可选)初始化HmsScanAnalyzerOptions对象,并设置支持识别的码制式。

    您可以通过如下方式设置可选参数。当您不需要定制如下参数时,您可以跳过此步骤。

    setHmsScanTypes():设置码制式,默认识别Scan Kit支持的码制式,指定扫描特定的码制式,可以提高扫码速度。
    “Java”
    // “QRCODE_SCAN_TYPE”和“DATAMATRIX_SCAN_TYPE”表示只扫描QR和DataMatrix的码
    HmsScanAnalyzerOptions options = new HmsScanAnalyzerOptions.Creator().setHmsScanTypes(HmsScan.QRCODE_SCAN_TYPE,HmsScan.DATAMATRIX_SCAN_TYPE).create();
    “Kotlin”
    // “QRCODE_SCAN_TYPE”和“DATAMATRIX_SCAN_TYPE”表示只扫描QR和DataMatrix的码
    val options = HmsScanAnalyzerOptions.Creator().setHmsScanTypes(HmsScan.QRCODE_SCAN_TYPE,HmsScan.DATAMATRIX_SCAN_TYPE).create()

  2. 初始化HmsScanAnalyzer对象。如果您没有指定只扫描特定的码制式,此处的“options”可以置“null”。

    “Java”
    HmsScanAnalyzer barcodeDetector = new HmsScanAnalyzer(options);
    “Kotlin”
    val barcodeDetector = HmsScanAnalyzer(options)

  3. 将图像信息转换为MLFrame,它是ML Kit封装的图像信息类。

    “Java”
    MLFrame image = MLFrame.fromBitmap(bitmap);
    “Kotlin”
    val image = MLFrame.fromBitmap(bitmap)

  4. 调用HmsScanAnalyzer对象的analyzInAsyn扫码方法发起扫码请求,同时订阅扫码结果事件来接收扫码结果。扫码结果为HmsScan数据结构,HmsScan数据结构的信息请参见码值解析。

    “Java”
    barcodeDetector.analyzInAsyn(image).addOnSuccessListener(new OnSuccessListener<List<HmsScan>>() {
        @Override
        public void onSuccess(List<HmsScan> hmsScans) {
            if (hmsScans != null && hmsScans.size() > 0) {
                // 展示扫码结果
                ...
            }
        }
    }).addOnFailureListener(new OnFailureListener() {
        @Override
        public void onFailure(Exception e) {
            String TAG = "AsyncError";
            Log.w(TAG, e);
        }
    });
    “Kotlin”
    barcodeDetector.analyzInAsyn(image).addOnSuccessListener(OnSuccessListener {  
            if (hmsScans != null && it.size > 0) { 
                // 展示扫码结果
                ...
            } 
         
    }).addOnFailureListener(OnFailureListener { 
         val TAG = "asyncError"
         Log.w(TAG, it)
        
    })