MrleeAdmin/frontend/scanapp/uni_modules/mas-code-scan/changelog.md

更新日志

1.3.0（2026-08-29）

新增

• scanStyle.cornerStyle 新增 rounded 完整圆角边框和 rounded-corner 四角圆角边框。
• 新增 scanStyle.cornerRadius，单位 dp，范围 0 ~ 160，默认 20。
• 两种圆角扫描框启用遮罩时，遮罩缺口和扫描线同步按同一圆角路径裁剪。

兼容性

• 保留 corner 四角边框与 full 完整矩形边框的原有绘制和调用方式。
• 圆角半径会自动限制在扫描框短边的一半以内，适配窄条码扫描框。

1.2.0（2026-08-28）

新增

• 新增独立的 scanStyle 配置，不再将视觉表现与 scanRegion 识别区域混合。
• 支持 showMask，可控制扫描框外遮罩的显示与隐藏。
• 支持 showBeam，可控制扫描线的显示与隐藏。
• 支持 borderColor、maskColor、beamColor 自定义边框、遮罩和扫描线颜色。
• 支持 beamDuration 配置扫描线移动周期，原生层限制为 100 ~ 60000 毫秒。
• 支持 cornerStyle：corner 四角边框、full 完整矩形边框。
• README 补充扫描区域、视觉样式、扫码页交互、生命周期回调和错误码说明。
• 新增 9021005 ~ 9021011 细化错误码，覆盖相机占用/初始化、相册读取与无条码、非法 formats 和单次扫码超时。
• 新增可选 scanTimeout，单次扫码可设置 1000 ~ 600000 毫秒超时；连续扫码不启用超时。

兼容性

• 保持原有 openCodeScan 调用方式不变。
• 未传 scanStyle 时使用默认样式：绿色边框、半透明黑色遮罩、绿色扫描线、四角边框。
• scanStyle 仅影响 Android 扫描页绘制，不改变条码识别逻辑。
• 同屏多码定格后的绿色点选标记增加呼吸波纹动画，帮助用户快速定位可点击目标。

1.1.0（2026-07-22）

新增

• 增加相册识图能力，支持打开扫码页后直接进入相册，也支持扫码页内手动选图。
• 增加 formats 码制过滤，支持二维码、一维码、商品码、Data Matrix、PDF417、Aztec 等格式。
• 增加 vibrate 成功震动开关。
• 增加 continuous 连续扫码和 showPauseButton 暂停/继续控制。
• 增加 torch 手电筒策略：off、on、auto。
• 增加 resultMode 结果处理策略：immediate、confirm、pause。
• 区分 Activity 获取失败、相机权限拒绝、用户取消和无有效结果等错误码。

增强

• 支持同屏多个条码定格并点击选择。
• 增加 smartZoom 智能变焦和双指手势缩放。
• 拆分 Kotlin 原生实现，改善扫码页、相册识图、结果处理和码制解析的维护性。

1.0.0（2026-07-22）

新增

• 初始化 Android 扫码 UTS API 插件。
• 基于 CameraX + Google ML Kit 实现实时条码识别。
• 支持通过 success、fail、complete 回调接收扫码结果和流程状态。