uni-app实现App端的录音并转码上传 uni-app音频采集教程-uni-app-PHP中文网

App端录音不能直接用uni.getRecorderManager的tempFilePath上传，因iOS/Android输出格式不统一（aac/mp3）、路径为临时沙盒且在部分安卓机型上失效；需用plus.io.resolveLocalFileSystemURL获取真实FileEntry，或fallback复制到_doc/目录再上传。

uni-app实现app端的录音并转码上传 uni-app音频采集教程

uni-app App端录音为什么不能直接用 `uni.getRecorderManager` 上传？

因为 uni.getRecorderManager 在 App 端（iOS/Android）默认输出的是 .aac（iOS）或 .mp3（Android），但实际文件路径是临时沙盒路径，且格式不统一、无法直接读取二进制内容——uni.uploadFile 需要本地文件路径（tempFilePath），而录音结束返回的 tempFilePath 在某些 Android 厂商（如华为、小米）上会失效或权限拒绝，导致上传 404 或“文件不存在”错误。

真正能稳定走通的链路是：录音 → 停止 → 用 plus.io.resolveLocalFileSystemURL 显式获取真实 FileEntry → 读取为 ArrayBuffer → 转成 base64 或 Blob（再转 File 对象）→ 上传。

如何在 App 端拿到可上传的真实音频文件路径？

App 端必须绕过 tempFilePath 的不可靠性，改用 plus 原生 API 获取持久化路径。关键点有三个：

uni.startRecord 已废弃，必须用 uni.getRecorderManager，但停止后不要依赖其 tempFilePath
录音完成回调中，立即调用 plus.io.resolveLocalFileSystemURL(recorder.tempFilePath)，注意：该路径需是完整 file:// 协议地址（iOS 返回的可能是 file:///var/.../xxx.aac，Android 可能是 file:///storage/emulated/0/...）
若 resolveLocalFileSystemURL 失败（常见于 Android 10+ Scoped Storage），需 fallback 到 plus.runtime.download 将临时文件复制到应用私有目录（_doc/）再处理

示例片段：

const manager = uni.getRecorderManager();
manager.onStop((res) => {
  // res.tempFilePath 不直接传给 uploadFile
  plus.io.resolveLocalFileSystemURL(res.tempFilePath, (entry) => {
    entry.file((file) => {
      const reader = new FileReader();
      reader.onload = () => {
        const arrayBuffer = reader.result;
        // 后续转 base64 或构造 Blob
      };
      reader.readAsArrayBuffer(file);
    });
  }, (e) => {
    console.error('resolve failed:', e.message);
  });
});

转码必要吗？什么时候需要把 aac/mp3 转成 wav 或 mp3 统一格式？

不是“必须转码”，而是“服务端要求什么，你就得提供什么”。很多语音识别接口（如百度 ASR、讯飞流式识别）明确要求 wav（PCM 编码，16bit，单声道，16kHz），而 uni.getRecorderManager 输出的 aac/mp3 是有损压缩，直接上传会被拒绝，报错类似 "unsupported audio format" 或 "sample rate mismatch"。

uni-app

uni-app 是基于 Vue 的跨端开发框架，适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载

App 端无法用 JS 做实时音频重采样或解码（无 WebAssembly 支持且性能差），所以稳妥做法是：

优先让后端支持接收 aac/mp3 并转码（推荐，省客户端复杂度）
若必须前端处理，只能借助原生插件：比如使用 uni-plugin-audio-encoder（封装了 iOS AudioToolbox / Android MediaCodec），将录音结果转成 PCM wav；但该插件需自行编译原生代码，且 Android 上对采样率控制不稳
切忌用 JS 解码 aac（如 aac-decoder）再重编码——App 端内存和 CPU 承受不住，录音 30 秒就卡死

上传时 `uni.uploadFile` 报 “uploadFile:fail file not exist” 怎么排查？

这个错误 90% 是路径问题，不是网络或域名配置问题。重点检查三处：

路径是否含空格或中文？plus.io 对中文路径支持差，建议录音前用 plus.io.convertLocalFileSystemURL 转义，或生成纯英文文件名
是否用了 res.tempFilePath 直接上传？在 Android 11+ 上，该路径属于沙盒临时目录，uploadFile 无权限读取，必须先 copyTo 到 _doc/ 下
是否漏了 Content-Type？部分后端校验严格，需在 header 中显式加 {"Content-Type": "multipart/form-data"}（虽然 uni.uploadFile 默认会设，但某些代理或网关会清掉）

正确上传示例（带 fallback 复制）：

entry.copyTo(plus.io.resolveLocalFileSystemURL('_doc/'), 'rec_' + Date.now() + '.aac', (copiedEntry) => {
  uni.uploadFile({
    url: 'https://api.example.com/upload',
    filePath: copiedEntry.toLocalURL(),
    name: 'file',
    success: (uploadRes) => { /* ... */ }
  });
}, (e) => console.error(e));

最易被忽略的一点：iOS 上录音文件可能带扩展名（.aac），而 Android 可能不带，但 uploadFile 的 name 字段如果写死 .wav，后端按扩展名路由就可能出错——务必根据实际文件类型动态设置 formData 或后端约定统一字段名，别信文件后缀。