更新记录

0.0.1（2025-07-08）

• feat: 初版

平台兼容性

云端兼容性

uni-app(4.56)

uni-app x(4.61)

lime-sherpa-onnx

一个基于Sherpa-onnx的离线语音识别插件，可以在没有网络连接的情况下进行语音识别。支持Android和iOS平台。

文档链接

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

• SherpaOnnx文档 - 站点1
• SherpaOnnx文档 - 站点2
• SherpaOnnx文档 - 站点3

安装方法

1. 在uni-app插件市场中搜索并导入lime-sherpa-onnx
2. 导入后在页面引入方法再自定义基座

代码演示

初始化

首先，需要初始化语音识别器，指定模型路径和相关配置：

import { UesSherpaOnnx, type UesSherpaOnnxOptions, type LimeSherpaOnnxRecognizer } from '@/uni_modules/lime-sherpa-onnx';

// 初始化选项
const options: UesSherpaOnnxOptions = {
  modelPath: '/static/models/paraformer.onnx',
  vadModelPath: '/static/models/silero_vad.onnx',
  tokensPath: '/static/models/tokens.txt'
};

// 初始化识别器
let recognizer = UesSherpaOnnx(options);

识别音频文件

使用初始化好的识别器识别音频文件：

import { type LimeRecognizeFileOptions } from '@/uni_modules/lime-sherpa-onnx';
// 识别选项
const recognizeOptions:LimeRecognizeFileOptions = {
  audioPath: '/static/audio/test.wav',
  success: (result) => {
    console.log('识别结果:', result.text);
    console.log('文本片段:', result.segments);
  }
};

// 开始识别
recognizer.recognizeFile(recognizeOptions);

释放资源

在不再需要识别器时，应该释放资源：

// 释放资源
recognizer.dispose();

示例代码

完整的使用示例：

<text>{{txt}}</text>
<button @click="onClick">音频转文本</button>

UNIAPPX

import { uesSherpaOnnx, type LimeRecognizeResult , type UesSherpaOnnxOptions, type LimeRecognizeFileOptions } from '@/uni_modules/lime-sherpa-onnx'

const txt = ref('测试');
const recognizer = uesSherpaOnnx({
    modelPath: '/static/sherpa_models/model.int8.onnx',
    vadModelPath: '/static/sherpa_models/silero_vad.onnx',
    tokensPath: '/static/sherpa_models/tokens.txt',
    success() {
        console.log('uesSherpaOnnx success')
    },
    fail(err) {
        console.log('uesSherpaOnnx err', err)
    }
} as UesSherpaOnnxOptions)

const onClick = () => {
    recognizer.recognizeFile({
        audioPath: '/static/ttsmaker-file-2025-7-2-18-42-28.wav',
        success(res) {
            console.log('recognizeFile success', res)
            txt.value = res.text
        },
        fail(err) {

            console.log('recognizeFile err', err)
        }
    } as LimeRecognizeFileOptions)

}

UNIAPP

import { uesSherpaOnnx } from '@/uni_modules/lime-sherpa-onnx'

const factory = uesSherpaOnnx({
    modelPath: '/static/sherpa_models/model.int8.onnx',
    vadModelPath: '/static/sherpa_models/silero_vad.onnx',
    tokensPath: '/static/sherpa_models/tokens.txt',
    success() {
        console.log('uesSherpaOnnx success')
    },
    fail(err) {
        console.log('uesSherpaOnnx err', err)
    }
})

export default {
    data() {
        return {
            txt: ''
        }
    },
    methods: {
        onClick() {
            factory.recognizeFile({
                audioPath: '/static/ttsmaker-file-2025-7-2-18-42-28.wav',
                success: (res) => {
                    console.log('recognizeFile success', res)
                    this.txt = res.text
                },
                fail(err) {
                    console.log('recognizeFile err', err)
                }
            })
        }
    }
}

API参考

UesSherpaOnnxOptions

初始化选项，用于配置语音识别器。

UesSherpaOnnx(options: UesSherpaOnnxOptions): LimeSherpaOnnxRecognizer

初始化函数，返回语音识别器实例。

LimeSherpaOnnxRecognizer

语音识别器接口。

recognizeFile(options: LimeRecognizeFileOptions): void

识别音频文件。

dispose(): void

释放资源。

LimeRecognizeFileOptions

识别选项。

LimeRecognizeResult

识别结果。

错误处理

插件可能会抛出以下错误：

资源下载

📚 SherpaOnnx官方详细文档和模型请访问以下站点：

• asr-models
• github 源码