KSY Streamer Android SDK是金山云推出的 Android 平台上使用的软件开发工具包(SDK), 负责视频直播的采集和推流。
- 支持软编和硬编
- 网络自适应， 可根据实际网络情况动态调整目标码率，保证流畅性
- 音频编码：AAC
- 视频编码：H.264
- 推流协议：RTMP
- 视频分辨率：支持360P, 480P, 540P和720P
- 音视频目标码率：可设
- 支持固定横屏或固定竖屏推流
- 支持前、后置摄像头动态切换
- 前置摄像头镜像功能
- 闪光灯：开/关
- 内置美颜功能
- 自定义美颜接口
- 美声
- 背景音乐功能, 支持本地mp3, aac等格式
- 支持手动指定自动对焦测光区域
- 支持图片及时间水印
- 耳返(new)
- 画中画(new,仅硬编支持)
- 最低支持版本为Android 4.0 (API level 15)
- 支持的cpu架构：armv7, arm64, x86
软硬编部分功能版本需求列表:
| 软编 | 硬编 | |
|---|---|---|
| 基础推流 | 4.0 (15) | 4.3 (18) |
| 网络自适应 | 4.0 (15) | 4.4 (19) |
本章节提供一个快速集成金山云推流SDK基础功能的示例。更详细的文档地址：https://github.com/ksvc/KSYStreamer_Android/wiki
具体可以参考demo工程中的相应文件。
从github下载SDK及demo工程：
https://github.com/ksvc/KSYStreamer_Android.git
- demo: 示例工程，演示本SDK主要接口功能的使用
- doc: SDK说明文档
- libs: 集成SDK需要的所有库文件
- libs/[armeabi-v7a|arm64-v8a|x86]: 各平台的so库
- libs/ksylive3.0.jar: 推流SDK jar包
- libs/libksystat.jar: 金山云统计模块
引入目标库, 将libs目录下的库文件引入到目标工程中并添加依赖。
可参考下述配置方式（以Android Studio为例）：
- 将libs目录copy到目标工程的根目录下；
- 修改目标工程的build.gradle文件，配置jniLibs路径：
sourceSets {
main {
...
jniLibs.srcDir 'libs'
}
...
}- 修改proguard文件，需要保持com.ksy.recordlib下的所有类：
-keep class com.ksy.recordlib.** { *;}
- 在AndroidManifest.xml文件中申请相应权限
<!-- 使用权限 -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_SINTERNETWIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.FLASHLIGHT" />
<uses-permission android:name="android.permission.VIBRATE" />
<!-- 硬件特性 -->
<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />具体可参考demo工程中的com.ksy.recordlib.demo.CameraActivity类
- 在布局文件中加入预览View
<com.ksy.recordlib.service.view.CameraGLSurfaceView
android:id="@+id/camera_preview"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:layout_alignParentBottom="true"
android:layout_alignParentTop="true" />- 初始化GLSurfaceView
GLSurfaceView mCameraPreview = (GLSurfaceView)findViewById(R.id.camera_preview)- 创建并配置KSYStreamerConfig, KSYStreamerConfig采用了Builder模式。 推流过程中不可动态改变的参数需要在创建该类的对象时指定。
KSYStreamerConfig.Builder builder = new KSYStreamerConfig.Builder();
// 设置推流url（需要向相关人员申请，测试地址并不稳定！）
builder.setmUrl("rtmp://test.uplive.ksyun.com/live/{streamName}");
/**
* 设置推流分辨率，支持以下值：
* RecorderConstants.VIDEO_RESOLUTION_360P
* RecorderConstants.VIDEO_RESOLUTION_480P
* RecorderConstants.VIDEO_RESOLUTION_540P
* RecorderConstants.VIDEO_RESOLUTION_720P
*/
builder.setVideoResolution(RecorderConstants.VIDEO_RESOLUTION_360P);
// 设置视频帧率
builder.setFrameRate(15);
// 设置视频码率(分别为最大、最小、初始码率, 单位为kbps)
builder.setMaxAverageVideoBitrate(800);
builder.setMinAverageVideoBitrate(200);
builder.setInitAverageVideoBitrate(500);
// 设置音频码率(单位为kbps)
builder.setAudioBitrate(48);
// 设置音频采样率(硬编模式下暂时无效)
builder.setSampleAudioRateInHz(44100);
/**
* 设置编码模式(软编、硬编), 支持的类型：
* KSYStreamerConfig.ENCODE_METHOD.SOFTWARE
* KSYStreamerConfig.ENCODE_METHOD.HARDWARE
*/
builder.setEncodeMethod(KSYStreamerConfig.ENCODE_METHOD.SOFTWARE);
// 设置是否采用横屏模式
builder.setDefaultLandscape(false);
// 开启推流统计功能
builder.setEnableStreamStatModule(true);
// 创建KSYStreamerConfig对象
KSYStreamerConfig config = builder.build();- 创建推流事件监听，可以收到推流过程中的异步事件。
注意：该回调直接运行在产生事件的各工作线程中，不要在该回调中做任何耗时的操作，或者直接调用推流API。
public OnStatusListener mOnStatusListener = new OnStatusListener() {
@Override
public void onStatus(int what, int arg1, int arg2, String msg) {
// msg may be null
switch (what) {
// ...
}
}
}- 创建KSYStreamer对象
mStreamer = new KSYStreamer(this);
mStreamer.setConfig(config);
mStreamer.setDisplayPreview(mCameraPreview);
mStreamer.setOnStatusListener(mOnStatusListener);- 开始推流
注意：初次开启预览后需要在mOnStatusListener回调中收到RecorderConstants.KSYVIDEO_INIT_DONE 事件后调用方才有效。
mStreamer.startStream();- 推流过程中可动态设置的常用方法
// 切换前后摄像头
mStreamer.switchCamera();
// 开关闪光灯
mStreamer.toggleTorch(true);
// 设置美颜滤镜，关于美颜滤镜的具体定义值及说明请参见后续章节
mStreamer.setBeautyFilter(RecorderConstants.FILTER_BEAUTY_DENOISE);- 停止推流
mStreamer.stopStream();- Activity的生命周期回调处理
采集的状态依赖于Activity的生命周期，所以必须在Activity的生命周期中也调用SDK相应的接口。
public class CameraActivity extends Activity {
// ...
@Override
public void onResume() {
super.onResume();
mStreamer.onResume();
}
@Override
public void onPause() {
super.onPause();
mStreamer.onPause();
}
@Override
public void onDestroy() {
super.onDestroy();
mStreamer.onDestroy();
}
}如有其它需求可以联系我们 ##反馈与建议
- 主页：金山云
- 邮箱：[email protected]