浏览 SDKs · HarmonyOS
平台
SDKsHarmonyOS商业版

音视频通话概览

了解 HarmonyOS SDK 的通话信令、房间凭据和事件边界。

复制

HarmonyOS SDK 提供发起、接受、拒绝、取消和挂断通话所需的信令 API,也可以查询群组当前房间、重新获取入会凭据,并恢复尚未处理的邀请。

SDK 只负责信令和房间信息,不负责摄像头采集、远端音视频播放或通话界面。应用需要把 roomIDtokenliveURL 交给所选实时音视频引擎,并自行处理权限、媒体轨道、弱网策略和界面状态。

基本流程

  1. 发起方创建完整 SignalingInvitationInfo,调用单聊或群聊邀请接口。
  2. 被邀请方收到邀请事件,或在应用恢复时查询待处理邀请。
  3. 接受方取得房间凭据后连接媒体引擎;拒绝方关闭来电界面。
  4. 通话中按 roomID 合并邀请、参与者和挂断事件,参与者再结合用户 ID。
  5. 发起方可以取消未接通邀请,参与者可以挂断已建立通话。

SignalingParticipantMetaData 包含参与者的 IMUserOfflinePushInfo 用于被邀请方离线时的通知。房间 Token 具有时效性,进入媒体房间前应使用当前邀请或重新查询得到的有效值。

Promise 成功、信令事件到达和房间查询是三个不同阶段。信令成功不表示媒体房间已经连接,也不表示其他参与端已经更新界面。