集成 SDK

更新时间: 2022/05/18 06:15:52

本文为您展示通过 NELiveKit 实现 PK 连麦场景的相关步骤,帮助您在业务中实时音视频通话、互动直播、连麦 PK、文字聊天、收发礼物等 PK 连麦场景下的相关能力。

前提条件

在客户端实现互动直播功能之前,请确保您已完成以下操作:

  1. 已创建 NERoom 应用,并开通相关能力。

  2. 在网易云信控制台的 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

  1. 新建 Android 工程。

    1. 运行 Android Sudio,在顶部菜单依次选择 File > New > New Project 新建工程。再依次选择 Phone and Tablet > Empty Activity,单击 Next
    image
    1. 配置工程相关信息,请注意 Minimum SDK 的 Android API Level 为 API 21。
    image
    1. 单击 Finish 完成工程创建。
  2. 添加 SDK 编译依赖。

    1. 修改工程目录下的 'app/build.gradle' 文件,添加互动直播 SDK 的依赖。
    groovyandroid {
      // 添加 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'
    }
    
    1. 在顶部菜单依次选择 Build > Make Project 构建工程,触发依赖下载,完成后即可在代码中引入 SDK 中的类和方法。
  3. 权限处理

    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 可能无法正常工作,如出现直播时无图像、对端听不到本端的声音等情况。

此文档是否对你有帮助?
有帮助
去反馈
  • 前提条件
  • 开发环境
  • 集成 SDK