Home

金山云Android播放SDK说明

KSY MediaPlayer Android SDK是金山云推出的Android平台上的软件开发工具包（SDK），主要功能是播放直播或者点播流

功能特点

• 接口定义与Android系统播放器MediaPlayer保持一致
• 提供KSYTextureView控件
• 支持直播秒开
• 支持直播追赶，降低主播和观众的延迟
• 支持RTMP和HTTP+FLV直播方式
• 点播库支持多种格式(RMVB、AVI、MKV)
• 支持软解和MediaCodec硬解
• 支持视频旋转(0/90/180/270度)
• 支持播放截图
• 支持多种视频画面填充模式
• 支持获取本地视频信息与视频缩略图
• 支持获取视频原始数据
• 直播播放镜像
• 支持音量调节，可静音播放
• 支持后台播放
• 支持H.265/HEVC播放

运行环境

• 最低支持Android系统版本：2.3
• 支持CPU架构：armv5/armv7a/arm64/x86/x86_64

快速集成

下载工程

可从github下载SDK和相应的demo，地址如下：

https://github.com/ksvc/KSYMediaPlayer_Android

工程目录结构

SDK提供了直播库与点播库，其区别可查看如下链接https://github.com/ksvc/KSYMediaPlayer_Android/wiki/LiveAndVod
直播库与点播库下的jar包并无区别

• KsyunPlayerDemo: 播放SDK的demo工程
• doc: 接口文档
• libs_live: 直播库
  • libs_live/[armeabi/armeabi-v7a/arm64-v8a/x86/x86_64]: 各平台的动态库
  • libs_live/libksyplayer.jar: 播放SDK的jar包
  • libs_live/libksystat.jar: 金山云统计模块
• libs_vod: 点播库
  • libs_vod/[armeabi/armeabi-v7a/arm64-v8a/x86/x86_64]: 各平台的动态库
  • libs_vod/libksyplayer.jar: 播放SDK的jar包
  • libs_vod/libksystat.jar: 金山云统计模块

配置工程

此节内容适合使用Android Studio作为开发环境的用户。 在引入SDK的资源后，须在工程的build.gradle中添加如下内容：

//新版本直播库已支持jcenter
//dependencies {
//    compile files('src/main/libs/libksyplayer.jar')
//    compile files('src/main/libs/libksystat.jar')
//}
//引用jcenter
dependencies {
    ...
    compile 'com.ksyun.media:libksyplayer-java:1.9.2'
    compile 'com.ksyun.media:libksyplayer-armv7a:1.9.2'
    compile 'com.ksyun.media:libksyplayer-arm64:1.9.2'
    ...
}

新版本直播库已支持jcenter

混淆

请不要混淆SDK提供的jar包，在混淆配置中可添加如下语句

-keep class com.ksyun.media.player.**{ *; }
-keep class com.ksy.statlibrary.**{ *;}

系统权限

在您开始开发前，需要在您AndroidManifest.xml里添加如下权限，如若没有添加相应的权限，则会出现播放错误

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />