Home

FAQ

Q1. 从服务器上下载的视频无法播放 Error 0x5 parse config fail

有很多人反馈，从服务器上下载的视频无法播放（或播放内容严重错误）。经过调试，发现是服务器对mp4文件进行了修改（比如压缩），导致vapc节点丢失，播放失败（Android上会有此日志：vapc box head not found 或错误 10005 0x5 parse config fail ）。

从网络上下载的素材，强烈建议进行md5校验，在工具导出的时候已经生成了一份md5，播放前需要进行md5的校验，防止播放被篡改的文件。至于服务器篡改mp4文件问题，需要自己业务负责修正。

Q2. Android部分手机出现绿屏幕现象

可能原因是视频分辨率过高，我们做过兼容性测试，长或宽超过1504的视频，某些手机解码会出现绿屏现象，解决方法：减小原始素材的分辨率，不要超过1504.

Q3. 视频播放出现10002错误

如果出现此错误：onFailed errorType=10002, errorMsg=0x2 MediaCodec exception

先检查下是否视频分辨率过高，比如达到2k或4k分辨率，低端机器视频分辨率过高会导致解码失败，解决方法：减小原始素材的分辨率，不要超过1504.

Q4. stop完后调用start无法播放，提示is running

stop调用是异步操作，动画并不会马上停止，而是在异步线程里停止，所以调用完stop后马上调用start会失败，需要等待onComplete的回调后，才能再次调用start进行播放。

Q5. 有些素材播放出现黑边的问题

生成素材是使用alpah 0.5的情况是有可能导致出现黑边情况，但大多数素材效果都能接受，如果黑边情况很难接受，可以选择使用alpha 1.0（但会导致视频分辨率变大，可能出现兼容问题无法正常播放）。可以参考此issue https://github.com/Tencent/vap/issues/259

VapTool FAQ

Q1. 使用Mac提示"无法打开ffmpeg" "无法打开mp4edit"

运行工具过程中出现以上提示后，打开系统 System Preferences -> Security & Privacy 赋予权限后再次运行。

或者在终端命令行里，执行

chmod +x mac/ffmpeg
chmod +x mac/mp4edit

赋予这两命令执行权限

Q2. 使用Window工具提示 "mergeBin2Mp4" 失败

可能原因：缺失VCRUNTIME140_1.dll文件导致。可以在别人电脑上拷贝或上网下载，可以参考此issue https://github.com/Tencent/vap/issues/56

Q3. 提示视频分辨率超过1504

[Warning] Output video width: xxx or height: xxx is over 1504. Some devices will display exception. For example green screen!

最终生成视频分辨率（宽或高）超过1504，不建议超过1504的提示。超过1504可能会出现花屏和绿屏这些问题，这是个经验值，大部分机型上这个值能正常运行。这只是个提醒不影响视频正常生成。

Q4. 导出视频模糊（提高VAP清晰度的方式）

mp4是视频格式，相当于位图。要提升vap的清晰度推荐方式：1）先保证输出的帧图片png是清晰的；2）增加码率(默认2500)到可以接受的清晰度或使用crf方式(crf=0 相当于没有压缩)；3）可以选择使用h265编码，相同码率下会更清晰，但兼容性不好，老旧手机不一定能播放。一般来说越清晰素材越大，根据自己的需求做选择。