扫描二维码 二维码识别 zbar 扫码 扫描 - 更新日志

1.0.3（2025-08-18）

扫描回调函数功能说明

当前状态

由于UTS插件的回调函数生命周期限制，四个回调函数的执行情况如下：

✅ 正常工作的回调函数

  1. onScanStart: 扫描开始时执行

    • 执行时机：调用 scanQRCode() 后立即执行
    • 用途：用户认证、初始化操作等
    • 状态：✅ 正常工作

  2. onScanEnd: 扫描结束时执行

    • 执行时机：扫描完成（成功或失败）时执行
    • 用途：清理资源、记录日志等
    • 状态：✅ 正常工作
const result = await scanQRCode({
  scannerType: 'zbar',
  timeout: 10000,

  // ✅ 可用：扫描开始回调
  onScanStart: () => {
    console.log('扫描开始')
    // 显示加载提示
    uni.showLoading({ title: '扫描中...' })
  },
  // ✅ 可用：扫描结束回调
  onScanEnd: (success, result) => {
    console.log('扫描结束:', success, result)
    // 隐藏加载提示
    uni.hideLoading()
  }
})

1.0.2（2025-08-18）

扫描回调函数功能说明

当前状态

由于UTS插件的回调函数生命周期限制，四个回调函数的执行情况如下：

✅ 正常工作的回调函数

  1. onScanStart: 扫描开始时执行

    • 执行时机：调用 scanQRCode() 后立即执行
    • 用途：用户认证、初始化操作等
    • 状态：✅ 正常工作

  2. onScanDetected: 检测到二维码时执行

    • 执行时机：扫描Activity返回结果时执行
    • 用途：验证二维码内容，可返回false取消扫描
    • 状态：✅ 正常工作

  3. onScanEnd: 扫描结束时执行

    • 执行时机：扫描完成（成功或失败）时执行
    • 用途：清理资源、记录日志等
    • 状态：✅ 正常工作
const result = await scanQRCode({
  scannerType: 'zbar',
  timeout: 10000,

  // ✅ 可用：扫描开始回调
  onScanStart: () => {
    console.log('扫描开始')
    // 显示加载提示
    uni.showLoading({ title: '扫描中...' })
  },
  // ✅ 可用：扫描结束回调
  onScanEnd: (success, result) => {
    console.log('扫描结束:', success, result)
    // 隐藏加载提示
    uni.hideLoading()
  }
})

1.0.1（2025-08-18）

扫描回调函数功能说明

当前状态

由于UTS插件的回调函数生命周期限制，四个回调函数的执行情况如下：

✅ 正常工作的回调函数

  1. onScanStart: 扫描开始时执行

    • 执行时机：调用 scanQRCode() 后立即执行
    • 用途：用户认证、初始化操作等
    • 状态：✅ 正常工作

  2. onScanDetected: 检测到二维码时执行

    • 执行时机：扫描Activity返回结果时执行
    • 用途：验证二维码内容，可返回false取消扫描
    • 状态：✅ 正常工作

  3. onScanEnd: 扫描结束时执行

    • 执行时机：扫描完成（成功或失败）时执行
    • 用途：清理资源、记录日志等
    • 状态：✅ 正常工作
const result = await scanQRCode({
  scannerType: 'zbar',
  timeout: 10000,

  // ✅ 可用：扫描开始回调
  onScanStart: () => {
    console.log('扫描开始')
    // 显示加载提示
    uni.showLoading({ title: '扫描中...' })
  },
  // ✅ 可用：扫描结束回调
  onScanEnd: (success, result) => {
    console.log('扫描结束:', success, result)
    // 隐藏加载提示
    uni.hideLoading()
  }
})

1.0.0（2025-08-01）

原zbar插件地址：https://ext.dcloud.net.cn/plugin?id=1386 现基于此插件库升级为uts插件，并重构插件实现逻辑，添加更多的选项

基于ZBar原生库的高精度二维码扫描插件，当前支持Android平台，ios后续支持