【HarmonyOS NEXT】FAQ之媒体开发(扫码服务)

1、如何添加“扫码直达”服务的快速入口

A：控制中心编辑添加“扫一扫”入口：手机下滑菜单栏，打开控制中心，在编辑区域中添加选择“扫一扫”后保存，即可在下拉控制列表中找到。

2、扫码直达跳转失败

A：请检查App Linking配置是否正确：

1. 检查开发者网站服务器配置是否正确。

2. 检查App Linking中网址域名关联是否正确。

3. 检查应用的“module.json5”文件中域名关联是否正确。

3、Scan Kit无法识别多个码图

A：解决措施如下

1. 检查ScanOptions的enableMultiMode参数是否设置为true，开启多码扫描。

2. 检查ScanOptions的scanTypes参数是否已设置相应的码类型。

3. 检查码图类型是否在Scan Kit所定义支持的码图类型内。

4. 目前实时扫描多个码图时，最多仅支持返回4个码图。

5. 如还未解决，请通过在线提单提交问题，华为支持人员会及时处理。

4、上传软件包时提示“上传的软件包与声明支持设备不一致”

A：解决措施如下

1. 检查工程“entry”路径下，“module.json5”文件中的“deviceTypes”是否和AGC平台上应用支持的设备勾选的应用基本信息中支持的设备保持一致。如支持设备勾选手机，那么“module.json5”中“deviceTypes”需配置为：“phone”。

2. 如还未解决，请通过在线提单提交问题，华为支持人员会及时处理。

5、相册扫码识别多码失败

A：相册扫码只支持单码识别。

6、条形码识别错误

A：条形码识别是通过粗细黑白条组成的模式来进行匹配，由于条形码的图案都比较相似，不同类型的码会出现误匹配现象，Scan Kit在不断优化扫码识别算法，持续提升识别的准确率。

7、条形码识别坐标信息为空

A：因为条形码识别逻辑，算法返回的位置信息可能在同一行或者同一列，无法返回外接矩形，该场景下需要开发者判断位置信息是否为空，进行对应处理。

8、自定义界面扫码预览画面出现拉伸

A：ViewControl的宽高值需要与XComponent的宽高值保持一致，会消除画面拉伸现象。

例如：XComponent中width为1080(px)，height为1920(px)，则ViewControl宽度设置为1080，高度设置为1920。

// 设置XComponent:
XComponent({
// ...
})
.height('1920px')
.width('1080px')
// 设置viewControl:
let viewControl: customScan.ViewControl = { width: 1080, height: 1920, surfaceId: surfaceId }