App 端 SDK 接入
Android 最低 API 26,使用 Java 17。一个 App 选择一种信令接入方式。
查看 App SDK 下载 →App 主动呼叫流程
1. 导入依赖
解压 SDK ZIP,在 settings.gradle 中将包含 cn/ 的目录添加为 Maven 仓库,并保留 Google 和 Maven Central。将 <版本> 替换为下载的版本。
// HTTP + WebSocket
implementation 'cn.koodle:intercom-http-android:<版本>'
// MQTT
implementation 'cn.koodle:intercom-mqtt-android:<版本>'
2. 配置业务网关与客户端
业务网关对用户进行鉴权,并向平台签名代理通话请求和 WebSocket 握手。MQTT 接入还需租户 Broker 地址及 App 凭据,状态查询和信令补偿仍通过业务网关。AppKey 由业务服务器保管。
IntercomConfig gateway = new IntercomConfig(
businessUrl, tenantId, userId, () -> businessAuthHeaders(), false);
// HTTP + WebSocket
IntercomClient client = new IntercomClient(applicationContext, gateway, listener);
// 若选 MQTT,使用下面的初始化
IntercomMqttConfig mqtt = IntercomMqttConfig.forApp(gateway, brokerUrl, mqttUser, mqttPassword, false);
IntercomMqttClient mqttClient = new IntercomMqttClient(applicationContext, mqtt, listener);
businessAuthHeaders() 由宿主实现,每次请求提供当前业务登录凭据。
3. 加入与结束通话
- App 呼出时请求业务系统创建通话。接听设备来电时,先提交接听,由业务系统确定接听人。取得属于当前用户、可加入的
callId后继续。 - 申请麦克风及所需摄像头权限,在主线程初始化本地和远端渲染器。调用所选客户端的
joinCall(callId),已授权且需要上传本地视频时使用joinCall(callId, true)。 - 用
onCallChanged更新状态,用onError提示失败。点击挂断调用endCall(),离开会话页时解绑渲染器并断开连接,永久释放时调用close()。