Source Type: Binary SDK Charge Type: free of charge
本文档面向所有使用金山云直播SDK的开发、测试人员等, 要求读者具有一定的Android编程开发经验,并且要求读者具备阅读wiki的习惯。
金山云直播SDK是金山云提供的直播解决方案的一部分,完成了Android端音视频数据采集、处理、推流和播放的工作。
金山云直播SDK不限制用户的推流、拉流地址。用户可以只使用金山云直播SDK而不使用金山云的云服务。
金山云直播SDK不收取任何授权使用费用,不含任何失效时间或者远程下发关闭的后门。同时金山云直播SDK也不要求ak/sk等鉴权,没有任何用户标识信息。
金山云直播SDK提供了业内一流的H.265编码、解码能力,H.265能力也是免费使用,欢迎集成试用。
金山云直播SDK当前未提供开源代码,如果需要其他定制化开发功能,请通过金山云商务渠道联系。
KSYLive库融合了Android 播放和推流SDK。旨在提供业内一流的移动直播SDK。具体功能:
- 美颜
- 滤镜
- 美声
- 背景音乐功能
- 多种动态贴纸
- 录屏
- 秒开加速
- 低延时直播
- 弱网优化
- 卡顿优化
- 丰富的软硬编、软硬解支持
- 悬浮窗推流
- 画笔推流(android.view.View合成推流)(new)
- 短视频编辑
- 音频升降调(new)
- 音频降噪(new)
具体推流功能请见:
具体播放功能请见:
- 最低支持版本为Android 4.0 (API level 15)
- 支持的CPU架构:armv5,armv7, arm64, x86,
金山云SDK保证,提供的KSYLive Android直播SDK可以用于商业应用,不会收取任何SDK使用费用。
但是基于KSYLive Android直播SDK的其他商业服务,会由特定供应商收取授权费用,大致包括:
- 云存储
- CDN分发
- 动态贴纸
- 连麦
- 第三方美颜
- KSYMediaPlayer wiki https://github.com/ksvc/KSYMediaPlayer_Android,介绍了如何使用直播播放(观众侧)。
- KSYStreamer wiki https://github.com/ksvc/KSYStreamer_Android,介绍了如何使用直播推流(主播侧)。
此说明以加入arm64-v8a X86 armeabi-v7a 三个体系结构为例进行说明
注明:
- lib 为项目动态库so的大小
- res 资源文件目录
- classes.dex dalvik 字节码
- 项目总大小是 lib/res/classes.dex等未压缩的大小
- apk size是将项目总大小打包后的大小
名称 | 库名称 | lib | res | classes.dex | 项目总大小 | apk size |
---|---|---|---|---|---|---|
播放SDK | libksyplayer.so | 12.7M | 1.5M | 2.8M | 17.3M | 6.8M |
推流+播放SDK | libksystreamer.so | 30.5M | 1.5M | 2.8M | 35.5M | 14.6M |
直播融合库 | libksylive.so | 19.8M | 1.6M | 3.3M | 25.1M | 10.1M |
这里可以看出,融合库比单纯推流和播放的apk size从14.6M减小了4.5M,到10.1M。(当然,如果不使用三个体系结构的话,并不会到10M大小。如果对apk size敏感,建议只使用armeabi-v7a库。) 推荐大家使用融合库!
当前KSYLive_Android支持以下体系结构:
- armeabi
- armeabi-v7a
- arm64-v8a
- x86
为了节省apk size,如果没有特殊缘由,请只集成armeabi-v7a版本。
只集成armeabi-v7a版本,会导致ARMv5 ARMv6 设备不能运行。如果APP需要适配这两类设备,需要额外集成armebi版本。 ARMv5 ARMv6 设备计算性能较差,金山云不保证该芯片设备上的直播体验。不推荐直播APP视频适配该两款芯片设备。
- 推荐直接使用gradle方式集成:
# required
allprojects {
repositories {
jcenter()
}
}
dependencies {
# required, enough for most devices.
compile 'com.ksyun.media:libksylive-java:3.0.4'
compile 'com.ksyun.media:libksylive-armv7a:3.0.4'
# Other ABIs: optional
compile 'com.ksyun.media:libksylive-arm64:3.0.4'
compile 'com.ksyun.media:libksylive-x86:3.0.4'
}
-
clone github库,使用github库中的demo和lib库。
-
或者从oschina镜像下载,国内访问速度更快:https://git.oschina.net/ksvc/KSYLive_Android
已知的问题可参见FAQ
类型 | 描述 |
---|---|
SDK名称 | KSYLive_android |
SDK版本 | v3.0.4 |
设备型号 | oppo r9s |
OS版本 | Android 6.0.1 |
问题描述 | 描述问题出现的现象 |
操作描述 | 描述经过如何操作出现上述问题 |
额外附件 | 文本形式控制台log、crash报告、其他辅助信息(界面截屏或录像等) |