语音模型运行时下载方案

❌ 问题

语音模型文件 vosk-model-small-cn-0.22.zip 大小为 41.87 MB，超过云端打包限制（40MB）。

✅ 解决方案：运行时下载

原理

打包时不包含模型文件（减小 APK 大小）
首次启动时从服务器下载模型
下载后保存到本地存储
后续使用本地模型

📝 实施步骤

步骤1：从 static 目录移除模型文件

方法A：移动到服务器（推荐）

# 将模型文件上传到您的服务器
# 例如：https://app.liuyingyong.cn/static/vosk-model-small-cn-0.22.zip

方法B：移动到项目外（临时）

# 将文件移动到桌面备份
# fronted_uniapp/static/vosk-model-small-cn-0.22.zip
# → 桌面/vosk-model-backup/

步骤2：修改语音识别页面，添加模型下载逻辑

在 pages/speech/speech.vue 中添加：

<script>
export default {
  data() {
    return {
      modelDownloaded: false,
      downloadProgress: 0,
      // 模型文件URL（改为您的服务器地址）
      modelUrl: 'https://app.liuyingyong.cn/static/vosk-model-small-cn-0.22.zip',
      // 本地存储路径
      modelPath: ''
    }
  },
  
  onLoad() {
    this.checkAndDownloadModel();
  },
  
  methods: {
    // 检查并下载模型
    async checkAndDownloadModel() {
      try {
        // 检查本地是否已有模型
        const localPath = plus.io.convertLocalFileSystemURL('_doc/vosk-model-small-cn-0.22.zip');
        const file = plus.io.resolveLocalFileSystemURL(localPath);
        
        file.getFile({
          success: (entry) => {
            console.log('模型文件已存在');
            this.modelPath = localPath;
            this.modelDownloaded = true;
          },
          fail: () => {
            console.log('模型文件不存在，开始下载');
            this.downloadModel();
          }
        });
      } catch (e) {
        console.log('检查模型失败，开始下载', e);
        this.downloadModel();
      }
    },
    
    // 下载模型
    downloadModel() {
      uni.showLoading({
        title: '下载语音模型...',
        mask: true
      });
      
      const downloadTask = uni.downloadFile({
        url: this.modelUrl,
        filePath: plus.io.convertLocalFileSystemURL('_doc/vosk-model-small-cn-0.22.zip'),
        success: (res) => {
          if (res.statusCode === 200) {
            console.log('模型下载成功', res.tempFilePath);
            this.modelPath = res.tempFilePath;
            this.modelDownloaded = true;
            
            uni.hideLoading();
            uni.showToast({
              title: '模型下载完成',
              icon: 'success'
            });
          }
        },
        fail: (err) => {
          console.error('模型下载失败', err);
          uni.hideLoading();
          uni.showModal({
            title: '下载失败',
            content: '语音模型下载失败，请检查网络后重试',
            confirmText: '重试',
            success: (res) => {
              if (res.confirm) {
                this.downloadModel();
              }
            }
          });
        }
      });
      
      // 监听下载进度
      downloadTask.onProgressUpdate((res) => {
        this.downloadProgress = res.progress;
        console.log('下载进度', res.progress + '%');
      });
    },
    
    // 修改原来的语音识别方法
    startRecognition() {
      if (!this.modelDownloaded) {
        uni.showToast({
          title: '模型未下载',
          icon: 'none'
        });
        return;
      }
      
      // 原来的语音识别代码
      // ...
    }
  }
}
</script>

<template>
  <view>
    <!-- 下载进度显示 -->
    <view v-if="!modelDownloaded" class="download-container">
      <text>正在下载语音模型...</text>
      <progress :percent="downloadProgress" show-info />
    </view>
    
    <!-- 原来的语音识别界面 -->
    <view v-else>
      <!-- ... -->
    </view>
  </view>
</template>

步骤3：更新插件代码，支持动态模型路径

如果插件硬编码了模型路径，需要修改为接受外部传入的路径。

🎯 优点

✅ APK 大小减少 42MB
✅ 可以随时更新模型而不用重新打包
✅ 可以支持多个模型按需下载
✅ 用户可以选择下载时机（WiFi环境）

⚠️ 注意事项

服务器要求
- 需要有可访问的服务器存放模型文件
- 建议使用 CDN 加速下载
- 确保服务器支持大文件下载
首次使用体验
- 首次使用需要下载 42MB
- 建议在 WiFi 环境下载
- 提供下载进度提示
存储权限
- 确保 APP 有存储权限
- 检查存储空间是否足够

📊 效果对比

项目	打包方案	运行时下载
APK大小	~100MB	~58MB ✅
首次启动	即可使用	需下载 42MB
更新模型	需重新打包	直接更新 ✅
灵活性	低	高 ✅

🚀 快速实施

如果现在着急打包，可以先：

临时移除模型文件

移动 fronted_uniapp/static/vosk-model-small-cn-0.22.zip
到桌面备份

注释掉语音功能

<!-- 暂时隐藏语音按钮 -->
<view v-if="false">
  语音识别按钮
</view>

先完成打包
之后再实施完整的运行时下载方案

5.5 KiB Raw Blame History Unescape Escape