SuperAPI AI 工具集

cometchat-android-v6-calls

编程与开发

查看项目

更新于 10-21 20:33

技能介绍

本技能用于在 Android v6 的 CometChat 应用中接入语音与视频通话功能。

一、用途 当需要“添加语音/视频通话”“在聊天中显示通话按钮”“处理来电”“添加通话历史界面”“排查通话按钮不显示”“查看通话记录详情”时使用本技能。它假定已先完成 cometchat-android-v6-core 中的安装、凭据(assets/cometchat-settings.json)、initFromSettings → login → render 流程与尺寸处理,并配合 cometchat-android-v6-{kotlin,compose}-placement 确定来电界面在应用外壳中的位置。

二、主要能力

  1. Calls SDK 依赖:在 UI Kit 构件之外同时添加 Calls SDK,而非替代它。 dependencies { implementation("com.cometchat:chatuikit-compose-android:6.0.5") // 或 chatuikit-kotlin-android(XML Views) implementation("com.cometchat:calls-sdk-android:5.0.4") }
  2. 设置文件开关:在 app/src/main/assets/cometchat-settings.json 中设置 "uiKit": { "enableCalling": true },使 CometChatUIKit.initFromSettings(...) 初始化 Calls SDK。仪表盘中该应用也必须启用通话。
  3. 消息头部通话按钮:Views 下自动显示(依据 CallsUtils.isCallingEnabled());Compose 下默认隐藏,需显式传入 hideVoiceCallButton = false、hideVideoCallButton = false。不要用 auxiliaryView 放其他图标,否则会替换承载通话按钮的区域,应使用 trailingView。
  4. 全局来电监听:在 Application 子类中通过 CometChat.addCallListener 注册,处理 onIncomingCallReceived、onOutgoingCallAccepted、onOutgoingCallRejected、onIncomingCallCancelled,并在 manifest 中注册该 Application 类。
  5. 通话组件:CometChatCallButtons、CometChatIncomingCall、CometChatOutgoingCall、CometChatOngoingCall 与 CometChatOngoingCallActivity / CometChatCallActivity、CometChatCallLogs 与 CometChatCallLogsListItem,以及消息列表中的 CometChatCallActionBubble、CometChatMeetCallBubble、CometChatCallEvent。SDK 侧可自行搭建流程:CometChat.initiateCall / acceptCall / rejectCall / getActiveCall / clearActiveCall / addCallListener / removeCallListener。
  6. 权限:通话前运行时申请 CAMERA 与 RECORD_AUDIO(视频需两者,纯音频需 RECORD_AUDIO),并在 manifest 中声明;套件提供 CometChatPermissionHandler / CometChatPermissionActivity。

三、使用方式与顺序 依赖 + enableCalling → 消息头部出现通话按钮(Views 无需额外接线;Compose 需传 hideVoiceCallButton = false、hideVideoCallButton = false)→ initFromSettings 解析 → login 解析(在此之前通话不可用)。

四、适用场景 为已有 CometChat Android v6 聊天应用增加一对一语音/视频通话、来电弹窗、去电界面、通话中界面与通话历史记录。

五、限制与注意事项

  1. 当 android.enableJetifier=true 时,必须添加 Jetifier 忽略列表,否则构建在 checkDebugAarMetadata 阶段失败: android.jetifier.ignorelist=react-android,hermes-android,react-native-webrtc 构件与开关必须成对设置:只设开关缺构件会在启动时崩溃(NoClassDefFoundError: CometChatCalls$SessionSettingsBuilder);只加构件不设开关会在使用通话组件时崩溃(RuntimeException: Please call the CometChatCalls.init() method …)。
  2. 对已有会话的应用首次启用通话时,必须强制重新登录(先 logout 再 login),否则 CometChatUIKit.login() 会短路返回 onSuccess 而不调用 loginCometChatCalls,导致 Calls SDK 无令牌,通话记录静默报错“User auth token cannot be null”。
  3. 导入应为 com.cometchat.chat.core.Call,而非 com.cometchat.chat.models.Call。
  4. 不要手动在 manifest 中声明 CometChatCallActivity / CometChatOngoingCallActivity,它们会从 UI-Kit AAR 自动合并;v6 中不存在 com.cometchat.chatuikit.calling.* 类。
  5. 若活动通话界面出现 SoLoader / UnsatisfiedLinkError / NoClassDefFoundError(React/JSI/Hermes 符号),可在编译类路径添加 com.facebook.react:react-android:0.77.2 与 com.facebook.soloader:soloader:0.12.1,并在 Application.onCreate 中初始化 SoLoader;该步骤并非无条件必需,仅在遇到该原生链接错误时使用。
  6. 其他常见问题:Calls SDK 缺失导致按钮不出现;enableCalling 未设置;Compose 头部未显式显示按钮;用 auxiliaryView 放自定义图标;未注册全局监听导致来电不响;仅在单个 Activity 注册监听;忘记 manifest 中的 android:name;缺少运行时权限导致通话静默失败;登录解析前发起通话;通话界面未 fitsSystemWindows / 非全屏;监听器泄漏;将 v4/v5 通话构件与 v6 套件混用。

六、验证方式 使用固定版本套件编译(./gradlew :app:assembleDebug)。需两台设备/模拟器与两个用户验证:消息头部显示通话按钮;点击发起去电;另一台设备在任意界面弹出来电 UI;接听进入带音频/视频的通话中界面;拒绝/取消在双方干净关闭;通话出现在 CometChatCallLogs 与聊天中的通话气泡。无铃声说明监听未全局注册或应用未登录;权限被拒需处理并告知用户,不可静默失败。

更深入的通话功能(自定义通话中 UI、布局、录制、屏幕共享、音频模式等)需查阅 /calls/android/* 相关文档页面。