本文档基于 MainActivity 示例,帮助你快速集成和运行环信 CallKit,实现一对一音视频通话和群组音视频通话功能。
- Android SDK: API Level 24 及以上
- Android Studio: 推荐最新版本
- Kotlin: 2.0.21
- JDK: 17
- Gradle:gradle-8.9-bin.zip
在 环信控制台 进行如下操作:
- 注册环信账号。
- 创建应用,获取应用的 App Key,格式为
orgname#appname
。 - 创建用户,获取用户 ID 和 IM token。
- 创建群组,获取群组 ID。将用户加入群组。
- 开通音视频服务。
- 在 Github 中克隆或下载代码。
git clone https://github.com/easemob/easemob-callkit-android
- 在 Android Studio 中打开项目。
选择 File > New > Import Project,导入下载或克隆的项目 easemob-callkit-android
。
-
等待 Gradle 同步完成。
-
在
MainActivity.kt
中进行如下修改:
private val selfUserID = "your_user_id" // 你的用户 ID
private val remoteUserID = "target_user_id" // 对方用户 ID,用于一对一音视频通话
private val imToken="your_im_token" // 替换为你的用户对应的 IM 登录Token
private val groupID = "your_group_id" // 群组 ID
private val imAppkey = "your_org#your_app" // 你的 App Key
- 连接 Android 设备或启动模拟器。
- 点击 Run ‘app’ 运行应用。
- 点击 登录。等待连接,观察连接状态指示器变绿。
- 发起通话:
- 一对一视频通话:点击 发起一对一视频通话。
- 一对一音频通话:点击 发起一对一音频通话。
- 群组通话:点击 发起群组音视频通话。
- 在弹出的页面中授权必要权限(摄像头、麦克风、悬浮窗等)。
- 点击 登出 退出登录。