|
1 | 1 | ## 音频
|
2 | 2 |
|
3 |
| -目前 UnityAudio 已自动适配微信小游戏,优先建议使用 UnityAudio 来播放音频,也支持FMOD插件 |
| 3 | +目前 UnityAudio 已自动适配微信小游戏,优先建议使用 UnityAudio 来播放音频,也支持 FMOD 插件 |
4 | 4 |
|
5 | 5 | ## 兼容原理
|
6 | 6 |
|
7 |
| -UnityAudio原理: |
8 |
| -- 长音频播放使用的是[InnerAudio](https://developers.weixin.qq.com/minigame/dev/api/media/audio/InnerAudioContext.html) |
9 |
| -- 短音频播放使用的是[WebAudio](https://developers.weixin.qq.com/minigame/dev/api/media/audio/WebAudioContext.html) |
10 |
| -- 插件代码根据音频文件大小自动适配使用不同的播放方式 |
| 7 | +UnityAudio 原理: |
11 | 8 |
|
12 |
| -FMOD原理: |
13 |
| -- 全部使用[WebAudio](https://developers.weixin.qq.com/minigame/dev/api/media/audio/WebAudioContext.html),因此不推荐背景音乐等大文件使用FMOD播放,会占用很大内存 |
| 9 | +- 长音频播放使用的是[InnerAudio](https://developers.weixin.qq.com/minigame/dev/api/media/audio/InnerAudioContext.html) |
| 10 | +- 短音频播放使用的是[WebAudio](https://developers.weixin.qq.com/minigame/dev/api/media/audio/WebAudioContext.html) |
| 11 | +- Unity 插件会根据音频文件大小自动适配使用不同的播放方式 |
| 12 | + |
| 13 | +FMOD 原理: |
| 14 | + |
| 15 | +- 全部使用[WebAudio](https://developers.weixin.qq.com/minigame/dev/api/media/audio/WebAudioContext.html),因此不推荐背景音乐等大文件使用 FMOD 播放,会占用很大内存 |
14 | 16 |
|
15 | 17 | ### QA
|
16 | 18 |
|
17 |
| -1. 在IOS 17.5以上的版本,小游戏退后台后返回音效无法继续播放了 |
18 |
| -- 可以尝试更新最新的插件版本,可以避免一些出现的情况,我们正在尝试兼容IOS的更新 |
| 19 | +1. 在 IOS 17.5 以上的版本,小游戏退后台后返回音效无法继续播放了 |
| 20 | + |
| 21 | +- 可以尝试更新最新的插件版本,可以避免一些出现的情况,我们正在尝试兼容 IOS 的更新 |
| 22 | + |
| 23 | +2. IOS 偶现音频报错 operateAudio:fail jsapi has no permission |
19 | 24 |
|
20 |
| -2. IOS偶现音频报错operateAudio:fail jsapi has no permission |
21 |
| -- 音频播放时小游戏退后台就有可能出现,没有实际影响,可以忽略 |
| 25 | +- 音频播放时小游戏退后台就有可能出现,没有实际影响,可以忽略 |
22 | 26 |
|
23 | 27 | 3. 音频播放时游戏卡顿
|
24 |
| -- 如果同时播放的音频数量过多,是有可能造成游戏延迟卡顿的,建议限制同时播放的音频数量 |
| 28 | + |
| 29 | +- 如果同时播放的音频数量过多,是有可能造成游戏延迟卡顿的,建议限制同时播放的音频数量 |
25 | 30 |
|
26 | 31 | 4. 部分音频文件在安卓无法循环播放
|
27 |
| -- 已知问题,8.0.51客户端版本修复 |
28 | 32 |
|
29 |
| -5. 音频在PC端无法循环播放完整音频 |
30 |
| -- 已知问题,更新最新的Unity导出插件 |
| 33 | +- 已知问题,8.0.51 客户端版本修复 |
| 34 | + |
| 35 | +5. 音频在 PC 端无法循环播放完整音频 |
| 36 | + |
| 37 | +- 已知问题,更新最新的 Unity 导出插件 |
31 | 38 |
|
32 | 39 | 6. 推荐使用什么音频格式
|
33 |
| -- 推荐mp3或者aac格式,在双端有较好的兼容 |
| 40 | + |
| 41 | +- 推荐 mp3 或者 aac 格式,在双端有较好的兼容 |
34 | 42 |
|
35 | 43 | ## 视频
|
36 | 44 |
|
37 | 45 | 目前 VideoPlayer 已自动适配微信小游戏
|
38 | 46 |
|
39 | 47 | ### 支持版本
|
| 48 | + |
40 | 49 | 不同客户端的支持情况不同,以下为最低支持版本:
|
41 | 50 |
|
42 | 51 | | 参数 | 版本 |
|
43 | 52 | | ----------- | --------------------------- |
|
44 |
| -| IOS 高性能+ | 8.0.51(未发布) | |
| 53 | +| IOS 高性能+ | 8.0.51 | |
45 | 54 | | IOS 高性能 | 8.0.41 |
|
46 | 55 | | 安卓 | 8.0.40 |
|
47 | 56 | | PC | 基础库 3.2.1 |
|
48 | 57 | | 开发者工具 | 基础库 3.2.1 + 1.06.2310312 |
|
49 | 58 |
|
50 | 59 | ### QA
|
51 | 60 |
|
52 |
| -1. 我的视频在IOS无法播放,在其他平台都可以播放 |
53 |
| -- 可以尝试把视频播放链接替换我们这个视频链接试试看是否正常,一般这种情况都是服务端设置问题,会报错Origin weapp://wechat-game-runtime is not allowed by Access-Control-Allow-Origin,但是没有打印到客户端,只需要配置服务端允许微信跨域访问即可(视频链接:https://wxsnsdy.tc.qq.com/105/20210/snsdyvideodownload?filekey=30280201010421301f0201690402534804102ca905ce620b1241b726bc41dcff44e00204012882540400&bizid=1023&hy=SH&fileparam=302c020101042530230204136ffd93020457e3c4ff02024ef202031e8d7f02030f42400204045a320a0201000400 ) |
| 61 | +1. 视频在 IOS 无法播放,在其他平台都可以播放? |
| 62 | + |
| 63 | +- 可以尝试把视频播放链接替换我们这个视频链接试试看是否正常,一般这种情况都是服务端设置问题,会报错`Origin weapp://wechat-game-runtime is not allowed by Access-Control-Allow-Origin`,但是没有打印到客户端,只需要配置服务端允许微信跨域访问即可(视频链接:https://wxsnsdy.tc.qq.com/105/20210/snsdyvideodownload?filekey=30280201010421301f0201690402534804102ca905ce620b1241b726bc41dcff44e00204012882540400&bizid=1023&hy=SH&fileparam=302c020101042530230204136ffd93020457e3c4ff02024ef202031e8d7f02030f42400204045a320a0201000400 ) |
| 64 | + |
| 65 | +2. 视频在 IOS 播放有声音没画面? |
| 66 | + |
| 67 | +- 开启了高性能+,先临时关闭高性能+ |
| 68 | + |
| 69 | +3. 为什么 IOS 高性能模式只能同时播放一个视频? |
54 | 70 |
|
55 |
| -2. 我的视频在IOS播放有声音没画面 |
56 |
| -- 开启了高性能+,先临时关闭高性能+ |
| 71 | +- IOS 的播放策略,只能从逻辑上兼容 |
57 | 72 |
|
58 |
| -3. 为什么IOS高性能模式只能同时播放一个视频 |
59 |
| -- IOS的播放策略,只能从逻辑上兼容 |
| 73 | +4. 是否应该使用 VideoPlayer? |
60 | 74 |
|
61 |
| -4. 是否应该使用VideoPlayer? |
62 |
| -- 如果只是单纯使用全屏的视频播放,更推荐使用小游戏API视频播放能力。请参考[小游戏开发者文档](https://developers.weixin.qq.com/minigame/dev/api/media/video/wx.createVideo.html)以及示例[Video Demo](https://github.com/wechat-miniprogram/minigame-unity-webgl-transform/tree/main/Demo/WX_Video) |
| 75 | +- 如果只是单纯使用全屏的视频播放,更推荐使用小游戏 API 视频播放能力。请参考[小游戏开发者文档](https://developers.weixin.qq.com/minigame/dev/api/media/video/wx.createVideo.html)以及示例[Video Demo](https://github.com/wechat-miniprogram/minigame-unity-webgl-transform/tree/main/Demo/WX_Video) |
0 commit comments