App 端 SDK 接入

Android 最低 API 26,使用 Java 17。一个 App 选择一种信令接入方式。

查看 App SDK 下载 →

App 主动呼叫流程

App 请求业务系统创建通话,取得 callId 后加入,设备接受后由 App 发送 Offer、设备回复 Answer。
App 接听设备来电时,业务系统先指定接听人,再把通话 ID 交给 App。此时 Offer 由设备发起。

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. 加入与结束通话

  1. App 呼出时请求业务系统创建通话。接听设备来电时,先提交接听,由业务系统确定接听人。取得属于当前用户、可加入的 callId 后继续。
  2. 申请麦克风及所需摄像头权限,在主线程初始化本地和远端渲染器。调用所选客户端的 joinCall(callId),已授权且需要上传本地视频时使用 joinCall(callId, true)。
  3. 用 onCallChanged 更新状态,用 onError 提示失败。点击挂断调用 endCall(),离开会话页时解绑渲染器并断开连接,永久释放时调用 close()。