呼叫
功能介绍
实现两个用户之间的呼叫功能,流程是:A用户先创建一个房间,然后呼叫B用户,如果B用户接受呼叫,AB进入房间进行通讯。
如果有邀请多方通话需求,请使用邀请功能。
注意:
注意:在登录成功后才可以使用呼叫功能。
主叫
1. 创建房间
- 调用接口:
//创建房间
[[RTCMgr shareInstance] createMeeting];
- 回调通知:
//创建房间成功
- (void)createMeetingSuccess:(MeetInfo *)meetInfo cookie:(NSString *)cookie{
//...
}
//创建房间失败
- (void)createMeetingFail:(CRVIDEOSDK_ERR_DEF)sdkErr cookie:(NSString *)cookie{
//创建失败,可以弹出错误提示,不能再执行 进入房间
}
相关API请参考:
2. 发起呼叫
注意:
注意:
- 当用户A呼叫用户B时,只有B成功登录了,才可以收到被呼叫通知,否则被呼叫者是无法收到被呼叫的消息的。
- 调用接口:
//开始呼叫,meetInfo为之前创建的房间对象
NSString* userID = @"user_000007";
NSString* callID = [[RTCMgr shareInstance] call:userID meetInfo:meetingInfo param:@""];
- 回调通知:
//呼叫成功发出,等待对方响应
- (void)callSuccess:(NSString *)callID cookie:(NSString *)cookie{
//...
}
//呼叫发出失败
- (void)callFail:(NSString *)callID errCode:(CRVIDEOSDK_ERR_DEF)sdkErr cookie:(NSString *)cookie {
//...
}
相关API请参考:
3. 呼叫被接受/拒绝
- 回调通知:
//通知呼叫被接受
- (void)notifyCallAccepted:(NSString *)callID meetInfo:(MeetInfo *)meetInfo usrExtDat:(NSString *)usrExtDat{
//...
}
//呼叫被对方拒绝
- (void)notifyCallRejected:(NSString *)callID reason:(CRVIDEOSDK_ERR_DEF)reason usrExtDat:(NSString *)usrExtDat {
//...
}
相关API请参考:
4. 挂断
- 调用接口:
//挂断呼叫
[[RTCMgr shareInstance] hungupCall:callID usrExtDat:@""];
- 回调通知:
//挂断呼叫成功
- (void)hangupCallSuccess:(NSString *)callID cookie:(NSString *)cookie{
}
//挂断呼叫失败
- (void)hangupCallFail:(NSString *)callID errCode:(CRVIDEOSDK_ERR_DEF)sdkErr cookie:(NSString *)cookie{
}
//通知被他人挂断
- (void)notifyCallhangup:(NSString *)callID, usrExtDat:(NSString *)usrExtDat{
}
相关API请参考:
被叫
1. 被呼叫
- 回调通知:
//有呼叫进入
- (void)notifyCallIn:(NSString *)callID meetInfo:(MeetInfo *)meetInfo callerID:(NSString *)callerID usrExtDat:(NSString *)usrExtDat
{
if(/*接受呼叫, 进入房间*/){
//打开房间界面……
}else{
//拒绝对方的呼叫
}
}
相关API请参考:
2. 接受/拒绝
- 调用接口:
//接受呼叫 (notifyCallIn回调参数meetInfo)
[[RTCMgr shareInstance] acceptCall:@"call" meetInfo:meetInfo];
//拒绝呼叫
[[RTCMgr shareInstance] rejectCall:@"callID"];
- 回调通知:
//接受呼叫成功
- (void)acceptCallSuccess:(NSString *)callID cookie:(NSString *)cookie{
//...
}
//接受呼叫失败
- (void)acceptCallFail:(NSString *)callID errCode:(CRVIDEOSDK_ERR_DEF)sdkErr cookie:(NSString *)cookie{
//...
}
//拒绝呼叫成功
- (void)rejectCallSuccess:(NSString *)callID cookie:(NSString *)cookie{
//...
}
//拒绝呼叫失败
- (void)rejectCallFail:(NSString *)callID errCode:(CRVIDEOSDK_ERR_DEF)sdkErr cookie:(NSString *)cookie{
//...
}
相关API请参考:
- acceptCall
- rejectCall
- hangupCall
- acceptCallSuccess
- acceptCallFail
- rejectCallSuccess
- rejectCallFail
- hangupCallSuccess
- hangupCallFail
3. 免打扰
如果用户当前不希望被呼叫,可以把自己的状态设置为免打扰,注意在免打扰状态下不会被呼叫,但是可以主动发起呼叫。
- 调用接口:
//开启免打扰
[[RTCMgr shareInstance] setDNDStatus:1];
//关闭免打扰
[[RTCMgr shareInstance] setDNDStatus:0];
- 回调通知:
//设置免打扰状态操作成功响应
- (void)setDNDStatusSuccess:(NSString *)cookie{
}
//设置免打扰状态操作失败响应
- (void)setDNDStatusFail:(CRVIDEOSDK_ERR_DEF)sdkErr cookie:(NSString *)cookie{
}
相关API请参考: