SDKsReact Native
音视频通话概览
OpenIM React Native SDK 音视频通话概览。
OpenIM React Native SDK 提供音视频通话的信令 API,用于发起和处理通话邀请、查询房间信息及同步通话状态。它只处理通话业务信令,不负责音视频采集与播放、媒体房间连接或通话界面渲染。
发起或接受通话后,SDK 返回 roomID、token 和 liveURL 等房间凭据。应用需要将这些凭据交给实时音视频媒体引擎加入通话房间,并自行处理设备权限、媒体轨道、弱网策略和界面状态。
通话流程
- 调用
signalingInvite()发起单聊通话,或调用signalingInviteInGroup()发起群聊通话。 - 被邀请用户通过
OnReceiveNewInvitation收到通话邀请,选择接受或拒绝。 - 接受邀请后调用
signalingAccept(),使用返回的房间凭据加入通话房间。 - 通话期间根据邀请状态、参与者状态、媒体流状态和自定义信令更新通话界面。
- 发起方可取消尚未接通的邀请;通话参与者可挂断已建立的通话。
核心数据
| 数据 | 说明 |
|---|---|
RtcInvite | 通话邀请,包含邀请人、被邀请人、群组、房间、媒体类型、超时时间和会话类型。 |
RtcInviteResults | 发起、接受通话或查询房间凭据后返回的 roomID、token 和 liveURL。 |
CallingRoomData | 按群组查询得到的房间 ID、邀请信息和参与者资料。 |
OnReceiveNewInvitationPayload | 收到通话邀请时的事件参数,包含 invitation、可选的 offlinePushInfo 和参与者资料。 |
customData 和自定义信令均为业务自定义字符串,可按业务协议传递 JSON 或其他格式的数据。
通话状态
调用发起、接受、拒绝、取消或挂断 API 后,可根据对应调用结果更新当前操作的界面。其他用户或设备的通话状态通过事件接收。使用 roomID 区分通话;参与者状态同时使用 roomID 和 userID 区分。
邀请生命周期、参与者进出房间和媒体流变化的监听方式见处理通话事件。自定义信令的监听方式见发送自定义信令。
按任务查找页面
这个页面有帮助吗?