GuardYang/KSYMediaPlayer_Android

金山云Android播放SDK（KSYUN Live Streaming player SDK），支持RTMP HTTP-FLV HLS 协议（supporting RTMP HTTP-FLV HLS protocol），直播延时2-3秒（Living delay 2 or 3 seconds），supporting jitter control，software&hardware decode

金山云Android播放SDK

1.产品概述

金山云Android播放SDK特有的直播优化策略能提供一流的直播体验，为Android开发者提供简单、快捷的接口，帮助开发者实现Android平台上的多媒体播放应用。

1.1 版本信息

LICENSE和版本信息：LICENSE

1.2 关于费用

金山云SDK保证，提供的KSYMediaPlayer Android播放SDK可以用于商业应用，不会收取任何SDK使用费用。但是基于KSYMediaPlayer Android播放SDK的其他商业服务，会由特定供应商收取授权费用，大致包括：

1. 云存储
2. CDN分发

2.KSYMediaPlayer SDK 功能说明

• 接口定义与Android系统播放器MediaPlayer保持一致
• 提供KSYTextureView控件
• 支持首屏秒开
• 可设置播放器直播场景下最大缓存时长
• 支持直播追赶(RTMP和HTTP+FLV)，降低主播和观众的延迟
• 支持RTMP和HTTP+FLV直播方式
• 点播库支持多种格式(RMVB、AVI、MKV)
• 支持软解和MediaCodec硬解
• 支持视频旋转(0/90/180/270度)
• 支持播放截图
• 支持视频画面缩放模式
• 支持镜像播放
• 支持获取本地视频信息与视频缩略图
• 支持获取视频原始数据(YUV/RGB)
• 支持获取音频原始数据(PCM)
• KSYMediaPlayer支持多实例
• 支持音量调节，可静音播放
• 支持后台播放
• 支持纯音频播放
• 支持H.265/HEVC播放
• 支持在线查看文档
• 支持反交错功能
• 支持音量放大，最大可以放大两倍

2.1 直播库与点播库

支持的文件封装格式和音视频编码标准如下所示：  

信息	直播	点播(完整包含直播所有功能)
流协议	HLS, RTMP, HTTP,HTTPS, FILE	HLS, RTMP, RTSP, HTTP, HTTPS, FILE
封装格式	FLV, TS, MPEG, MOV, M4V, MP3, AAC, GIF, ASF, RM	FLV, TS, MPEG, MOV, M4V, MP3, AAC, GIF, ASF, RM, MKV, AVI, WEBM
视频编码格式	H263, H264, H265, MPEG1, MPEG2, MPEG4, AVS, MJPEG, JPEG2000, GIF	H263, H264, H265, MPEG1, MPEG2, MPEG4, MJPEG, VC-1, WMV, RV40, PNG, JPEG, YUV, WEBP, TIFF, VP*
音频编码格式	AAC, MP3, NELLYMOSER, AMRNB, AMRWB, WMV1, WMV2, WMV3	AAC, MP3, NELLYMOSER, AMRNB, AMRWB, WMV1, WMV2, WMV3, OGG, FLAC, DTS, COOK

点播库包含直播库全部功能，并且额外支持了更多的vod格式。

• libs_live 提供直播SDK
• libs_vod 提供点播SDK，完整包含直播所有功能

2.2 SDK文档

详情请见wiki

3.下载并使用SDK

3.1 下载SDK

KSYMediaPlayer下载方式：

github下载

• 从github下载：https://github.com/ksvc/KSYMediaPlayer_Android.git

解压缩后包含 demo、doc、README.md 四个部分, 解压后的目录结构如下所示:

• KsyunPlayerDemo/ 目录存放KSY Android Player Demo，用于帮助开发都快速了解如何使用SDK。
• doc/ 目录存放接口参考文档。
• libs_live/ 目录包括直播so库，现提供了Android全部体系结构的支持。
• libs_vod/ 目录包括点播so库，现提供了Android全部体系结构的支持。
• README.md 即本文档。

需要注意的是：KsyunPlayerDemo/playerlib/libs 目录下只有 armeabi-v7a 的直播库，便于用户快速使用KsyunPlayerDemo，用户可根据自身需要将对应平台的动态库放至该目录下即可

直播库与点播库的区别可见链接: https://github.com/ksvc/KSYMediaPlayer_Android/wiki/LiveAndVod

oschina下载

• 从oschina下载：http://git.oschina.net/ksvc/KSYMediaPlayer_Android

对于部分地方访问github比较慢的情况，可以从oschina clone，获取的库内容和github一致。

$ git clone https://git.oschina.net/ksvc/KSYMediaPlayer_Android.git

3.2 注意事项

集成SDK注意事项

3.3 KSYMediaPlayer的使用方法

在上述步骤之后，SDK已经集成至开发工程中，下面将给出KSYMediaPlayer的基本调用示例
KSYMediaPlayer基本调用示例

4.接口说明

请见doc目录下的详细接口说明

5.其他文档

用户如果有疑问，可访问此链接
GitHub WiKi
直播延迟相关设置
本地视频缩略图
重置播放器&重新播放
画面拉伸

6.反馈与建议

• 主页：金山云
• 邮箱：zengfanping@kingsoft.com
• QQ讨论群：574179720 [视频云技术交流群]
• Issues：https://github.com/ksvc/KSYMediaPlayer_Android/issues