音视频通话

呼叫

功能介绍

实现两个用户之间的呼叫功能,流程是: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. 发起呼叫

注意:

注意:

  1. 当用户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请参考:

3. 免打扰

如果用户当前不希望被呼叫,可以把自己的状态设置为免打扰,注意在免打扰状态下不会被呼叫,但是可以主动发起呼叫。

  • 调用接口:
//开启免打扰
[[RTCMgr shareInstance] setDNDStatus:1];

//关闭免打扰
[[RTCMgr shareInstance] setDNDStatus:0];

  • 回调通知:

//设置免打扰状态操作成功响应
- (void)setDNDStatusSuccess:(NSString *)cookie{
}


//设置免打扰状态操作失败响应
- (void)setDNDStatusFail:(CRVIDEOSDK_ERR_DEF)sdkErr cookie:(NSString *)cookie{
}

相关API请参考: