集成 SDK
更新时间: 2022/05/18 06:15:52
本文为您展示通过 NELiveKit 实现 PK 连麦场景的相关步骤,帮助您在业务中实时音视频通话、互动直播、连麦 PK、文字聊天、收发礼物等 PK 连麦场景下的相关能力。
前提条件
在客户端实现互动直播功能之前,请确保您已完成以下操作:
-
已创建 NERoom 应用,并开通相关能力。
-
在网易云信控制台的 NERoom 列表中获取指定应用的 App Key。
开发环境
在客户端实现互动直播功能之前,请您准备以下开发环境:
环境类型 | 具体要求 |
---|---|
JDK | 1.8.0 及以上版本 |
Android API 版本 | Android SDK API 等级 21 及以上, Android 5.0 及以上版本 |
CPU 架构 | 支持 ARM64、ARMV7 架构 |
IDE | Android Studio |
其他 | 依赖 Androidx,不支持 support 库 |
集成 SDK
-
新建 Android 工程。
- 运行 Android Sudio,在顶部菜单依次选择 File > New > New Project 新建工程。再依次选择 Phone and Tablet > Empty Activity,单击 Next。
- 配置工程相关信息,请注意 Minimum SDK 的 Android API Level 为 API 21。
- 单击 Finish 完成工程创建。
-
添加 SDK 编译依赖。
- 修改工程目录下的 'app/build.gradle' 文件,添加互动直播 SDK 的依赖。
groovy
android { // 添加 packagingOptions,否则可能会造成资源文件冲突 packagingOptions { pickFirst 'lib/arm64-v8a/libc++_shared.so' pickFirst 'lib/armeabi-v7a/libc++_shared.so' } } dependencies { //声明 SDK 依赖,具体版本可根据您的实际需要修改。 implementation 'com.netease.yunxin.kit.live:livekit:1.0.0' }
- 在顶部菜单依次选择 Build > Make Project 构建工程,触发依赖下载,完成后即可在代码中引入 SDK 中的类和方法。
-
权限处理
NELiveKit 应用正常工作需要应用获取以下权限
xml
<!-- 网络相关 --> <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.CHANGE_WIFI_STATE" /> <!-- 读写外部存储 --> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <!-- 多媒体 --> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> <uses-permission android:name="android.permission.CAMERA" /> <uses-permission android:name="android.permission.RECORD_AUDIO" /> <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
以上权限已经在 SDK 内部声明,您无需在
AndroidManifest.xml
文件中重新声明这些权限。
但运行 SDK 时的权限申请需要您自己编码实现,您可在应用首页中统一申请,详情可参考 Android 运行时权限申请示例。如果运行时对应权限缺失,SDK 可能无法正常工作,如出现直播时无图像、对端听不到本端的声音等情况。
此文档是否对你有帮助?