快速跑通 Sample Code

更新时间: 2024/09/18 16:26:13

您可以通过跑通 Sample Code,体验网易云信音视频相关功能,包括音频通话、视频通话以及进阶功能。

开发环境

在开始运行示例项目之前,请确保开发环境满足以下要求:

环境要求 说明
Android Studio 版本 Android Studio 3.0 及以上版本 Android Studio 版本编号系统的变更请参考 Android Studio 版本说明
Android API 版本 Level 为 18 或以上版本。
Android SDK 版本 Android SDK 29、Android SDK Platform-Tools 29.x.x 或以上版本。
Gradle 及所需的依赖库 Gradle Services 页面下载特定版本的 Gradle 及所需的依赖库。 示例项目源码中使用的 Gradle 版本如下:
  • Gradle: 6.1.1
  • Android Gradle 插件:4.0.2
    关于 Android Gradle 插件、Gradle、SDK Tool 之间的版本依赖关系,请参见 Android Gradle 插件版本说明
  • IDE Android Studio
    Android 设备 Android 系统 4.3 及以上版本的真机。由于模拟器缺少摄像头及麦克风能力,因此工程需要在真机运行,请确保已正确连接 Android 设备。

    前提条件

    请确认您已完成以下操作:

    快速跑通 Sample Code

    示例项目需要在 RTC 调试模式下使用,此时无需传入 Token。修改鉴权方式的方法请参见 Token 鉴权 。调试模式建议只在集成开发阶段使用,请在应用正式上线前改回安全模式。

    1. 下载NERTC 示例项目源码 仓库至您本地工程。

    2. 使用 Android studio 打开示例项目源码仓库。

      在菜单栏中选择 File > Open,选择示例项目源码仓库(例如 G2-API-Examples-main\android)所在目录。

      OpenFile.png

      本地工程目录请使用英文路径,不要包含中文字符。

    3. Deploy/src/main/java/com/netease/nertc/config/DemoDeploy 文件中配置 AppKey。

      //替换为您自己的 App Key
      public static final String APP_KEY ="Your_AppKey";
      

      修改AppKey.png

      AppKey前后需要加英文双引号。

    4. 运行工程。

      1. 开启设备的开发者模式USB 调试功能。将 Android 设备连接到开发电脑,在弹出的授予调试权限对话框中,授予调试权限,具体步骤请参见在硬件设备上运行应用

        可以看到 Android Studio 上方的 Running Devices 选项框由下图:

        noDevices.png

        变为下图:

        addedDevice.png

        此时表示设备已成功连接到 Android Studio。

        请确保 Android 设备已开启开发者模式、USB 调试,并允许通过 USB 安装应用。

      2. 单击 Run 按钮,编译并运行示例源码。

        run.png

      首次编译示例源码时,如果没有对应的依赖库或者构建工具,Android Studio 会自动下载示例源码,可能需要较长时间,请耐心等待。

    5. 体验音视频通话。

      音视频通话需要获取麦克风等权限,请在 Android 设备上单击允许应用获取相应权限。

      跑通后的界面类似如下图所示,单击需要体验的功能。

      Demo界面.png

    常见问题

    1. 编译时提示 “NDK not configured”,或 “No toolchains found in the NDK toolchains folder for ABI with prefix: mips64el-linux-android”

    NDK版本不匹配.png

    可能原因:

    Android Studio NDK 版本不匹配。

    问题解决:

    1. 下载对应版本的 NDK,例如 21.xx。

      1. 在 Android Studio 的菜单栏中选择 Tools > SDK Manager,单击 SDK Tools 页签。
      2. 选中 NDK (Side by side) 下方待安装的 NDK 版本对应的复选框,例如 21.xx。

      安装NDK.png

    2. 在项目中配置特定版本的 NDK。

      1. 在 Android Studio 的菜单栏中选择 File > Project Structure,左侧导航栏选择 SDK Location
      2. Android NDK location 中选择已安装的对应版本的 NDK。

      配置NDK版本.png

    2. 手机连接电脑后,Android Studio 中没有出现对应的手机

    如果 Android 设备连接电脑后,Android Studio 的 Running Devices 中没有出现对应的手机,可能原因如下:

    • 您的数据线不支持连接存储。

    • 电脑没有安装对应的驱动。请参考下图,安装和您的 Android 设备匹配的驱动。

      Google_USB_driver.png

    • Android 设备没有开启开发者模式USB 调试,或者连接手机时,在弹出的授予调试权限对话框中,没有授予权限。

    此文档是否对你有帮助?
    有帮助
    去反馈
    • 开发环境
    • 前提条件
    • 快速跑通 Sample Code
    • 常见问题