MultiProcessor Mode适用于需要同时扫描多个码的场景。因为MultiProcessor处理效率低于其他三种调用方式,如果您没有上述需求,建议您使用其他三种调用方式。MultiProcessor Mode提供同步和异步两种模式,可以根据实际需求选择一个合适的模式。
业务流程
使用MultiProcessor Mode同步方式的主要业务流程如下:
1. 用户打开应用发起扫码请求。
2. 校验是否有相机权限和文件读取权限。
3. 权限验证通过后,初始化“HmsScanAnalyzer”。
4. 将图像信息转换为“MLFrame”。
5. 调用“HmsScanAnalyzer”的“analyseFrame”扫码接口。
6. 返回扫码结果。
7. 应用封装扫码结果返回给用户。

开发步骤
1. (可选)初始化“HmsScanAnalyzerOptions”并设置支持识别的码制式。
您可以通过如下方式设置可选参数。不需要定制如下参数时,可跳过此步骤。
setHmsScanTypes():设置码制式,默认识别Scan Kit支持的码制式,指定扫码特定的码制式,可以以提高扫码速度。
- //“QRCODE_SCAN_TYPE”和“DATAMATRIX_SCAN_TYPE表示只扫描QR和Data Matrix的码
- HmsScanAnalyzerOptions options = new HmsScanAnalyzerOptions.Creator().setHmsScanTypes(HmsScan.QRCODE_SCAN_TYPE, HmsScan.DATAMATRIX_SCAN_TYPE).create();
2. 初始化“HmsScanAnalyzer”对象。如果您没有指定只扫描特定的码制式,此处的“options”可以置“null”。
- HmsScanAnalyzer barcodeDetector = new HmsScanAnalyzer(options);
3. 将图像信息转换为“MLFrame”, “MLFrame”为ML Kit封装的图像信息类。
- MLFrame image = MLFrame.fromBitmap(bitmap);
4. 调用“HmsScanAnalyzer”对象的“analyseFrame”扫码方法发起扫码请求并获取扫码结果。扫码结果为HmsScan数据结构,HmsScan数据结构的信息请参考码值解析。
- SparseArray<HmsScan> result = barcodeDetector.analyseFrame(image);
- //展示扫码结果
- showResult(result);
业务流程
使用MultiProcessor Mode异步方式的主要业务流程如下:
1. 用户打开应用发起扫码请求。
2. 校验是否有相机权限和文件读取权限。
3. 权限验证通过后,初始化“HmsScanAnalyzer”。
4. 将图像信息转换为“MLFrame”。
5. 调用“HmsScanAnalyzer”的“analyzInAsyn”异步扫码接口。
6. HMS SDK回调应用的“onSuccess”或“onFailure”接口传递扫码结果。
7. 应用封装扫码结果返回给用户。


开发步骤
1. (可选)初始化“HmsScanAnalyzerOptions”对象,并设置支持识别的码制式。
您可以通过如下方式设置可选参数。不需要定制如下参数时,可跳过此步骤。
setHmsScanTypes():设置码制式,默认识别Scan Kit支持的码制式,指定扫码特定的码制式,可以以提高扫码速度。
- //“QRCODE_SCAN_TYPE”和“DATAMATRIX_SCAN_TYPE表示只扫描QR和Data Matrix的码
- HmsScanAnalyzerOptions options = new HmsScanAnalyzerOptions.Creator().setHmsScanTypes(HmsScan.QRCODE_SCAN_TYPE,HmsScan.DATAMATRIX_SCAN_TYPE).create();
2. 初始化“HmsScanAnalyzer”对象。如果您没有指定只扫描特定的码制式,此处的“options”可以置“null”。
- HmsScanAnalyzer barcodeDetector = new HmsScanAnalyzer(options);
3. 将图像信息转换为“MLFrame”,“MLFrame”为ML Kit封装的图像信息类。
- MLFrame image = MLFrame.fromBitmap(bitmap);
4. 调用“HmsScanAnalyzer”对象的“analyzInAsyn”扫码方法发起扫码请求,同时订阅扫码结果事件来接收扫码结果。扫码结果为HmsScan数据结构,HmsScan数据结构的信息请参考码值解析。
- barcodeDetector.analyzInAsyn(image).addOnSuccessListener(new OnSuccessListener<List<HmsScan>>() {
- @Override
- public void onSuccess(List<HmsScan> hmsScans) {
- if (hmsScans != null && hmsScans.size() > 0) {
- //展示扫码结果
- showResult(hmsScans);
- }
- }
- }).addOnFailureListener(new OnFailureListener() {
- @Override
- public void onFailure(Exception e) {
- Log.w(TAG, e);
- }
- });