设备端 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 一致。
设备按铃时序
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();