SDKsReact Native商业版

发起群聊通话

使用 OpenIM React Native SDK 发起群聊音视频通话。

发起群聊音视频通话。groupID 用于标识发起通话的群组，inviteeUserIDList 指定本次邀请的群成员，不会自动邀请群内全部成员。

const roomCredentials = await OpenIMSDK.signalingInviteInGroup({
  invitation: {
    inviterUserID: currentUserID,
    inviteeUserIDList: memberUserIDs,
    groupID,
    roomID,
    timeout: 30,
    mediaType: 'video',
    sessionType: SessionType.Group,
    platformID: currentPlatform,
  },
});

参数说明

参数	类型	必填	含义
`invitation`	`RtcInvite`	是	本次通话邀请。
`invitation.inviterUserID`	`string`	是	发起通话的当前用户 ID。
`invitation.inviteeUserIDList`	`string[]`	是	本次邀请的群成员用户 ID 列表。
`invitation.groupID`	`string`	是	目标群组 ID。
`invitation.roomID`	`string`	是	本次群聊通话的房间 ID。
`invitation.timeout`	`number`	是	邀请等待时长，单位为秒。
`invitation.mediaType`	`string`	是	媒体类型，例如 `audio` 或 `video`。
`invitation.sessionType`	`SessionType`	是	群聊传入 `SessionType.Group`。
`invitation.platformID`	`Platform`	是	发起端平台；传入当前客户端对应的 `Platform` 枚举值。
`invitation.customData`	`string`	否	随邀请传递的业务扩展字符串。
`invitation.initiateTime`	`number`	否	邀请发起时间，Unix 毫秒时间戳。通常由通话流程维护，无需手动填写。
`invitation.busyLineUserIDList`	`string[]`	否	忙线用户列表。发起新邀请时通常不填写。
`offlinePushInfo`	`OfflinePush`	否	被邀请用户离线时使用的推送内容。
`offlinePushInfo.title`	`string`	条件必填	提供 `offlinePushInfo` 时填写推送标题。
`offlinePushInfo.desc`	`string`	条件必填	提供 `offlinePushInfo` 时填写推送正文。
`offlinePushInfo.ex`	`string`	条件必填	提供 `offlinePushInfo` 时填写扩展字符串；没有内容时传空字符串。
`offlinePushInfo.iOSPushSound`	`string`	条件必填	提供 `offlinePushInfo` 时填写 iOS 推送声音。
`offlinePushInfo.iOSBadgeCount`	`boolean`	条件必填	提供 `offlinePushInfo` 时说明是否更新 iOS 角标。

返回结果

调用完成后返回 RtcInviteResults，包含通话房间的 roomID、token、liveURL 和可选的忙线成员列表 busyLineUserIDList。详细字段说明见发起单聊通话。

被邀请成员会通过 OnReceiveNewInvitation 事件收到邀请通知；客户端应使用 roomID 标识通话房间，并结合参与者 userID 跟踪群内各成员的呼叫与接听状态。完整事件监听说明见处理通话事件。

这个页面有帮助吗？