快速跑通 Sample Code
更新时间: 2023/04/27 14:02:50
您可以通过跑通 Sample Code,体验网易云信音视频通话功能,包括一对一音视频通话和多人音视频通话。
开发环境
在开始运行示例项目之前,请确保开发环境满足以下要求:
环境要求 | 说明 |
---|---|
Android Studio 版本 | Android Studio 3.0 及以上版本 |
Android API 版本 | Level 为 18 或以上版本。 |
Android SDK 版本 | Android SDK 29、Android SDK Platform-Tools 29.x.x 或以上版本。 |
Gradle 及所需的依赖库 | 在 Gradle Services 页面下载特定版本的 Gradle 及所需的依赖库。 在示例项目源码的 ./gradle/wrapper/gradle-wrapper.properties 文件中查看对应的版本号。示例项目源码中使用的 Gradle 版本如下:
|
Android Gradle 插件 | 在示例项目源码的 ./build.gradle 文件中查看对应的版本号。示例项目源码中使用的 Gradle 插件版本如下:关于 Android Gradle 插件、Gradle、SDK Tool 之间的版本依赖关系,请参见 Android Gradle 插件版本说明。 |
IDE | Android Studio |
Android 设备 | Android 系统 4.3 及以上版本的真机。 |
前提条件
请确认您已完成以下操作:
快速跑通 Sample Code
示例项目需要在 RTC 调试模式下使用,此时无需传入 Token。修改鉴权方式的方法请参见 Token 鉴权 。调试模式建议只在集成开发阶段使用,请在应用正式上线前改回安全模式。
-
下载1 对 1 通话示例项目源码或多人通话示例项目源码 仓库至您本地工程。
-
使用 Android studio 打开示例项目源码仓库,下文以多人通话示例项目为例。
在菜单栏中选择 File > Open,选择示例项目源码仓库(例如
NERtcSample-GroupVideoCall-Android-Java
)所在目录。本地工程目录请使用英文路径,不要包含中文字符。
-
在
app/src/main/res/values/app_key.xml
文件中配置 AppKey。//替换为您自己的 App Key <string name="app_key">YOUR APP KEY</string>
-
运行工程。
-
开启设备的开发者模式和USB 调试功能。将 Android 设备连接到开发电脑,在弹出的授予调试权限对话框中,授予调试权限,具体步骤请参见在硬件设备上运行应用。
可以看到 Android Studio 上方的 Running Devices 选项框由下图:
变为下图:
此时表示设备已成功连接到 Android Studio。
-
单击 Run 按钮,编译并运行示例源码。
首次编译示例源码时,如果没有对应的依赖库或者构建工具,Android Studio 会自动下载示例源码,可能需要较长时间,请耐心等待。
-
-
体验音视频通话。
在 Android 设备上单击允许应用获取相应权限。在弹出的界面中,输入自定义的房间 ID,单击加入房间,即可开始音视频通话。
常见问题
1. 编译时提示 “NDK not configured”,或 “No toolchains found in the NDK toolchains folder for ABI with prefix: mips64el-linux-android”
可能原因:
Android Studio NDK 版本不匹配。
问题解决:
-
下载对应版本的 NDK,例如 21.xx。
- 在 Android Studio 的菜单栏中选择 Tools > SDK Manager,单击 SDK Tools 页签。
- 选中 NDK (Side by side) 下方待安装的 NDK 版本对应的复选框,例如 21.xx。
-
在项目中配置特定版本的 NDK。
- 在 Android Studio 的菜单栏中选择 File > Project Structure,左侧导航栏选择 SDK Location 。
- 在 Android NDK location 中选择已安装的对应版本的 NDK。
2. 手机连接电脑后,Android Studio 中没有出现对应的手机
如果 Android 设备连接电脑后,Android Studio 的 Running Devices 中没有出现对应的手机,可能原因如下:
-
您的数据线不支持连接存储。
-
电脑没有安装对应的驱动。请参考下图,安装和您的 Android 设备匹配的驱动。
-
Android 设备没有开启开发者模式和USB 调试,或者连接手机时,在弹出的授予调试权限对话框中,没有授予权限。