Skip to content

Commit a1b61c5

Browse files
committed
feat: update
1 parent 4967c05 commit a1b61c5

File tree

1 file changed

+38
-25
lines changed

1 file changed

+38
-25
lines changed

Design/AudioAndVideo.md

Lines changed: 38 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,62 +1,75 @@
11
## 音频
22

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

55
## 兼容原理
66

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 原理:
118

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 播放,会占用很大内存
1416

1517
### QA
1618

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
1924

20-
2. IOS偶现音频报错operateAudio:fail jsapi has no permission
21-
- 音频播放时小游戏退后台就有可能出现,没有实际影响,可以忽略
25+
- 音频播放时小游戏退后台就有可能出现,没有实际影响,可以忽略
2226

2327
3. 音频播放时游戏卡顿
24-
- 如果同时播放的音频数量过多,是有可能造成游戏延迟卡顿的,建议限制同时播放的音频数量
28+
29+
- 如果同时播放的音频数量过多,是有可能造成游戏延迟卡顿的,建议限制同时播放的音频数量
2530

2631
4. 部分音频文件在安卓无法循环播放
27-
- 已知问题,8.0.51客户端版本修复
2832

29-
5. 音频在PC端无法循环播放完整音频
30-
- 已知问题,更新最新的Unity导出插件
33+
- 已知问题,8.0.51 客户端版本修复
34+
35+
5. 音频在 PC 端无法循环播放完整音频
36+
37+
- 已知问题,更新最新的 Unity 导出插件
3138

3239
6. 推荐使用什么音频格式
33-
- 推荐mp3或者aac格式,在双端有较好的兼容
40+
41+
- 推荐 mp3 或者 aac 格式,在双端有较好的兼容
3442

3543
## 视频
3644

3745
目前 VideoPlayer 已自动适配微信小游戏
3846

3947
### 支持版本
48+
4049
不同客户端的支持情况不同,以下为最低支持版本:
4150

4251
| 参数 | 版本 |
4352
| ----------- | --------------------------- |
44-
| IOS 高性能+ | 8.0.51(未发布) |
53+
| IOS 高性能+ | 8.0.51 |
4554
| IOS 高性能 | 8.0.41 |
4655
| 安卓 | 8.0.40 |
4756
| PC | 基础库 3.2.1 |
4857
| 开发者工具 | 基础库 3.2.1 + 1.06.2310312 |
4958

5059
### QA
5160

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 高性能模式只能同时播放一个视频?
5470

55-
2. 我的视频在IOS播放有声音没画面
56-
- 开启了高性能+,先临时关闭高性能+
71+
- IOS 的播放策略,只能从逻辑上兼容
5772

58-
3. 为什么IOS高性能模式只能同时播放一个视频
59-
- IOS的播放策略,只能从逻辑上兼容
73+
4. 是否应该使用 VideoPlayer?
6074

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

Comments
 (0)