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

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