音视频通话开发实战：手把手教你实现呼叫与接听全流程

本文教大家基于环信 CallKit 如何快速实现音视频实时通话能力。

环信 CallKit 组件是环信 IM 和声网 RTC 深度融合开发的实时音视频通话框架，实现了一对一及群组音视频通话能力。只需简单集成，即可快速获得稳定流畅的高品质音视频通话能力。环信音视频通话 CallKit 可用于在线互动课堂、视频客服中心、远程会诊系统或视频相亲等场景。源码开源，开箱即用，目前支持Android、iOS、Web端快速集成。

本文以Android端集成为例：

推荐开发环境

Android SDK: API Level 24 及以上

• Android Studio: 推荐最新版本
• Kotlin: 2.0.21
• JDK: 17
• Gradle 版本: 8.13

前提条件

1.已经注册环信管理后台账号
2.已集成环信即时通讯 IM SDK
- 创建应用，获取应用的 App Key，格式为 orgname#appname。
- 创建用户，获取用户 ID 和 IM token。
- 创建群组，获取群组 ID。将用户加入群组。
- 开通音视频服务。

集成步骤

步骤一 添加依赖
在 app(module) 目录的 build.gradle.kts 文件中添加以下依赖：
(注：需要使用4.16.0及以上版本)

dependencies {
...
implementation("io.hyphenate:chat-call-kit:4.16.0")
}

步骤二 初始化 CallKit

在应用启动时（建议在Application里）初始化 CallKit：
注：CallKit是使用IM做信令的，需要先初始化IM SDK

//初始化环信IM SDK
val options =ChatOptions().apply{
this.appKey = appkey
            autoLogin =false
}
        ChatClient.getInstance().init(this, options)
//开启debug模式
        ChatClient.getInstance().setDebugMode(true)

// 初始化CallKit
val config =CallKitConfig()
        CallKitClient.init(this, config)

步骤三 配置监听器
CallKit提供 CallKitListener监听通话过程，可以在初始化时设置监听器处理通话相关的回调：

//CallKit监听器
privateval callKitListener =object: CallKitListener {

// 通话结束
overridefunonEndCallWithReason(reason: CallEndReason, callInfo: CallInfo?){
            runOnUiThread {
when(reason){
                    CallEndReason.CallEndReasonHangup ->{
showToast("通话已挂断")
}
                    CallEndReason.CallEndReasonCancel ->{
showToast("通话已取消")
}
                    CallEndReason.CallEndReasonRemoteRefuse ->{
showToast("对方拒绝通话")
}
                    CallEndReason.CallEndReasonRemoteNoResponse ->{
showToast("对方无响应")
}
// ... 其他结束原因
}
}
}

// 通话错误
overridefunonCallError(
            errorType: CallKitClient.CallErrorType,
            errorCode: Int,
            description: String?
){
            runOnUiThread {
showToast("通话错误: $description")
}

步骤四 登录IM

调用接口，登录环信IM（注：登录的环信id需提前注册）

ChatClient.getInstance().loginWithToken(username, token,object: ChatCallback {
overridefunonSuccess(){
            runOnUiThread {
showToast("登录成功")
}
}

overridefunonError(code: Int, error: String?){
            runOnUiThread {
showToast("登录失败: $error")
}
}
})

步骤五 发起通话

• 发起一对一语音通话

CallKitClient.startSingleCall(
            CallType.SINGLE_VOICE_CALL,
            环信id,
         ext  //可传null
)

• 发起一对一视频通话

CallKitClient.startSingleCall(
        CallType.SINGLE_VIDEO_CALL,
        环信id,
        ext  // 可传 null
)

步骤六 接听电话

当接收到通话邀请时，CallKit 会自动触发 onReceivedCall 回调：
（注：被叫用户可选择接听、拒绝或挂断通话）

• 弹出通话邀请界面
• 播放来电铃声
• 显示通话邀请通知（当 App 在后台时）

恭喜你完成了环信 CallKit 的快速集成！

参考文档：

• 注册环信即时通讯IM

• 环信IM集成文档