呼叫
功能介绍
实现用户之间的呼叫功能,流程是:A 用户先创建一个房间,然后呼叫 B 用户,如果 B 用户接受呼叫,AB 进入房间进行通讯。
注意:
在登录成功并且启用呼叫功能的情况下才可以使用排队功能
注册回调
RtcSDK.callManager.setListener(CallListener(
onNotifyCallIn: notifyCallIn,
onNotifyCallAccepted: notifyCallAccept,
onNotifyCallRejected: notifyCallReject,
onNotifyCallHangup: notifyCallHangup,
));
// 收到呼叫
void notifyCallIn(
String callID, int confID, String callerID, String usrExtDat) {
// 接受呼叫
CallResult result = await RtcSDK.callManager.acceptCall(callID, MeetInfo(confId: confID));
// 拒绝呼叫
CallResult result = await RtcSDK.callManager.rejectCall(callID);
}
// 对方接受了呼叫
void notifyCallAccept(String callID, int confID, String usrExtDat) async {
print('$callID接受呼叫, 进房间$confID');
}
// 对方拒绝了呼叫
void notifyCallReject(String callID, int sdkErr, String usrExtDat) {
print('$callID拒绝呼叫,sdkErr: $sdkErr');
}
// 对方挂断了呼叫
void notifyCallHangup(String callID, String usrExtDat) {
print('$callID挂断呼叫');
}
主叫
1.创建房间
- 调用接口:
// 创建房间
MeetInfo meetInfo = await RtcSDK.roomManager.createMeeting();
if (meetInfo.sdkErr == 0) {
// 创建房间成功
} else {
// 创建房间失败
}
2.发起呼叫
注意:
当用户 A 呼叫用户 B 时,只有 B 成功登录了,才可以收到被呼叫通知
- 调用接口:
//A发起呼叫,邀请用户B进入房间。
CallResult callResult = await RtcSDK.callManager.call(userID, meetInfo);
呼叫他人相关 API 请参考:
3.接受/拒绝呼叫
- 回调通知:
//当 B 接受呼叫时,A会收到如下通知:
void notifyCallAccept(String callID, int confID, String usrExtDat) async {
print('$callID接受呼叫, 进房间$confID');
}
//当 B 拒绝呼叫时,A会收到如下通知:
void notifyCallReject(String callID, int sdkErr, String usrExtDat) {
print('$callID拒绝呼叫,sdkErr: $sdkErr');
}
呼叫者相关 API 请参考:
4.挂断
- 调用接口:
// 挂断呼叫
CallResult result = await RtcSDK.callManager.hangupCall(callID, usrExtDat, cookie);
- 回调通知:
void notifyCallHangup(String callID, String usrExtDat) {
print('$callID挂断呼叫');
}
相关 API 请参考:
被叫
1.被呼叫
- 回调通知:
// 通知有呼叫到来
void notifyCallIn(
String callID, int confID, String callerID, String usrExtDat) {
// 接受呼叫
CallResult result = await RtcSDK.callManager.acceptCall(callID, MeetInfo(confId: confID));
// 拒绝呼叫
CallResult result = await RtcSDK.callManager.rejectCall(callID);
}
相关 API 请参考:
2.免打扰
如果用户当前不希望被呼叫,可以把自己的状态设置为免打扰,注意在免打扰状态下不会被呼叫,但是可以主动发起呼叫。
- 调用接口:
CommonResult result = await RtcSDK.sdkManager.setDNDStatus(1); //开启免打扰
CommonResult result = await RtcSDK.sdkManager.setDNDStatus(0); //关闭免打扰
if (result.sdkErr == 0) {
//设置免打扰成功
} else {
//设置免打扰失败
}
相关 API 请参考: