使用AVPro Video在Unity中播放开场视频(CG)笔记
游戏中的开场CG(播放视频),采用的插件为AVPro Video1.x(和W的版本一致),Unity版本为2018.4.0f1
Asset Store:AVPro Video - Core Android Edition
官方文档:https://www.renderheads.com/content/docs/AVProVideo/articles/intro.html
AVPro分为多个版本:Core(核心版),Ultra(专业版),企业版。
我了删除部分没有用到的shader,见文档:https://www.renderheads.com/content/docs/AVProVideo/articles/usage-shaders.html
1.x(2020年之前的版本)和2.x(2020.6.15之后)版本对比:https://www.renderheads.com/content/docs/AVProVideo/articles/whatsnew.html
建议视频格式为mp4,在各个平台(安卓/ios/windows/mac)都支持。
在官方文档有提到:在Editor下播放成功并不代码安卓和IOS也成功,需要分别在每个平台测试,从插件源代码来看每个平台都用原生实现的,所以要在对应平台上分别测试。
官方文档解读
这里摘录一下官方文档上每个平台的一些要求和注意事项,然后记录一下我接入过程中的笔记。
Android
Android streaming requires the Internet Access setting (in Player Settings) to be set to “Require”
:
This plugin requires a minimum Android API level of 15 when using the MediaPlayer API
For rendering OpenGL ES 2.0 and OpenGL ES 3.0 are supported, and multi-threaded rendering is supported on both
打包过程:Unity2018.4不需要做什么处理,从Unity导出工程即可
StreamingAssets 下不能读取过大的文件,建议把很大的视频放在可读取写目录,以W举例6个视频大小分布在6~18MB之间
IOS
文档:https://www.renderheads.com/content/docs/AVProVideo/articles/platform-ios.html
You need to make sure the AVProVideo.framework is set to Embed & Sign in the Frameworks
插件自带的PostProcessBuild脚本有处理在导出xcode时的自动添加引用,如果没有的话,则需要手动添加AVProVideo.framework的引用。
其它资料
建议阅读官方文档后,再阅读第三方文章,(注意文档要与项目中插件的版本一致),我阅读的一篇文章:Unity AVPro Video插件使用封装
Unity引擎自带的播放视频组件
Unity自带一个Video Player,文档:https://docs.unity.cn/cn/2019.4/Manual/class-VideoPlayer.html
但是很多用过的朋友,都发现这个组件有坑,比如在uwa上的这个贴子:华为p30视频播放异常
遇到问题
视频播放完后卡住
我是在游戏启动入口处,gameObject绑定的第一个脚本Awake函数中调用AVPro 播放视频的,在视频播放结束后,不会退出视频回到Unity,画面是停在视频的最后一帧。
从adb日志来看,安卓层的SDK代码先执行,然后再执行Unity中第一个脚本的Awake逻辑。
安卓MainActivity的入口日志
Line 8793: 06-23 10:12:49.200 I/MainActivity( 2278): MainActivity.onCreate
Line 8813: 06-23 10:12:49.216 I/MainActivity( 2278): sdkInstance
Line 8879: 06-23 10:12:50.204 I/ActivityManager( 654): Displayed com.xxx.xxx/xxx.MainActivity: +1s847ms
安卓层发事件给Unity引擎
Line 8857: 06-23 10:12:49.814 I/System.out( 2278): setResultCallback1
Unity上层C#中第一行代码日志
Line 8931: 06-23 10:12:53.254 I/Unity ( 2278): [Info] 10:12:53'212 游戏第一次启动,播放cg
解决办法:
自己在update中计算视频是否播放完成(提前100ms调用视频播放结束),以防插件出现问题不会回调播放完成事件
踩坑记录:手动调用StopVideo之后,插件内部才会触发Finish事件,我目前不依赖插件内部的播放完成,而是计算播放时间视频播放完就调用StopVideo。
安卓11播放失败
安卓11上调用播放视频遇到这个错误,但mumu模拟器上正常,且视频和so都是存在的。
Error:java.lang.UnsatisfiedLinkError: dlopen failed: library "libAVProLocal.so" not found
查看这个贴子:https://github.com/RenderHeads/UnityPlugin-AVProVideo/issues/81
就是Plugins/Android/arm64-v8a/*.so,在插件导入后没有设置平台,在导出的AndroidStuio工程中就不包含这几个so,所以在64位的安卓上调用so失败。
解决办法:
在Unity中把出错的这几个so设置正确的平台,平台选择Android,CPU选择ARM64,然后重新出包就解决了。