更新记录

0.2.5（2025-06-17）

• fix: 修复uniapp报错

0.2.4（2025-06-14）

• chore: 更新文档

0.2.3（2025-06-14）

• chore: 更新文档

平台兼容性

云端兼容性

uni-app(4.34)

uni-app x(4.61)

lime-scan 扫码组件

一个基于华为统一扫码(ScanKit)的扫码插件，支持单码模式，兼容安卓、iOS、鸿蒙和H5平台。提供了扫描二维码、条形码等多种码制的功能，同时支持生成二维码。组件提供了简单易用的API，使开发者能够方便地在应用中集成扫码功能。

文档链接

📚 组件详细文档请访问以下站点：

• 扫码组件文档 - 站点1
• 扫码组件文档 - 站点2
• 扫码组件文档 - 站点3

安装方法

1. 在uni-app插件市场中搜索并导入lime-scan
2. 导入后在页面引入相关方法
3. 需要自定义基座才能使用
4. 试用符合需求后才购买，插件无法退款
5. ios可能存在一维码识别不准的问题

代码演示

基础用法

简单的扫码功能实现：

<view style="padding: 30rpx 0;">扫描结果：{{result}}</view>
<button type="primary" @click="scan">开启扫描</button>

import {scanCode, type ScanCodeOption} from '@/uni_modules/lime-scan';

export default {
    data() {
        return {
            type: '',
            result: '',
        }
    },
    methods:{
        scan() {
            scanCode({
                success: (res)=> {
                    this.result = res.result
                    console.log('扫码类型:', res.scanType)
                }
            } as ScanCodeOption)
        }
    }
}

生成二维码

在APP端生成二维码图片：

import { createQRCode, type CreateQRCodeOptions } from '@/uni_modules/lime-scan';

createQRCode({
    width: 300,
    height: 300,
    content: 'limeui.qcoon.cn',
    success(src: string) {
        console.log('二维码图片地址：', src);
    },
    fail(error: string) {
        console.log('生成失败：', error);
    }
} as CreateQRCodeOptions);

H5端使用说明

1. 移动端访问摄像头权限需要 HTTPS 协议
2. 上传图片解码时，带logo的码可能识别不了，但直接扫码可以

配置HTTPS开发环境

由于H5端需要HTTPS协议才能访问摄像头，本地开发时可以配置Vite的HTTPS支持：

# 安装插件
pnpm i @vitejs/plugin-basic-ssl -D

在vite.config.ts中配置：

import basicSsl from '@vitejs/plugin-basic-ssl'
import uni from '@dcloudio/vite-plugin-uni';
import { defineConfig } from 'vite';
export default defineConfig({ 
    server: { 
        https: true 
    }, 
    plugins: [ basicSsl(), uni()] 
})

快速预览

导入插件后，可以直接使用以下标签查看演示效果：

<!-- 代码位于 uni_modules/lime-scan/components/lime-scan -->
<lime-scan />

插件标签说明

API文档

scanCode 方法

ScanCodeOption 选项

ScanCodeSuccessCallbackResult 返回参数

createQRCode 方法

CreateQRCodeOptions 选项

支持的扫码类型

ScanType 扫码结果类型

ScanFormatTypeCode 扫码类型选项

功能特点

• 支持多种码制的扫描，包括二维码、条形码等
• 支持生成二维码功能（仅APP端）
• 兼容安卓、iOS、鸿蒙和H5平台
• 提供简单易用的API接口
• H5端基于@zxing/library实现，无需额外配置
• 支持指定扫码类型，提高识别效率

常见问题

• H5端需要HTTPS协议才能访问摄像头
• H5端识别带logo的二维码可能会有困难
• APP端需要自定义基座才能使用
• 生成二维码功能仅在APP端支持
• 目前仅支持单码模式，不支持同时识别多个码

支持与赞赏

如果你觉得本插件解决了你的问题，可以考虑支持作者：

支付宝赞助	微信赞助