更新记录

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

lime-scan 华为统一扫码(ScanKit)插件，只支持单码模式，兼容安卓/ios/鸿蒙/H5。

安装

在插件市场导入后，引入插件在页面上再自定义基座后使用。

基础使用

TypeScript环境(包含UTS)

<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', res.scanType)
                }
            } as ScanCodeOption)
        }
    }
}

非TypeScript环境

在非TS环境（JavaScript）中使用时，不需要引入类型定义，可以直接使用：

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

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

示例代码

扫码示例

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

// 基础扫码
scanCode({
    success: (res) => {
        console.log('扫码结果：', res.result);
        console.log('码类型：', res.scanType);
    }
} as ScanCodeOption);

// 指定扫码类型
scanCode({
    scanType: ['qrCode', 'barCode'], // 只扫描二维码和条形码
    onlyFromCamera: true, // 只允许相机扫码
    success: (res) => {
        console.log('扫码结果：', res.result);
    },
    fail: (res) => {
        console.log('扫码失败：', res.errMsg);
    }
} as ScanCodeOption);

生成二维码示例

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端使用

H5端使用了@zxing/library实现，这个库识别率一般般，可以扫二维码，条形码。

• 1、移动端访问摄像头权限需要 https 协议
• 2、上传图片解码 带logo的码 识别不了，扫码可以。

由于需要https协议, 本地开发时, vite 可以安装@vitejs/plugin-basic-ssl并配置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()] 
})

类型定义

ScanType 支持的扫码类型

ScanFormatTypeCode 扫码类型选项

API 参考

scanCode(options: ScanCodeOption)

启动扫码功能

ScanCodeOption 参数说明

ScanCodeSuccessCallbackResult 返回参数说明

createQRCode(options: CreateQRCodeOptions)

生成二维码（仅APP端支持：ios、安卓）

CreateQRCodeOptions 参数说明