更新记录

1.0.0（2026-07-07）

• 发布统一扫码 API，覆盖 Android / iOS / HarmonyOS / Web / 微信小程序
• 支持单次扫码、持续扫码、多码识别与点选、手电筒、内容解析、扫描线样式
• App 端基于原生相机预览（Android CameraX + ML Kit，iOS AVFoundation）
• 提供 uni-app pages/ 与 uni-app x pagesx/ 示例

平台兼容性

uni-app(5.06)

uni-app x(5.06)

其他

xview-scancode

Android / iOS / HarmonyOS / Web / 微信小程序统一扫码插件。

支持二维码、条形码、单次/持续扫码、同屏多码识别、手电筒、扫描线样式和内容类型解析。

能力

• 码制：二维码、一维码、Data Matrix、PDF417
• 模式：单次扫码、持续扫码、多码累计
• 多码：Android / iOS 预览层点选，或 outputAllCodeData 一次返回全部码（含 rect 坐标）
• 解析：text、url、wifi、phone、sms、email、contact、geo、calendar、driverLicense、isbn、product
• 样式：viewStyle / scanLine 直接绘制在原生相机预览页
• Web：onlyFromCamera: false 时预览层提供「上传图片」入口

快速使用

import { parseXviewScanCode, setXviewTorch, xviewScanCode } from '@/uni_modules/xview-scancode'

// 单次扫码
xviewScanCode({
  mode: 'once',
  scanTypes: ['qrCode', 'barCode'],
  success: (res) => console.log(res.latest)
})

// 持续扫码
xviewScanCode({
  mode: 'continuous',
  maxCount: 5,
  autoStop: false,
  success: (res) => console.log(res.codes)
})
// closeXviewScanCode() 停止

// 内容解析（不调相机）
const item = parseXviewScanCode({ rawValue: 'tel:1388********', format: 'QR_CODE' })

多码识别

预览层点选（Android / iOS）：传入 multiSelectStyle，同屏 2 个及以上码时显示绿点，轻触返回对应 latest。

一次返回全部：outputAllCodeData: true，由业务页自行选择。

API

xviewScanCode / xviewScanCodeAsync options

viewStyle

scanLine / multiSelectStyle

scanLine：

multiSelectStyle：

返回值 XviewScanCodeResult

XviewScanCodeItem 字段：rawValue、format、codeType、value、title、charSet、path、rect?

parseXviewScanCode options

setXviewTorch options

返回 XviewTorchResult：enabled、supported、message

错误码

示例

• uni-app：pages/scancode/*
• uni-app x：pagesx/scancode/*
• pages.json 通过 #ifdef UNI-APP-X 分端注册