快速跑通示例项目

前提条件

• 安装 Android 5.0+ 及以上版本操作系统的 Android 模拟器或真实设备。
• Android Studio (推荐最新版本)。
• Android SDK (版本取决于目标平台)。
• Java Development Kit (JDK)，版本选择参考 Android 官方文档。
• 有效的声网开发者账号。
• 如果你的网络环境部署了防火墙，请根据应用企业防火墙限制打开相关端口。

操作步骤

1. 创建声网项目

按照以下步骤，在控制台创建一个声网项目。

1. 登录声网控制台，点击左侧导航栏 项目管理按钮进入项目管理页面。

2. 在项目管理页面，点击创建按钮。

   

3. 在弹出的对话框内输入项目名称，选择鉴权机制为 APP ID。

   声网推荐只在测试环境，或对安全要求不高的场景里使用 App ID 鉴权。

4. 点击提交，新建的项目就会显示在项目管理页中。

2. 获取 App ID

声网会给每个项目自动分配一个 App ID 作为项目唯一标识。

在声网控制台的项目管理页面，找到你的项目，点击 App ID 右侧的眼睛图标就可以直接复制项目的 App ID。

3. 集成声网 SDK

按照以下步骤将声网 SDK 集成到示例项目中。

1. 下载 RTM 仓库，找到 Agora-RTM-Tutorial-Android 示例项目文件夹。
2. 下载最新版云信令 Android Java SDK 并解压。
3. 将 SDK 包中 libs 目录下的 .jar 文件复制到 Agora-RTM-Tutorial-Android/app/libs 目录下。将 x86_64, x86, arm64-v8a, armeabi-v7a 文件夹复制到 Agora-RTM-Tutorial-Android/app/src/main/jniLibs 目录下。

4. 运行示例项目

按照以下步骤运行示例项目。

1. 使用 Android Studio 打开项目 app。Gradle 会自动进行同步。

2. 同步完成后，在 res > values > strings_config.xml 中输入 App ID。

   <?xml version="1.0" encoding="utf-8"?>
   <resources>
    <string translatable="false" name="agora_app_id">你的 App ID</string>
   </resources>

3. 编译并运行示例项目。填入任意字符串作为用户 ID（例如 userA），点击 Login 即可登录 RTM 系统。

   你需要自行设置用户 ID，支持的字符集为：

   • 26 个小写英文字母 a-z
   • 26 个大写英文字母 A-Z
   • 10 个数字 0-9
   • 空格
   • "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ","

运行效果