更新记录

1.0.0（2026-02-05）

v1.0.0

平台兼容性

uni-app(4.51)

uni-app x(4.73)

ainuo-hwscankit

基于华为 Scan Kit 的商业级扫码和二维码生成 UTS 插件，安卓与ios ui 已高度统一。

平台支持

安装

将插件导入到 uni_modules 目录即可使用。

快速开始

import { scan, createQRCode, createBarcode } from "@/uni_modules/ainuo-hwscankit"

API 文档

scan(options)

启动扫码功能。

参数

scanType 可选值

mode 可选值

示例

// 单次扫码
scan({
  mode: 'single',
  success: (result) => {
    console.log('扫码结果:', result.originalValue)
    console.log('码类型:', result.scanType)
  },
  fail: (error) => {
    console.error('扫码失败:', error.errorMessage)
  }
})

// 连续扫码
scan({
  mode: 'continuous',
  success: (result) => {
      // 扫码结束，获取所有结果
      console.log('所有结果:', result.results)
      console.log('总数:', result.totalCount)
  }
})

onScanned((result)=>{
  console.log(result)
})

// 多码扫描
scan({
  mode: 'multi',
  success: (result) => {
      console.log('确认的结果:', result)
  }
})

createQRCode(options)

生成二维码（异步）。

参数

options 参数

成功回调返回值

示例

// 基础用法
createQRCode({
  content: 'https://example.com',
  size: 300,
  success: (result) => {
    // 显示二维码
    imageElement.src = 'data:image/png;base64,' + result.base64
  }
})

// 自定义样式
createQRCode({
  content: 'https://example.com',
  size: 300,
  options: {
    codeColor: '#1890ff',
    backgroundColor: '#f0f0f0',
    margin: 2
  },
  success: (result) => {
    console.log('尺寸:', result.width, 'x', result.height)
  }
})

// 带 Logo
createQRCode({
  content: 'https://example.com',
  size: 300,
  options: {
    logoBase64: 'iVBORw0KGgoAAAANSUhEUgAAAAo...', // Logo 的 base64
    logoScale: 0.2
  },
  success: (result) => {
    imageElement.src = 'data:image/png;base64,' + result.base64
  }
})

createBarcode(options)

生成条形码（异步）。

参数

barcodeType 可选值

示例

// CODE_128 条形码
createBarcode({
  content: '1234567890',
  width: 400,
  height: 150,
  barcodeType: 'CODE_128',
  success: (result) => {
    imageElement.src = 'data:image/png;base64,' + result.base64
  }
})

// EAN-13 条形码
createBarcode({
  content: '6901234567890',
  width: 400,
  height: 150,
  barcodeType: 'EAN_13',
  success: (result) => {
    console.log('生成成功')
  },
  fail: (error) => {
    console.error('生成失败:', error.errorMessage)
  }
})

支持的码类型

注意事项

1. 权限：插件会自动请求相机权限，无需手动处理
2. Logo 尺寸：logoScale 建议不超过 0.3，过大会影响二维码识别
3. 条形码内容：不同类型的条形码对内容有特定要求（如 EAN-13 需要13位数字）
4. Base64 格式：logoBase64 支持带或不带 data:image/xxx;base64, 前缀

更新日志

查看 changelog.md