# 更新日志

## 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` 回调接收扫码结果和流程状态。