跑通示例项目
声网在 CallAPI
仓库中提供基于三方信令(环信)方案实现的 1v1 私密房和秀场转 1v1 的源代码供你参考。
本文介绍如何快速跑通该示例项目,体验直播效果。
前提条件
开始前,请确保满足如下前提条件:
-
参考开通服务在控制台创建项目,获取 App ID 和 App 证书,并开通三方信令服务的权限
-
Android Studio 4.1 及以上
-
Android 手机,版本 Android 5.0(API Level 21)及以上
注意声网推荐使用真机运行项目。部分模拟机可能存在功能缺失或者性能问题。
克隆仓库
运行以下命令克隆仓库到本地:
git clone git@github.com:AgoraIO-Community/CallAPI.git
配置示例项目
运行项目前,你需要在 /CallAPI/Android/gradle.properties
文件中设置如下参数:
AG_APP_ID=
AG_APP_CERTIFICATE=
IM_APP_KEY=
填入你在开通服务时获取的声网项目的 App ID、App 证书和环信项目的 App Key:
参数 | 描述 | 获取方式 |
---|---|---|
AG_APP_ID | 声网项目的 App ID | 获取 App ID |
AG_APP_CERTIFICATE | 声网项目的 App 证书 | 获取 App 证书 |
IM_APP_KEY | 环信项目的 App Key | 获取 App Key |
编译并运行示例项目
按照如下步骤进行操作:
声网自定义信令方案的 1v1 私密房和秀场转 1v1 示例项目基于 CallAPI 和三方信令服务共同开发。运行前请确保你的项目已开通三方信令服务权限。
-
开启 Android 设备的开发者选项,打开 USB 调试,通过 USB 连接线将 Android 设备接入电脑。
-
用 Android Studio 打开
/CallAPI/Android
文件夹。 -
在 Android Studio 中,点击 Sync Project with Gradle Files 按钮,以让项目与 Gradle 文件同步。
-
待同步成功后,点击
Run 'app'
。片刻后,CallAPI 应用便会安装到你的 Android 设备上。 -
打开应用,点击 1v1私密房或秀场转 1v1 私密房,即可进行体验。
注意你需要在两个客户端都打开应用,且都选择 1v1 私密房或秀场直播转 1v1 私密房才能进行互动体验。