浏览 SDKs · React Native
SDKsReact Native

音视频通话概览

OpenIM React Native SDK 音视频通话概览。

复制

OpenIM React Native SDK 提供音视频通话的信令 API,用于发起和处理通话邀请、查询房间信息及同步通话状态。它只处理通话业务信令,不负责音视频采集与播放、媒体房间连接或通话界面渲染。

发起或接受通话后,SDK 返回 roomIDtokenliveURL 等房间凭据。应用需要将这些凭据交给实时音视频媒体引擎加入通话房间,并自行处理设备权限、媒体轨道、弱网策略和界面状态。

通话流程

  1. 调用 signalingInvite() 发起单聊通话,或调用 signalingInviteInGroup() 发起群聊通话。
  2. 被邀请用户通过 OnReceiveNewInvitation 收到通话邀请,选择接受或拒绝。
  3. 接受邀请后调用 signalingAccept(),使用返回的房间凭据加入通话房间。
  4. 通话期间根据邀请状态、参与者状态、媒体流状态和自定义信令更新通话界面。
  5. 发起方可取消尚未接通的邀请;通话参与者可挂断已建立的通话。

核心数据

数据说明
RtcInvite通话邀请,包含邀请人、被邀请人、群组、房间、媒体类型、超时时间和会话类型。
RtcInviteResults发起、接受通话或查询房间凭据后返回的 roomIDtokenliveURL
CallingRoomData按群组查询得到的房间 ID、邀请信息和参与者资料。
OnReceiveNewInvitationPayload收到通话邀请时的事件参数,包含 invitation、可选的 offlinePushInfo 和参与者资料。

customData 和自定义信令均为业务自定义字符串,可按业务协议传递 JSON 或其他格式的数据。

通话状态

调用发起、接受、拒绝、取消或挂断 API 后,可根据对应调用结果更新当前操作的界面。其他用户或设备的通话状态通过事件接收。使用 roomID 区分通话;参与者状态同时使用 roomIDuserID 区分。

邀请生命周期、参与者进出房间和媒体流变化的监听方式见处理通话事件。自定义信令的监听方式见发送自定义信令

按任务查找页面

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