集成流程

按顺序完成租户开通、业务服务接入、设备激活和上线、App 接入和双向联调。开始前可先查看 平台架构与通信链路。

  1. 平台开通租户

    登录管理后台,打开「租户管理 → 创建租户」。在「基础信息」填写业务系统名称和 HTTPS 回调地址,再到「MQTT 接入」配置 Broker 和平台服务账号,按需填写「TLS 证书」。

    登录管理后台
    后台登录页面
    后台登录页面。点击截图可在当前页面放大。
    账号
    填写平台管理员账号。
    密码
    填写管理员密码。登录后进入管理后台。
    查找租户与创建入口
    租户管理页面
    租户管理页面。点击截图可在当前页面放大。
    业务系统名称
    按业务系统名称筛选租户。
    AppId
    按平台分配的应用标识查找租户。
    租户状态
    按启用或停用状态筛选。

    新建业务系统时点击「创建租户」。

    创建租户 · 基础信息
    创建租户 · 基础信息。点击截图可在当前页面放大。
    业务系统名称
    必填。用于在后台和筛选列表中辨认租户。
    租户状态
    启用后允许接入;停用会中止该租户的相关服务。
    AppId
    保存后生成,用于业务系统发起签名请求时识别应用。
    租户 ID
    保存后生成,用于标识平台内的租户。
    业务事件接收地址
    业务系统接收来电和通话状态的 HTTPS 地址。业务系统负责验签和签名应答。
    MQTT 接入字段
    创建租户 · MQTT 接入
    创建租户 · MQTT 接入。点击截图可在当前页面放大。
    Broker 地址
    平台连接租户 Broker 的地址。使用 tcp:// 或 ssl://,填写对应端口。
    平台服务用户名
    Broker 分配给平台服务的账号,用于认证和 Topic 授权。
    平台服务密码
    该账号的密码。编辑已有租户时留空会保留原密码。
    平台 MQTT Client ID
    同一 Broker 上要唯一,留空时平台按 AppId 生成。

    平台账号与 App、设备各自使用的 MQTT 账号分开配置。

    TLS 证书字段
    创建租户 · TLS 证书
    创建租户 · TLS 证书。点击截图可在当前页面放大。
    Broker CA 证书 PEM
    可选。私有 CA 场景填写用来验证 Broker 的 CA 证书,留空使用系统信任库。
    客户端 PKCS12 文件路径
    双向 TLS 时填写平台服务器上的 .p12 文件路径,文件需先部署到该服务器。
    PKCS12 密码
    解锁客户端证书文件。编辑已有配置时留空会保留原密码。

    证书配置用于 ssl:// 连接。

    保存后,在业务服务器保管平台分配的 tenantId、appId 和 appKey。

    查看租户与后台 SDK 配置 →
  2. 业务服务接入

    接入签名请求、响应验签及平台回调。新增设备时调用 bindDevice(uuid);接入 App 主叫创建、设备来电通知以及唯一接听人指定。

    查看设备绑定与后台接口 →
  3. 设备激活和上线

    设备使用已绑定的 UUID 和自身 Broker 凭据,订阅下行 Topic,依次完成 connect 和 intercomResume 的业务应答。

    查看设备归属
    后台设备绑定列表
    后台设备绑定列表。点击截图可在当前页面放大。
    租户
    只查看指定业务系统绑定的设备。
    设备 UUID
    按设备上报时使用的唯一标识定位绑定记录。

    此列表用于核对绑定归属。添加和解绑由业务服务调用平台接口。

    设备需先完成 License 激活。管理员在「设备授权」生成购买凭证,设备使用本机 SN 联网激活,并将授权实例接入 MQTT SDK。设备 UUID 须与授权 SN 一致。

    查看设备激活、后台表单和续费步骤 → 查看设备接入与上线对账 →
  4. App 接入

    选择 HTTP + WebSocket 或 MQTT SDK,配置业务网关,申请媒体权限并绑定渲染器。请求创建呼叫或提交接听后,将业务系统返回的 callId 交给 joinCall(callId)。

    查看 App SDK 接入 →
  5. 双向联调

    • 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
    后台系统配置 · TURN / STUN。点击截图可在当前页面放大。
    STUN 地址
    用于地址发现和建立直连候选。
    TURN 地址
    客户端需要中继时使用的服务器地址和传输参数。
    认证模式
    显示当前使用静态账号还是共享密钥生成动态凭据。
    静态用户名 / 静态密码
    静态认证使用的账号信息,页面只显示密码配置状态。
    共享密钥 / 动态凭据有效期
    动态凭据使用的配置状态,以及凭据允许使用的时长。

    这是当前平台进程的配置视图。媒体是否实际经过中继,可在通话列表查看媒体路径。

    查看联调故障与错误码 →