更新记录

1.0.0（2025-06-01）

hc-scan-m1基础版本实现

平台兼容性

uni-app

uni-app x

hc-scan-m1

一个基于UTS开发的手持设备M1扫码模块插件，支持PDA扫描、声音提示等功能。

功能特点

• 支持M1扫码设备的初始化和控制
• 提供扫码回调监听
• 支持扫码声音提示（可开关）
• 适用于支持M1扫码模块的PDA设备

安装方法

1. 在插件市场获取本插件
2. 导入插件到HBuilderX项目中
3. 在manifest.json的"App模块配置"中勾选"Android平台的UTS插件"

使用方法

初始化扫码设备

import { initPdaScan, setScanCallback } from '@/uni_modules/hc-scan-m1/utssdk/index';

// 初始化扫码设备
initPdaScan({
  success: () => {
    console.log('M1扫码设备初始化成功');
  },
  fail: (error) => {
    console.error('M1扫码设备初始化失败：', error);
  }
});

// 设置扫码结果回调
setScanCallback((code) => {
  console.log('扫码结果：', code);
  // 处理扫码结果
});

开始扫码

import { startScan } from '@/uni_modules/hc-scan-m1/utssdk/index';

// 开始扫码
startScan({
  success: () => {
    console.log('开始扫码');
  },
  fail: (error) => {
    console.error('开始扫码失败：', error);
  }
});

声音提示控制

import { enablePromptSound, initSound } from '@/uni_modules/hc-scan-m1/utssdk/index';

// 启用扫码声音提示（默认启用）
enablePromptSound(true);

// 禁用扫码声音提示
enablePromptSound(false);

// 单独初始化声音系统
initSound();

API 文档

initPdaScan(options)

初始化M1扫码设备。

参数

• options: 对象
  • success: 函数，初始化成功的回调
  • fail: 函数，初始化失败的回调，返回错误信息

setScanCallback(callback)

设置扫码结果回调函数。

参数

• callback: 函数，接收扫码结果字符串作为参数

startScan(options)

开始扫码操作。

参数

• options: 对象
  • success: 函数，操作成功的回调
  • fail: 函数，操作失败的回调，返回错误信息

enablePromptSound(status)

启用或禁用扫码提示音。

参数

• status: 布尔值，true为启用，false为禁用

initSound()

初始化提示音系统。

返回

• 布尔值，初始化是否成功

开发文档

• UTS 语法
• UTS API插件
• UTS uni-app兼容模式组件
• UTS 标准模式组件
• Hello UTS