集成 SDK

更新时间: 2024/10/29 16:02:24

本文为您展示通过 NEMeetingKit 实现音视频会议的相关步骤,帮助您在业务中实现创建会议、预约会议、查询会议信息等在线会议场景下的相关能力。

前提条件

在根据本文操作前,请确保您已在网易云信控制台上,完成以下设置:

  1. 网易云信控制台 创建至少一个应用。若无应用,请参考 创建应用并获取 AppKey
  2. 开通 视频会议 解决方案。具体步骤可参考 开通方案

开发环境

在客户端实现音视频会议功能之前,请您准备以下开发环境:

环境类型 具体要求
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 Studio,在顶部菜单依次选择 File > New > New Project 新建工程。再依次选择 Phone and Tablet > Empty Activity,单击 Next

      image
    2. 配置工程相关信息,请注意 Minimum SDK 的 Android API Level 为 API 21。

      image
    3. 单击 Finish 完成工程创建。

  2. 添加 SDK 编译依赖。

    1. 修改工程目录下的 app/build.gradle 文件,添加网易会议组件的依赖。

      Groovyandroid {
        // 添加 packagingOptions,否则可能会造成资源文件冲突。
        packagingOptions {
          pickFirst 'lib/arm64-v8a/libc++_shared.so'
          pickFirst 'lib/armeabi-v7a/libc++_shared.so'
        }
      }
      
      dependencies {
        //声明 SDK 依赖,具体版本可根据您的实际需要修改。
        implementation 'com.netease.yunxin.kit.meeting:meeting:4.7.0'
      }
      

      具体版本号可参考 更新日志

    2. 在顶部菜单依次选择 Build > Make Project 构建工程,触发依赖下载,完成后即可在代码中引入 SDK 中的类和方法。

修改能力 SDK 版本

网易会议组件中依赖了网易云信的 即时通讯 NIM SDK(简称 NIM SDK)音视频通话 2.0 SDK(简称 NERTC SDK) 的底层能力。您可以在网易会议组件的 更新日志 中,查看到对应组件版本适配的 NIM SDK 和 NERTC SDK 版本。

如果您的项目中已经单独集成了 NIM SDK 和 NERTC SDK,并与 NEMeetingKit 中的版本冲突时,您可以手工指定 NIM SDK 和 NERTC SDK 的版本号。由于缺乏集成测试,切换的版本还可能会导致未知问题,因此建议您切换到与适配过的 NIM SDK 和 NERTC SDK 版本兼容的版本,例如 Hotfix 版本。

为避免引入 SDK 的时候,自动引入高版本的 NIM SDK 和 NERTC SDK,您可以通过 Maven 仓库依赖添加目标的 NIM SDK 和 NERTC SDK 版本,并添加强制配置:

Groovydependencies {
    // 网易会议组件版本,具体版本号可参考前文描述里的更新日志
    implementation 'com.netease.yunxin.kit.meeting:meeting:4.7.0'
}
Groovy// 替换 NIM SDK 版本,具体版本号可参考前文描述里的更新日志
configurations.all {
    // 修改需要替换的 NIM SDK 版本号
    def overrideNimVersion = '9.15.0'
    resolutionStrategy.dependencySubstitution {
        all { DependencySubstitution dependency ->
            if (dependency.requested instanceof ModuleComponentSelector
                    && dependency.requested.group == 'com.netease.nimlib') {
                dependency.useTarget dependency.requested.group + ':' + dependency.requested.module + ':' + overrideNimVersion
            }
        }
    }
}
Groovy// 替换 NERTC SDK 版本,具体版本号可参考前文描述里的更新日志
configurations.all {
    // 修改需要替换的 NERTC SDK 版本号
    def overrideNertcVersion = '5.5.30'
    resolutionStrategy.dependencySubstitution {
        all { DependencySubstitution dependency ->
            if (dependency.requested instanceof ModuleComponentSelector
                    && dependency.requested.group == 'com.netease.yunxin'
                && dependency.requested.module.startsWith('nertc-')
                    ) {
                dependency.useTarget dependency.requested.group + ':' + dependency.requested.module + ':' + overrideNertcVersion
            }
        }
    }
}

下一步

调用网易会议组件接口 实现基础功能,例如调用初始化接口,并传入您在网易云信控制台上创建应用时获取的密钥(AppKey)。

此文档是否对你有帮助?
有帮助
去反馈
  • 前提条件
  • 开发环境
  • 集成 SDK
  • 修改能力 SDK 版本
  • 下一步