SDKsWASM
音视频通话概览
了解 WASM SDK 的音视频通话信令、房间信息和事件边界。
WASM SDK 提供发起邀请、接受、拒绝、取消、挂断、查询房间和同步通话状态所需的信令 API。它负责协调通话参与者、房间信息和通话生命周期,不负责采集摄像头画面、播放远端媒体流或渲染通话界面。
应用需要把 SDK 返回的 roomID、token 和 liveURL 交给所选的实时音视频媒体引擎,并自行处理设备权限、媒体轨道、弱网策略和界面状态。WASM SDK 的信令 API 并不是一套完整的 WebRTC 媒体 SDK。
通话流程
- 调用
signalingInvite()商业版 发起单聊通话,或调用signalingInviteInGroup()发起群聊通话。 - 被邀请方从
OnReceiveNewInvitation商业版 获取邀请,选择接受或拒绝。 - 接受方调用
signalingAccept(),双方使用返回的房间凭据接入媒体引擎。 - 通话过程中根据成员、媒体流和自定义信令事件更新本地状态。
- 发起方可以取消尚未接通的邀请;任一通话参与者都可以挂断已经建立的通话。
核心数据
| 数据 | 说明 |
|---|---|
RtcInvite | 邀请人、被邀请人、群组、房间、媒体类型、超时时间和会话类型。 |
RtcInviteResults | OpenIMServer 返回的 roomID、token、liveURL 和忙线用户列表。 |
CallingRoomData | 按群组查询到的房间、邀请及参与者信息。 |
customData 和自定义信令只适合传递业务可公开的协商信息。不要在其中写入长期凭据、管理员密钥或其他敏感数据。
状态更新与事件归属
发起、接受、拒绝、取消和挂断等写操作需要分别处理 API 的 Promise 结果与通话事件。Promise 成功表示 OpenIMServer 已接受或完成当前信令请求;事件反映邀请方、被邀请方、其他设备或房间参与者看到的增量状态,两者不是同一个完成信号。
邀请生命周期、成员进出房间、挂断和媒体流变化的完整监听统一见通话事件;自定义信令事件见发送自定义信令。查询房间、重新获取 Token 和恢复待处理邀请只通过 Promise 返回调用时的快照。
概览页不注册事件处理器。通话状态以 roomID 为主键;参与者状态还需要结合用户 ID。重新登录后的通话变化由通话事件同步;需要显示当前房间快照时,再查询房间信息。
按任务查找页面
这个页面有帮助吗?