浏览 SDKs · WASM
SDKsWASM

音视频通话概览

了解 WASM SDK 的音视频通话信令、房间信息和事件边界。

复制

WASM SDK 提供发起邀请、接受、拒绝、取消、挂断、查询房间和同步通话状态所需的信令 API。它负责协调通话参与者、房间信息和通话生命周期,不负责采集摄像头画面、播放远端媒体流或渲染通话界面。

应用需要把 SDK 返回的 roomIDtokenliveURL 交给所选的实时音视频媒体引擎,并自行处理设备权限、媒体轨道、弱网策略和界面状态。WASM SDK 的信令 API 并不是一套完整的 WebRTC 媒体 SDK。

通话流程

  1. 调用 signalingInvite()商业版 发起单聊通话,或调用 signalingInviteInGroup() 发起群聊通话。
  2. 被邀请方从 OnReceiveNewInvitation商业版 获取邀请,选择接受或拒绝。
  3. 接受方调用 signalingAccept(),双方使用返回的房间凭据接入媒体引擎。
  4. 通话过程中根据成员、媒体流和自定义信令事件更新本地状态。
  5. 发起方可以取消尚未接通的邀请;任一通话参与者都可以挂断已经建立的通话。

核心数据

数据说明
RtcInvite邀请人、被邀请人、群组、房间、媒体类型、超时时间和会话类型。
RtcInviteResultsOpenIMServer 返回的 roomIDtokenliveURL 和忙线用户列表。
CallingRoomData按群组查询到的房间、邀请及参与者信息。

customData 和自定义信令只适合传递业务可公开的协商信息。不要在其中写入长期凭据、管理员密钥或其他敏感数据。

状态更新与事件归属

发起、接受、拒绝、取消和挂断等写操作需要分别处理 API 的 Promise 结果与通话事件。Promise 成功表示 OpenIMServer 已接受或完成当前信令请求;事件反映邀请方、被邀请方、其他设备或房间参与者看到的增量状态,两者不是同一个完成信号。

邀请生命周期、成员进出房间、挂断和媒体流变化的完整监听统一见通话事件;自定义信令事件见发送自定义信令。查询房间、重新获取 Token 和恢复待处理邀请只通过 Promise 返回调用时的快照。

概览页不注册事件处理器。通话状态以 roomID 为主键;参与者状态还需要结合用户 ID。重新登录后的通话变化由通话事件同步;需要显示当前房间快照时,再查询房间信息。

按任务查找页面

任务页面
发起单聊或群聊通话发起单聊通话发起群聊通话
接受或拒绝邀请接受通话拒绝通话
取消邀请或挂断通话取消通话邀请挂断通话
恢复房间或待处理邀请查询群组通话房间获取通话房间 Token恢复待处理的通话邀请
处理通话事件和业务协商通话事件发送自定义信令