更新记录

1.3.56.1.14（2026-09-04） 下载此版本

将祥承原生SDK打包成为UNI可用的插件包

平台兼容性

XCScanner 扫码头 UniApp 插件

祥承XCScanner扫码头SDK的纯UniApp UTS插件封装，可直接上传至DCloud插件市场。

平台支持

安装方式

将 xc-scanner 文件夹复制到项目的 uni_modules 目录下即可。

基本用法

<script>
import {
  init,
  initWithSymbology,
  deInit,
  startScan,
  stopScan,
  BARCODE_TYPE
} from "@/uni_modules/xc-scanner";

export default {
  onReady() {
    // 方式1：仅获取条码内容
    init((result) => {
      console.log('扫码结果:', result);
    });

    // 方式2：同时获取条码类型和内容
    initWithSymbology((sym, barCode) => {
      console.log('条码类型:', sym, '内容:', barCode);
    });
  },
  onHide() {
    deInit();
  },
  methods: {
    scan() {
      startScan();
    }
  }
}
</script>

API 列表

初始化与生命周期

扫码控制

连续扫码

条码类型管理

输出与提示

灯光控制

文本处理

高级扫码设置

条码属性配置

授权管理

配置管理

按键控制

常量

插件导出了以下常量对象，可直接引用：

• BARCODE_TYPE - 条码类型常量
• OUTPUT_METHOD - 输出方式常量
• NOTIFICATION_TYPE - 提示类型常量
• TEXT_CASE_TYPE - 大小写类型常量
• AIMER_MODE - 瞄准灯模式常量
• FLASH_MODE - 补光灯模式常量
• REGION_SIZE_TYPE - 识别范围常量
• STROBE_LIGHT_BRIGHTNESS - 闪光灯亮度常量
• LICENSE_STATE - 授权状态常量
• SCAN_TRIGGER_MODE - 触发模式常量
• SCAN_MODE - 扫码模式常量
• BARCODE_TAG - 条码属性TAG常量

注意事项

1. 本插件仅支持Android平台，需运行在安装了祥承扫码服务的设备上
2. SDK版本需与扫码服务版本匹配，当前SDK版本 1.3.56.1.14 需配合扫码服务 1.3.56.1.14 及以上版本
3. 页面切换到后台或销毁时务必调用 deInit() 释放资源
4. 激活授权需要网络连接，激活流程约需1-2分钟