在开始集成 ZEGO Express SDK 前,请确保开发环境满足以下要求:
Android Studio 版本编号系统的变更请参考 Android Studio 版本说明。
打开 Android Studio,选择 “File > New > New Project” 菜单。
填写项目名及项目存储路径。
其它按照默认设置,单击 “Next”,最后单击 “Finish” 完成新工程创建。
目前支持的平台架构包括:armeabi-v7a、arm64-v8a、x86、x86_64。
开发者可通过以下任意一种方式实现集成 SDK。
进入项目根目录,打开 “build.gradle” 文件,在 “allprojects” 中加入如下代码。
...
allprojects {
repositories {
maven { url 'https://www.jitpack.io' }
google()
jcenter()
}
}
进入 “app” 目录,打开 “build.gradle” 文件,在 “dependencies” 中添加 implementation 'com.github.zegolibrary:express-audio:2.+'
,这样能获取到最新的版本,如果需要下载指定版本,请从 https://jitpack.io/#zegolibrary/express-audio 查询具体版本号,并将 2.+
修改为指定的版本号。
...
dependencies {
...
implementation 'com.github.zegolibrary:express-audio:2.+'
}
build.gradle
里的配置变更为 'com.github.zegolibrary:express-audio:2.+'
。implementation 'im.zego:express-engine-audio:x.y.z'
改为 implementation 'im.zego:express-audio:x.y.z'
。使用 1.11.0 以下 的版本不受影响,但后续不再从 “express-engine-audio” 里更新,建议所有使用旧版本的开发者切换到 1.11.0 或以上 的版本进行集成。请参考 下载 SDK 包 ,下载最新版本的 SDK。
解压 SDK 至项目目录,如 “app/libs”。
添加 SDK 引用,进入到 “app” 目录,打开 “build.gradle” 文件。
在 “defaultConfig” 节点添加 “ndk” 节点,指定支持的平台类型。
ndk {
abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
}
在 “android” 节点添加 “sourceSets” 节点,指定 “libs” 所在目录。
示例代码中 “libs” 目录仅为举例,开发者可根据实际路径填写。
sourceSets {
main {
jniLibs.srcDirs = ['libs']
}
}
在 “dependencies” 节点引入 “libs” 下所有的 jar。
implementation fileTree(dir: 'libs', include: ['*.jar'])
根据实际应用需要,设置应用所需权限。
进入 “app/src/main” 目录,打开 “AndroidManifest.xml” 文件,添加权限。
<!-- SDK 必须使用的权限 -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- App 需要使用的部分权限 -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-feature
android:glEsVersion="0x00020000"
android:required="true" />
<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />
因为 Android 6.0 在一些比较重要的权限上要求必须申请动态权限,不能只通过 “AndroidMainfest.xml” 文件申请静态权限。因此还需要参考执行如下代码,其中 “requestPermissions” 是 “Activity” 的方法。
String[] permissionNeeded = {
"android.permission.RECORD_AUDIO"};
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
if (ContextCompat.checkSelfPermission(this, "android.permission.RECORD_AUDIO") != PackageManager.PERMISSION_GRANTED) {
requestPermissions(permissionNeeded, 101);
}
}
在 “proguard-rules.pro” 文件中,为 SDK 添加 -keep
类的配置,防止混淆 SDK 公共类名称。
-keep class **.zego.**{*;}
联系我们
文档反馈