集成流程
按顺序完成租户开通、业务服务接入、设备激活和上线、App 接入和双向联调。开始前可先查看 平台架构与通信链路。
-
平台开通租户
登录管理后台,打开「租户管理 → 创建租户」。在「基础信息」填写业务系统名称和 HTTPS 回调地址,再到「MQTT 接入」配置 Broker 和平台服务账号,按需填写「TLS 证书」。
查找租户与创建入口
租户管理页面。点击截图可在当前页面放大。 - 业务系统名称
- 按业务系统名称筛选租户。
- AppId
- 按平台分配的应用标识查找租户。
- 租户状态
- 按启用或停用状态筛选。
新建业务系统时点击「创建租户」。
创建租户 · 基础信息。点击截图可在当前页面放大。 - 业务系统名称
- 必填。用于在后台和筛选列表中辨认租户。
- 租户状态
- 启用后允许接入;停用会中止该租户的相关服务。
- AppId
- 保存后生成,用于业务系统发起签名请求时识别应用。
- 租户 ID
- 保存后生成,用于标识平台内的租户。
- 业务事件接收地址
- 业务系统接收来电和通话状态的 HTTPS 地址。业务系统负责验签和签名应答。
MQTT 接入字段
创建租户 · MQTT 接入。点击截图可在当前页面放大。 - Broker 地址
- 平台连接租户 Broker 的地址。使用 tcp:// 或 ssl://,填写对应端口。
- 平台服务用户名
- Broker 分配给平台服务的账号,用于认证和 Topic 授权。
- 平台服务密码
- 该账号的密码。编辑已有租户时留空会保留原密码。
- 平台 MQTT Client ID
- 同一 Broker 上要唯一,留空时平台按 AppId 生成。
平台账号与 App、设备各自使用的 MQTT 账号分开配置。
TLS 证书字段
创建租户 · TLS 证书。点击截图可在当前页面放大。 - Broker CA 证书 PEM
- 可选。私有 CA 场景填写用来验证 Broker 的 CA 证书,留空使用系统信任库。
- 客户端 PKCS12 文件路径
- 双向 TLS 时填写平台服务器上的 .p12 文件路径,文件需先部署到该服务器。
- PKCS12 密码
- 解锁客户端证书文件。编辑已有配置时留空会保留原密码。
证书配置用于 ssl:// 连接。
保存后,在业务服务器保管平台分配的
查看租户与后台 SDK 配置 →tenantId、appId和appKey。 -
业务服务接入
接入签名请求、响应验签及平台回调。新增设备时调用
查看设备绑定与后台接口 →bindDevice(uuid);接入 App 主叫创建、设备来电通知以及唯一接听人指定。 -
设备激活和上线
设备使用已绑定的 UUID 和自身 Broker 凭据,订阅下行 Topic,依次完成
connect和intercomResume的业务应答。查看设备归属
后台设备绑定列表。点击截图可在当前页面放大。 - 租户
- 只查看指定业务系统绑定的设备。
- 设备 UUID
- 按设备上报时使用的唯一标识定位绑定记录。
此列表用于核对绑定归属。添加和解绑由业务服务调用平台接口。
设备需先完成 License 激活。管理员在「设备授权」生成购买凭证,设备使用本机 SN 联网激活,并将授权实例接入 MQTT SDK。设备 UUID 须与授权 SN 一致。
查看设备激活、后台表单和续费步骤 → 查看设备接入与上线对账 → -
App 接入
选择 HTTP + WebSocket 或 MQTT SDK,配置业务网关,申请媒体权限并绑定渲染器。请求创建呼叫或提交接听后,将业务系统返回的
查看 App SDK 接入 →callId交给joinCall(callId)。 -
双向联调
- App 呼叫设备 业务系统授权并创建通话,平台下发
startIntercom。设备接受后由 App 发 Offer、设备回 Answer。 - 设备呼叫 App 设备按铃,平台回调来电。业务系统通知用户并指定唯一接听人,平台下发
accept,设备发 Offer、App 回 Answer。 - 验收结果 确认双方上报连通、业务服务收到
CONNECTED,并验证画面、双向音频、挂断通知和资源释放。使用真机覆盖直连与 TURN 中继,通过通话 ID 核对后台记录。 - 异常场景 复测设备离线、重复回调、多人同时接听、解绑后新呼叫被拒绝及租户 Broker 断开时的隔离效果。
查询通话列表
后台通话列表。点击截图可在当前页面放大。 - 业务系统
- 按租户缩小通话查询范围。
- 通话 ID
- 精确定位本次呼叫,通常取业务服务收到的 callId。
- 设备 ID
- 按设备 UUID 查看与该设备相关的通话。
- 通话状态
- 筛选响铃、通话中、已结束、失败或超时等记录。
在查询结果中查看时长、媒体路径和结束原因,可用「查看日志」追踪同一通话。
查看通话日志
后台通话日志。点击截图可在当前页面放大。 - 业务系统
- 筛选指定租户的日志。
- 通话 ID
- 把同一轮呼叫的信令和状态变化关联起来。
- 事件类型
- 按创建通话、收到报文、发送失败等类型缩小排查范围。
列表有报文时点击「查看」,可核对通信方式、Topic 或 URL 和报文正文。
检查业务回调投递
后台业务通知列表。点击截图可在当前页面放大。 - 业务系统
- 按租户查询平台发给该业务系统的通知。
- 通话 ID
- 查看指定通话的来电及状态回调。
- 投递状态
- 筛选等待投递、已确认或重试已耗尽的通知。
在列表中查看投递次数、最近错误或正文。状态为已耗尽时可按需重投。
查看联调故障与错误码 →核对 TURN / STUN 配置
后台系统配置 · TURN / STUN。点击截图可在当前页面放大。 - STUN 地址
- 用于地址发现和建立直连候选。
- TURN 地址
- 客户端需要中继时使用的服务器地址和传输参数。
- 认证模式
- 显示当前使用静态账号还是共享密钥生成动态凭据。
- 静态用户名 / 静态密码
- 静态认证使用的账号信息,页面只显示密码配置状态。
- 共享密钥 / 动态凭据有效期
- 动态凭据使用的配置状态,以及凭据允许使用的时长。
这是当前平台进程的配置视图。媒体是否实际经过中继,可在通话列表查看媒体路径。
- App 呼叫设备 业务系统授权并创建通话,平台下发