邀请
功能介绍
邀请者向其他用户发起邀请,被邀请者接受后加入指定房间进行通讯。
使用场景:
- 会前邀请在线用户:会议开始前,邀请其他已登录用户加入指定房间。
- 会中邀请在线用户:会议进行中,邀请更多已登录用户加入当前房间。
使用注意点:
- 被邀请者只有成功登录了,才可以收到被邀请通知,否则无法收到邀请消息。
- 被邀请者可以同时收到多个邀请,应用层可以选择接受某个邀请。
- 邀请被接受/拒绝后,邀请任务自动结束,不与后续流程相关联。
注意:
注意:在登录成功后才可以使用邀请功能。
邀请方
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 请参考: