更新记录

1.0.0(2025-05-11)

初始化


平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 3.6.8,Android:5.0,iOS:不确定,HarmonyNext:不确定 × × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序 鸿蒙元服务
× × × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × × × × × × ×

xwq-speech-to-text

  • 安卓端封装VOSK模型语音识别功能

注意!试用需要先将插件导入项目并且页面加入引用代码再打自定义基座

注意!插件不包含模型文件,需要自行下载,因为模型文件比较大,加入无法云打包,可以打完基座后把模型拷贝到static目录下

模型下载地址

使用步骤

  • 第一步:使用VOSK

    import { UseVosk } from '@/uni_modules/xwq-speech-to-text'
    import type { CallbackType, RedultType } from "@/uni_modules/xwq-speech-to-text/utssdk/interface.uts";
    const voskTool = UseVosk();
  • 第二步:初始化模型

    /**
     * 初始化模型
     * 将返回的模型地址缓存起来,在第二次用到的时候直接传入初始化,避免重复解压
     */
    const init = () => {
        let path = '/static/vosk-model-small-cn-0.22.zip';
        voskTool.initVoskModel({
            zipModelPath: path
        }, (result : CallbackType) => {
            console.log('模型地址====', result.data)
            modelPath.value = result.data.modelPath;
        })
    };
  • 第三步:开始语音识别

    /**
     * 开始语音识别
     */
    const start = () => {
        voskTool.startSpeechVoice((res : RedultType) => {
            console.log('识别结果===', res.data.text)
            content.value += res.data.text
        })
    };
  • 停止语音识别

    
    /**
     * 停止语音识别
     */
    const stop = () => {
        voskTool.stopSpeechVoice()
    };
  • 如果已经解压过模型,存在解压路径时初始化

    /**
     * 存在模型解压路径(即已经初始化过一次)
     */
    voskTool.initVoskModel({
        modelPath: modelPath.value,
        zipModelPath: ''
    }, (result : CallbackType) => {
        console.log('模型地址====', result.data)
    })
  • 在线下载模型

    const downloadModel = () => {
        const url = 'https://exeample.com/vosk-model-small-cn-0.22.zip'
        voskTool.downloadModel(url, (res) => {
            console.log(res)
            if (res.code == 0 && res.filePath != '') {
                voskTool.initVoskModel({
                    zipModelPath: res.filePath
                }, (result : CallbackType) => {
                    console.log('模型地址====', result.data)
                    modelPath.value = result.data.modelPath;
                })
            }
        })
    };

使用完整示例

<template>
    <view>
        <view class="area">
            <button type="default" @click="downloadModel">在线下载vosk模型</button>
            <button type="default" @click="init">初始化vosk模型</button>
            <button type="default" @click="start">开始语音识别</button>
            <button type="default" @click="stop">结束语音识别</button>
            <button type="default" @click="unzipInnit">存在模型解压地址初始化</button>
        </view>
        <view>
            <view class="title">
                <text>识别结果:</text>
            </view>
            <view class="content">
                <textarea :value="content" disabled style="width: 100%;padding: 15px;"></textarea>
            </view>
        </view>
    </view>
</template>

<script setup>
    import { UseVosk } from '@/uni_modules/xwq-speech-to-text'
    import type { CallbackType, RedultType } from "@/uni_modules/xwq-speech-to-text/utssdk/interface.uts";

    const modelPath = ref('');//储存模型解压地址
    const voskTool = UseVosk();
    const content = ref('');//识别结果

    /**
     * 在线下载模型
     */
    const downloadModel = () => {
        const url = 'https://exeample.com/vosk-model-small-cn-0.22.zip'
        voskTool.downloadModel(url, (res) => {
            console.log(res)
            if (res.code == 0 && res.filePath != '') {
                voskTool.initVoskModel({
                    zipModelPath: res.filePath
                }, (result : CallbackType) => {
                    console.log('模型地址====', result.data)
                    modelPath.value = result.data.modelPath;
                })
            }
        })
    };
    /**
     * 初始化模型
     * 将返回的模型地址缓存起来,在第二次用到的时候直接传入初始化,避免重复解压
     */
    const init = () => {
        let path = '/static/vosk-model-small-cn-0.22.zip';
        voskTool.initVoskModel({
            zipModelPath: path
        }, (result : CallbackType) => {
            console.log('模型地址====', result.data)
            modelPath.value = result.data.modelPath;
        })
    };

    /**
     * 存在模型解压路径(即已经初始化过一次)
     */
    const unzipInnit = () => {
        voskTool.initVoskModel({
            modelPath: modelPath.value,
            zipModelPath: ''
        }, (result : CallbackType) => {
            console.log('模型地址====', result.data)
        })
    };
    /**
     * 开始语音识别
     */
    const start = () => {
        voskTool.startSpeechVoice((res : RedultType) => {
            console.log('识别结果===', res.data.text)
            content.value += res.data.text
        })
    };

    /**
     * 停止语音识别
     */
    const stop = () => {
        voskTool.stopSpeechVoice()
    };
</script>

<style>
    .title {
        margin: 20px 0 10px 0;
    }

    .content {
        width: 100%;
        height: 100%;
        border: 1px solid #ccc;
        background-color: #f2f2f2;
    }
</style>

隐私、权限声明

1. 本插件需要申请的系统权限列表:

<uses-permission android:name="android.permission.RECORD_AUDIO" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"></uses-permission> <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"></uses-permission>

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问