Android Push SDK 开发指南
请仔细阅读本文档,以便于您更好的集成sdk的功能
[TOC]
1.文档介绍
1.1 文档目的
利用 Android Push SDK 可以与云直播服务进行对接,在Android端使用视频的推流功能。当前 Android Push SDK 的版本具有直播、聊天、美颜等功能。
1.2 术语和缩写解释
无
1.3 最低版本要求
Android 4.3
2. SDK使用介绍
在清单文件中配置权限
......
<uses-permission android:name="android.permission.CAMERA"/>
<uses-permission android:name="android.permission.RECORD_AUDIO"/>
<uses-permission android:name="android.permission.WAKE_LOCK"/>
<uses-permission android:name="android.permission.FLASHLIGHT"/>
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>
<uses-feature
android:name="android.hardware.camera"
android:required="true"/>
<uses-feature android:name="android.hardware.camera.autofocus"/>
......
2.1 源码集成
2.1.1 依赖库文件
dwpush.jar : sdk核心库
engine-0.8.3.1.jar:网络核心库
dwrtmp.so : sdk动态库
在项目build.gradle中配置SDK依赖库
......
// 推流端核心库
implementation files('libs/dwpush.jar')
// 网络请求核心库,同播放端SDK相同,解耦出来便于使用
implementation files('libs/engine-0.8.3.1.jar')
......
2.1.2 加载流程
复制libs包的jar到工程libs文件夹,将libdwrtmp.so各个cpu架构的库放在src/mian/jinLibs,您就可以使用提供的推流sdk功能了。
2.2 maven集成
2.1.0版本开始提供maven集成方式,如果需要使用maven远程引用需要在项目根目录build.gradle中的repositories节点添加
maven {
http://nexus-app.bokecc.com/repository/sdk-group/
}
然后在需要引用的模块路径下的build.gradle中添加
dependencies {
implementation 'com.bokecc:dwpush:2.2.0'
}
2.3 混淆编译
dwpush.jar 已经混淆过,如果需要对应用进行混淆,需要在混淆的配置文件增加如下代码,防止dwpush的二次混淆:
...
-keep public class com.bokecc.sdk.mobile.**{*;}
-keep public interface com.bokecc.sdk.mobile.**{*;}
...
3. SDK初始化
3.1 主动调用API
直播需要主动调用的方法在DWPushEngine.java(DWPushEngine为单例)中,如下:
方法 | 说明 |
---|---|
init(Context context, boolean isLogOut, boolean isSecure) | 初始化 |
初始化必须在登录之前进行 |
@param context Application
@param isLogOut 是否开启日志输出
@param isSecure 是否使用HTTPS
......
DWPushEngine.init(this, true, true);
......
4. 集成说明
请按照上述配置进行操作,就完成了SDK基本的配置