音视频通话

邀请

功能介绍

邀请者向其他用户发起邀请,被邀请者接受后加入指定房间进行通讯。

使用场景:

  • 会前邀请在线用户:会议开始前,邀请其他已登录用户加入指定房间。
  • 会中邀请在线用户:会议进行中,邀请更多已登录用户加入当前房间。

使用注意点:

  • 被邀请者只有成功登录了,才可以收到被邀请通知,否则无法收到邀请消息。
  • 被邀请者可以同时收到多个邀请,应用层可以选择接受某个邀请。
  • 邀请被接受/拒绝后,邀请任务自动结束,不与后续流程相关联。
注意:

注意:在登录成功后才可以使用邀请功能。

邀请方

1. 发起邀请

  • 调用接口:
// A 邀请用户 B 加入房间 12345678
String extDat = "{\"meeting\":{\"ID\":12345678}}";
String inviteID = RTCMgr.getInstance().invite("userB", extDat, "");
  • 回调通知:
// 邀请发送结果
@Override
void inviteSuccess(String inviteID, String cookie) {
    // 邀请发送成功,等待对方响应
}

@Override
void inviteFail(String inviteID, CRVIDEOSDK_ERR_DEF sdkErr, String cookie) {
    // 邀请发送失败
}
  • 邀请 SIP/H.323 设备、监控设备

须按接口要求填写 usrExtDat(含房间号及设备信息等),分别参见 SIP/H.323 设备支持、监控设备对接。

相关 API 请参考:

2. 邀请被接受/拒绝

  • 回调通知:
// 通知邀请被接受
@Override
void notifyInviteAccepted(String inviteID, String usrExtDat) {
    // 邀请被接受;若本端未入会则入会,若已在房间中则等待被邀请者入会
}

// 通知邀请被拒绝
@Override
void notifyInviteRejected(String inviteID, CRVIDEOSDK_ERR_DEF reason, String usrExtDat) {
    // 邀请被拒绝
}

相关 API 请参考:

3. 取消邀请

  • 调用接口:
RTCMgr.getInstance().cancelInvite(inviteID, "", "");

相关 API 请参考:

被邀请方

1. 收到邀请

  • 回调通知:
@Override
void notifyInviteIn(String inviteID, String inviterUsrID, String usrExtDat) {
    // 收到邀请,可在 UI 上展示邀请信息,供用户选择接受或拒绝
}

2. 接受邀请

  • 调用接口:
RTCMgr.getInstance().acceptInvite(inviteID, "", "");
  • 回调通知:
@Override
void acceptInviteSuccess(String inviteID, String cookie) {
    // 接受邀请成功,SDK 将自动进入对应房间
}

@Override
void acceptInviteFail(String inviteID, CRVIDEOSDK_ERR_DEF sdkErr, String cookie) {
    // 接受邀请失败
}

相关 API 请参考:

3. 拒绝邀请

  • 调用接口:
RTCMgr.getInstance().rejectInvite(inviteID, "", "");

相关 API 请参考: