一分钟集成 SDK

编辑文档更新于 2025-01-16 07:59:52

AndroidiOSWebuni-appHarmonyOS

本文主要介绍 一分钟集成 SDK, 将 BRTC SDK 快速集成到您的项目中。

开发环境要求

Android 6.0 (Level 23) 及以上版本
Android Studio 官网最新版本
Java 1.8

集成 SDK（aar）

您可以选择使用在线依赖自动加载的方式（推荐），或者手动下载 aar 再将其导入到您当前的工程项目中

方法一：在线依赖

1. 添加 maven 仓库地址

在 Android Studio 打开需要集成 SDK 的工程，首先添加 BRTC SDK 的 maven 仓库地址，通常位于app/build.gradle：

在app-build.gradle中添加maven地址

或settings.gradle中：

在settings-build.gradle中添加maven地址

maven 仓库地址如下：

maven {
    url 'https://git2.baijiashilian.com/open-android/maven/raw/master/'
}

2. 添加 SDK 在线依赖

修改 app/build.gradle 文件，在 dependencies 中添加 BRTC 的依赖地址：

implementation 'com.baijia.player:brtc:latest.release'

在线依赖

需要在 defaultConfig 中，指定 App 使用的 CPU 架构：

defaultConfig {
   ndk {
       abiFilters "arm64-v8a","armeabi-v7a", "armeabi"
   }
}

目前 BRTC 仅支持 armeabi armeabi-v7a 和 arm64-v8a 架构

另外，避免出现库冲突问题，建议您在项目的gradle.properties中添加下面的配置：

android.enableJetifier=true

enableJetifier

方法二：文件依赖

文件依赖示意图

下载最新版本的 BRTC SDK
将下载到的 aar 文件拷贝到工程的 app/libs 目录下
在工程根目录下的 build.gradle(Project) 中,添加 flatDir,指定本地仓库路径

repositories {
    google()
    jcenter()

    flatDir {
        dirs 'libs'
    }
}

在 app/build.gradle(Module) 文件中添加 BRTC 的依赖

dependencies {
    implementation (name:'libbrtc-release', ext:'aar')
}

在 defaultConfig 中，指定 App 使用的 CPU 架构

defaultConfig {
   ndk {
       abiFilters "arm64-v8a","armeabi-v7a", "armeabi"
   }
}

目前 BRTC 仅支持 armeabi armeabi-v7a 和 arm64-v8a 架构

avatar

配置 App 权限

在 AndroidManifest.xml 中配置 App 的权限, BRTC SDK 需要以下权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />

设置混淆规则

如果您的 App 在 release 版本中设置了minifyEnabled为 true（开启代码混淆），为了避免出现运行时异常，请在 App 的proguard-rules.pro 文件中添加 BRTC SDK 相关类的混淆规则：

-optimizations !code/simplification/arithmetic,!field/,!class/merging/,!code/allocation/variable

-keepattributes SourceFile,LineNumberTable
-keep class org.brtc.sdk.*{*;}
-keep class org.brtc.sdk.model.**{*;}
-keep class com.tencent.** { *; }
-keep class org.brtc.webrtc.**{*;}
-keep class org.brtc.webrtc.audio.**{*;}
-keep class org.brtc.webrtc.voiceengine.**{*;}
-keep class org.brtc.webrtc.sdk.*{*;}
-keep class org.brtc.webrtc.sdk.bean.*{*;}
-keep class org.brtc.webrtc.sdk.audio.AudioSink{*;}

-keepclassmembers class * {
    @org.brtc.webrtc.CalledByNative <fields>;
}
-keepclassmembers class * {
    @org.brtc.webrtc.CalledByNative <methods>;
}

完成以上步骤，您便完成了 BRTC SDK 的集成，快去写一段代码试试吧。