入门指引
大约 3 分钟
Andorid 集成文档
入门指引
环信音视频通话 CallKit 是基于环信即时通讯 IM 和声网实时音视频 RTC 深度整合开发的实时音视频通话框架,实现了一对一及群组音视频通话功能。本文提供从零开始接入音视频通话 CallKit 的完整指南。
集成流程

集成步骤
| 步骤 | 描述 |
|---|---|
| 注册账号 | 使用环信产品前,你首先需要在 环信控制台注册账号。 环信账号是开发者在环信控制台的唯一身份标识,开发者利用账号登录控制台,对应用进行配置和管理。开发者在将自身应用与环信即时通讯 IM 对接时,需注册 IM 账号与自身应用中的账号映射。 |
| 创建应用 实现获取 App Key | 1. 要接入即时通讯 IM 服务,你必须首先在环信控制台 创建应用。 2. 环信会给创建的应用分配 App Key,作为应用的唯一标识。你需要 获取应用的 App Key,集成 SDK 时传入 App Key。 |
| 开通 IM 套餐 开通 RTC 和 订阅套餐 | 1. 即时通讯 IM 支持免费版、专业版和旗舰版,请参考 购买指引 根据需要订阅套餐包。除了套餐包,你还可以 开通和订阅 IM 的增值服务,例如,内容审核、消息翻译和即时推送。 2. 实时音视频服务 RTC 是即时通讯 IM 的增值服务。若要使用该服务,你需要首先 开通,订阅套餐包。 |
| 创建用户 获取 Token | - 创建用户:你可以 调用 REST API 创建用户,也可以在 环信控制台 创建用户。详见 用户注册文档。 - 获取 Token:在你的应用服务器集成 获取 App Token API 和 获取用户 Token API 实现获取 Token 的业务逻辑,你的应用可以调用自身服务端,从环信服务器获取 Token。 |
| 集成 CallKit | 将 CallKit 集成到你的应用,主要包括以下步骤: 1. 添加依赖 2. 初始化 CallKit 3. 配置监听器 4. 登录 IM 5. 发起通话 6. 接通通话 7. 离线推送 |
| 申请权限 | - 声明权限:你需在 Manifest.xml 文件中声明 CallKit 所需权限,例如悬浮窗权限和锁屏显示需要的权限。- 动态权限:录音和摄像头等权限需要动态申请。 |
| 使用 Telecom | Android 系统中的 Telecom 框架负责管理设备上的所有通话,包括传统的基于 SIM 卡的通话和 VoIP 通话。当有来电时,Telecom 框架会处理来电显示、接听、挂断等功能,并通知相关的应用程序。 |
| 展示/隐藏来电通知栏和悬浮窗 | 要展示来电通知栏和悬浮窗,需要用户授予悬浮窗权限。你可以调用 API 展示或隐藏来电通知栏和悬浮窗。 |
| 自定义资源 | 你可以修改铃声配置、通话超时设置、图标与图形资源(如挂断按钮和接听按钮)以及文案资源(如呼叫中和待接听)。 |
