快速开始
示例项目
千学云 在 Git 上提供了:QXC-ANDROID的Demo程序,方便您的使用。
前提条件
- Android studio 3.0 或 以上版本
- 支持Android5.0 或 以上版的设备
- Android SDK API 等级 16 或以上
创建Android项目
1.打开 Android Studio,点击 Start a new Android Studio project。
2.在 Select a Project Template 界面,选择 Phone and Tablet > Empty Activity,然后点击 Next。 在 Configure Your Project 界面,依次填入以下内容:
- Name:你的 Android 项目名称,如 HelloQXC
- Package name:你的项目包的名称,如 io.qxc.helloqxc
- Save location:项目的存储路径
- Language:项目的编程语言,如 Java
- Minimum API level:项目的最低 API 等级,这里填写16
3.然后点击 Finish。根据屏幕提示,安装可能需要的插件。
防止代码混淆
在 app/proguard-rules.pro 文件中添加如下行,防止混淆 QXC SDK 的代码:
-keepattributes *Annotation*
-keepclassmembers class ** {
@org.greenrobot.eventbus.Subscribe <methods>;
}
# 设置所有 native 方法不被混淆
-keepclasseswithmembernames class * {
native <methods>;
}
-keep enum org.greenrobot.eventbus.ThreadMode { *; }
-keep class com.qxc.**{*;}
-keep class org.webrtc.**{*;}
-keep class tv.qxcdanmaku.**{*;}
集成SDK
方法一:使用maven集成
在主工程的build.gradle文件中添加maven配置
allprojects { repositories { ... maven { url "https://jitpack.io" } maven { // maven针对不通的机构,url会不一样,需要联系管理员获取自己的url地址 url 'https://maven.qianxuecloud.com/repository/qxc-android-release' } } }
- 在需要集成的项目的 build.gradle 文件中引入sdk,添加如下行:
... dependencies { ... // x.y.z 请填写具体版本号,如 1.0.0 // 可通过 SDK 发版说明获取最新版本号 // 版本针对不通的机构会不一样,需要联系管理员获取自己最新的版本号 // 下载的核心包 implementation 'com.qxc:qxcclassdownloadcorelib:x.y.z' // 直播插件包 implementation 'com.qxc:qxcclasslivepluginsdk:x.y.z' }
全局初始化配置
在项目的Application类中,添加QXC的初始化调用
@Override
public void onCreate() {
....
// 初始化全局配置
QXCConfig.init(this);
// 测试环境
Api.updateUrlEnv(EnvConstrant.TEST_ENV_TYPE);
// 线上环境
// Api.updateUrlEnv(EnvConstrant.ONLINE_EVN_TYPE);
}