uni-app怎么实现App端内的语音合成播报 uni-app调用系统声音接口【技巧】-uni-app-PHP中文网

App端语音合成必须用plus.audio.createSpeech，因uni.getBackgroundAudioManager不支持TTS；需在plus.ready后调用，指定lang: 'zh-CN'，并处理Android厂商引擎差异。

uni-app怎么实现app端内的语音合成播报 uni-app调用系统声音接口【技巧】

uni-app App端语音合成用 `plus.audio.createSpeech` 而不是 `uni.getBackgroundAudioManager`

App端（iOS/Android）的语音播报必须走原生层，uni.getBackgroundAudioManager 是为背景音频设计的，不支持 TTS（文本转语音），强行用会静音或报错 errCode: 1001。真正能用的是 plus.audio.createSpeech —— 这是 uni-app 封装的 5+ Runtime 原生语音合成接口，仅在 App 环境下可用。

常见错误现象：
• 调用 uni.createInnerAudioContext() 播放 base64 音频失败（TTS 不生成音频文件）
• H5 或小程序里能跑的语音逻辑，在 App 端完全没声音
• 控制台无报错但 onStart 不触发，其实是 createSpeech 初始化失败没 catch

只在 App 环境生效：需用 uni.getSystemInfoSync().platform === 'app' 包裹调用
必须等 plus.ready 触发后才能用，否则 plus.audio 未加载
中文需指定 lang: 'zh-CN'，否则 iOS 默认英文发音（Android 有时自动识别，但不稳定）
语音质量依赖系统引擎：iOS 用 Siri 引擎，Android 各厂商差异大（华为、小米可能需要用户手动启用 TTS 服务）

如何正确初始化并播放一句话

不能直接 new 实例就播，plus.audio.createSpeech 返回的是一个对象，要显式调用 start()，且需处理平台兼容性兜底。

if (uni.getSystemInfoSync().platform === 'app') {
  plus.ready(() => {
    const speech = plus.audio.createSpeech('你好，欢迎使用', {
      lang: 'zh-CN',
      voice: 'xiaoyan', // Android 可选，iOS 忽略
      pitch: 1,
      rate: 1
    });
    speech.start();
    speech.onerror = (e) => {
      console.error('TTS error:', e.message); // 如 'No TTS engine available'
    };
  });
}