设备端 Android SDK 接入

Android 设备使用 MQTT SDK,连接本租户 Broker。完成设备授权、绑定租户后,再验证收发呼叫。

查看设备 SDK 下载 →

接入前先完成设备激活

在管理后台「设备授权」下载公钥,生成适用产品型号的激活码或二维码。设备联网领取 License,状态为 ACTIVE 后才能进行对讲。完整步骤、后台表单说明和续费流程见 设备激活与续费。

DeviceLicenseClient license = new DeviceLicenseClient(applicationContext, "https://license.example.com", productCode, publicKeyPem, false);
LicenseVerifier.Status status = license.getLicenseStatus();
if (status == LicenseVerifier.Status.CLOCK_UNTRUSTED) {
    license.refreshAsync(licenseCallback);
} else if (status != LicenseVerifier.Status.ACTIVE) {
    showActivationPage();
}

showActivationPage() 和 licenseCallback 由宿主实现。用户输入激活码后调用 activateAsync,扫码后调用 activateQrAsync。授权回调中检查 getLicenseStatus() 并更新界面。使用同一授权实例初始化设备客户端,设备 UUID 须与该实例读取的本机 SN 一致。

设备按铃时序

设备按铃后平台回调来电,业务系统确定接听用户,平台向设备下发接听,设备发送 Offer,App 回复 Answer。
设备也可以接收 App 发起的通话。设备接受平台下发的 startIntercom 后,等待 App 发 Offer。

1. 导入 SDK 并准备设备信息

解压 Maven 仓库 ZIP,添加仓库路径后引入 cn.koodle:intercom-mqtt-android:<版本>。准备设备的全局唯一 UUID、租户 Broker 地址及设备账号。业务系统先把该 UUID 绑定到同一租户。

2. 连接并等待上线对账

Broker 按 device_{uuid} 对 MQTT 客户端及 Topic 授权。SDK 完成订阅后发送 connect,收到业务应答后执行 intercomResume。收到「MQTT 已就绪」回调后再开放按铃。

if (license.getLicenseStatus() != LicenseVerifier.Status.ACTIVE) {
    showLicenseStatus(license.getLicenseStatus());
    return;
}
IntercomMqttConfig config = IntercomMqttConfig.forDevice(deviceUuid, brokerUrl, mqttUsername, mqttPassword, false).withDeviceLicense(license);
IntercomMqttClient device = new IntercomMqttClient(applicationContext, config, listener);
device.connect();

3. 联调呼入和呼出

  • 设备按铃时,获得所需媒体权限后调用 startDeviceCall("videoAudio", true)。业务系统收到来电回调并指定接听人后,设备等待平台下发接听指令,再协商媒体。
  • App 呼出时,设备在线等待平台的 startIntercom。设备 SDK 负责处理指令及回复业务结果。检查设备摄像头、麦克风和视频渲染。
  • 设备显示离线时,按 UUID 检查租户绑定、Broker ACL、订阅以及两次上线业务应答。

4. 释放资源

每个设备进程使用一个授权实例。宿主退出时先关闭通话客户端,再关闭授权实例。

device.close();
license.close();