SDKsHarmonyOS商业版
音视频通话概览
了解 HarmonyOS SDK 的通话信令、房间凭据和事件边界。
HarmonyOS SDK 提供发起、接受、拒绝、取消和挂断通话所需的信令 API,也可以查询群组当前房间、重新获取入会凭据,并恢复尚未处理的邀请。
SDK 只负责信令和房间信息,不负责摄像头采集、远端音视频播放或通话界面。应用需要把 roomID、token 和 liveURL 交给所选实时音视频引擎,并自行处理权限、媒体轨道、弱网策略和界面状态。
基本流程
- 发起方创建完整
SignalingInvitationInfo,调用单聊或群聊邀请接口。 - 被邀请方收到邀请事件,或在应用恢复时查询待处理邀请。
- 接受方取得房间凭据后连接媒体引擎;拒绝方关闭来电界面。
- 通话中按
roomID合并邀请、参与者和挂断事件,参与者再结合用户 ID。 - 发起方可以取消未接通邀请,参与者可以挂断已建立通话。
SignalingParticipantMetaData 包含参与者的 IMUser;OfflinePushInfo 用于被邀请方离线时的通知。房间 Token 具有时效性,进入媒体房间前应使用当前邀请或重新查询得到的有效值。
Promise 成功、信令事件到达和房间查询是三个不同阶段。信令成功不表示媒体房间已经连接,也不表示其他参与端已经更新界面。
这个页面有帮助吗?