Skip to content

音视频适配

音频

目前 UnityAudio 已自动适配微信小游戏,优先建议使用 UnityAudio 来播放音频,也支持 FMOD 插件

兼容原理

UnityAudio 原理:

  • 长音频播放使用的是InnerAudio
  • 短音频播放使用的是WebAudio
  • Unity 插件会根据音频文件大小自动适配使用不同的播放方式

FMOD 原理:

  • 全部使用WebAudio,因此不推荐背景音乐等大文件使用 FMOD 播放,会占用很大内存

QA

  1. 在 IOS 17.5 以上的版本,小游戏退后台后返回音效无法继续播放了
  • 可以尝试更新最新的插件版本,可以避免一些出现的情况,我们正在尝试兼容 IOS 的更新
  1. IOS 偶现音频报错 operateAudio:fail jsapi has no permission
  • 音频播放时小游戏退后台就有可能出现,没有实际影响,可以忽略
  1. 音频播放时游戏卡顿
  • 如果同时播放的音频数量过多,是有可能造成游戏延迟卡顿的,建议限制同时播放的音频数量
  1. 部分音频文件在安卓无法循环播放
  • 已知问题,8.0.51 客户端版本修复
  1. 音频在 PC 端无法循环播放完整音频
  • 已知问题,更新最新的 Unity 导出插件
  1. 推荐使用什么音频格式
  • 推荐 mp3 或者 aac 格式,在双端有较好的兼容
  1. FMOD returns error code 36
  • 旧版本引擎已知问题,推荐使用已修复的 Unity 引擎版本,参考Unity 社区回答

视频

在微信小游戏中有两种播放视频的方式,目前 VideoPlayer 组件已自动适配微信小游戏,只有全屏视频的场景也可以选择使用WXVideo API

VideoPlayer 支持版本

不同客户端的支持情况不同,以下为最低支持版本:

参数版本
IOS 高性能+暂不支持
IOS 高性能8.0.41
安卓8.0.40
PC基础库 3.2.1
开发者工具基础库 3.2.1 + 1.06.2310312

QA

  1. VideoPlayer 视频在 IOS 无法播放,在其他平台都可以播放?
  1. VideoPlayer 视频在 IOS 播放有声音没画面?
  • 情况一:开启了高性能+,先临时关闭高性能+,等后续支持

  • 情况二:设置了 videoPlayer.frame,IOS 不支持设置该属性

  1. VideoPlayer 为什么在 IOS 高性能模式只能同时播放一个视频?
  • IOS 的播放策略,只能从逻辑上兼容
  1. 应该使用 VideoPlayer 还是 WXVideo?
  1. WXVideo 真机播放正常,开发者工具无法播放?
  • 开发者工具暂时有异常,先主动切换到3.4.10版本基础库查看
  1. WXVideo 在 IOS 设置 underGameView 之后黑屏,有声音没画面?
  • 需要开启高性能模式

Released under the MIT License.