更新记录

1.0.0（2026-06-11） 下载此版本

初始化

平台兼容性

uni-app(5.0)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
√ √ × × √ × √ × ×
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
× × × × × × × × × × × ×

其他

多语言 暗黑模式 宽屏模式
× × √

yjy-scan-code

用于 Android 端扫码功能的 UTS 插件，支持多二维码扫描。

平台支持

平台 uni-app (Vue2/Vue3) uni-app-x
Android ✅ ✅
iOS ❌ ❌
Harmony ❌ ❌
Web ❌ -
小程序 ❌ -

权限

本插件需要 相机权限，调用时会自动申请。

API

scanCode(options?)

打开扫码界面，扫描二维码/条形码。

ScanCodeOptions

参数 类型 必填 默认值 说明
autoZoom boolean 否 true 是否开启自动缩放对焦
success (res: ScanCodeSuccess) => void 否 - 扫码成功回调
fail (res: ScanCodeFail) => void 否 - 扫码失败回调
complete (res: any) => void 否 - 扫码完成回调（成功/失败均会触发）

ScanCodeSuccess

字段 类型 说明
result string 扫码识别到的内容
scanType string 扫码类型（如 QR_CODE、CODE_128 等）

ScanCodeFail

继承自 UniError，额外包含 errCode 字段。

字段 类型 说明
errCode number 错误码，见下方错误码表
errMsg string 错误描述
errSubject string 固定值 "scan-code"

错误码

错误码 说明
9010001 当前无法获取页面 Activity
9010002 相机权限被拒绝
9010003 用户取消扫码
9010004 未获取到有效的扫码结果

类型定义

type ScanCodeOptions = {
  autoZoom ?: boolean
  success ?: (res : ScanCodeSuccess) => void
  fail ?: (res : ScanCodeFail) => void
  complete ?: (res : any) => void
}

使用示例

uni-app-x 使用示例

import { scanCode, type ScanCodeSuccess, type ScanCodeFail } from '@/uni_modules/yjy-scan-code'

scanCode({
  autoZoom: false,
  success: (res: ScanCodeSuccess) => {
    resultText.value = '结果：' + res.result + '\n类型：' + res.scanType
  },
  fail: (err: ScanCodeFail) => {
    resultText.value = '扫码失败：' + err.errMsg + '（' + err.errCode + '）'
  }
})

uni-app 使用示例

import { scanCode } from '@/uni_modules/yjy-scan-code'

scanCode({
  autoZoom: false,
  success: (res) => {
    resultText.value = '结果：' + res.result + '\n类型：' + res.scanType
  },
  fail: (err) => {
    resultText.value = '扫码失败：' + err.errMsg + '（' + err.errCode + '）'
  }
})

制作自定义基座

由于本插件使用了google.mlkit、androidx.camera 等第三方库，运行调试前需要先制作自定义基座。

步骤

  1. 打开打包界面
    在 HBuilderX 菜单栏选择：运行 → 运行到手机或模拟器 → 制作自定义调试基座

  2. 填写打包信息

    • 选择需要打包的项目
    • 填写 Android 包名（如 com.example.app）
    • 配置证书（可直接使用公共测试证书，或选择自有证书）

  3. 云打包
    点击"打包"按钮，等待云端打包完成

  4. 运行调试
    基座安装成功后，后续运行项目选择"自定义基座"即可正常调用扫码功能进行调试

开发文档

隐私、权限声明

1. 本插件需要申请的系统权限列表：

相机

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

无

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

无

许可协议

MIT协议
评论列表 撰写评论 向官方投诉

暂无用户评论。