跑通示例项目
更新时间: 2022/09/15 16:34:46
网易云信在 GitHub 上提供一个开源的网易会议组件示例项目 NEMeeting。本文介绍如何快速跑通该示例项目,体验在线会议功能。示例代码中包含了详细的 API 调用场景、参数封装以及回调处理。
该示例项目包含的功能如下:
- 通过账号、密码完成 NEMeeting 登录鉴权、注销登录。
- 创建会议、加入会议。
- 会议内提供的其他功能 (如会议控制、屏幕共享等)。
前提条件
在开始运行示例项目之前,请确保您已完成以下操作:
-
已创建应用,开通 NERoom 房间组件能力,并选择了线上会议场景模板。
-
在网易云信控制台的应用列表中获取指定应用的 App Key。
若您希望体验完整的登录及创建会议功能,请先通过网易会议服务端的创建会议账号接口创建一个有效的会议账号,获取 userUuid(对应 accountId)和 userToken(对应 accountToken)。
开发环境
在开始运行示例项目之前,请您准备以下开发环境:
环境类型 | 具体要求 |
---|---|
JDK 版本 | 1.8.0 及以上版本 |
Android API 版本 | Android SDK API 等级 21 及以上、Android 5.0 及以上版本 |
CPU 架构 | 支持 ARM64、ARMV7 架构 |
IDE | Android Studio |
其他 |
依赖 Androidx,不支持 support 库
|
操作步骤
-
配置示例项目。具体步骤如下。
- 克隆 NEMeeting 仓库至本地。
- 找到
NEMeeting/SampleCode/Android
示例项目文件夹,在app/src/main/res/values/appkey.xml
文件中填写您的会议组件 App Key。
<?xml version="1.0" encoding="utf-8"?> <resources> <!--TODO--> <!--Replace With Your AppKey Here--> <string name="appkey">Your AppKey</string> </resources>
您在申请并声明 App Key 后,运行示例项目时即可体验加入会议功能,但无法使用登录、创建会议功能。
-
集成网易会议 SDK。
在
app/build.gradle
文件中添加网易会议 SDK 的依赖。您可根据需要自行选择 SDK 版本号,详情可查看会议组件更新日志。
android { // 添加 packagingOptions,否则可能会造成资源文件冲突。 packagingOptions { pickFirst 'lib/arm64-v8a/libc++_shared.so' pickFirst 'lib/armeabi-v7a/libc++_shared.so' } } dependencies { //NEMeetingKit implementation 'com.netease.yunxin.kit.meeting:meeting:3.3.2' }
若您还需要使用会议账号完成 SDK 的登录鉴权,请在此示例项目中自行实现
com.netease.meetinglib.demo.data.DefaultDataRepository#getSDKAuthInfo
方法,通过用户账号和密码获取当前 App Key 下的真实会议账户 ID 和 Token,它们会被用来作为传参完成会议 SDK 中 login 接口的调用。package com.netease.meetinglib.demo.data; public interface DataRepository { /** * 通过用户账号密码获取SDK登录鉴权用的信息 * @param account 用户名 * @param pwd 密码 * @return */ Response<SDKAuthInfo> getSDKAuthInfo(String account, String pwd); }
-
编译并运行示例项目。
连接上 Android 设备后,用 Android Studio 打开
NEMeeting/SampleCode/Android
示例项目,然后编译并运行示例项目。请使用 Android 真机设备进行调试和运行,暂不支持模拟器设备。
效果图如下所示: