呼叫
功能介绍
实现用户之间的呼叫功能,流程是:A用户先创建一个房间,然后呼叫B用户,如果B用户接受呼叫,AB进入房间进行通讯。
注意:在登录成功后才可以使用呼叫功能
主叫
1.创建房间
- 调用接口:
//创建房间
rtcsdk.createMeeting()
- 回调通知:
//创建房间成功
rtcsdk.on("createMeetingSuccess", (meetID, cookie) => {
//创建成功,获取房间信息meetObj,用于呼叫他人
})
//创建房间失败
rtcsdk.on("createMeetingFail", (sdkErr, cookie) => {
//创建失败,可以弹出错误提示,不能再执行 进入房间
})
相关API请参考:
2.发起呼叫
注意:当用户A呼叫用户B时,只有B成功登录了,才可以收到被呼叫通知
- 调用接口:
//A发起呼叫,邀请用户B进入房间。
const callID = rtcsdk.call(calledUserID, meetID);
- 回调通知:
//呼叫操作的结果
rtcsdk.on("callRslt", (callID, sdkErr, cookie) => {
if(sdkErr === 0) {
//呼叫发送成功
} else {
//呼叫发送失败
}
})
呼叫他人相关API请参考:
3.接受/拒绝呼叫
- 回调通知:
//当 B 接受呼叫时,A会收到如下通知:
rtcsdk.on("notifyCallAccepted", (callID, meetID) => {
//A此时可以进入房间
rtcsdk.enterMeeting(meetID);
})
//当 B 拒绝呼叫时,A会收到如下通知:
rtcsdk.on("notifyCallRejected", (callID, sdkErr) => {
console.log("客户拒绝呼叫了");
})
呼叫者相关API请参考:
4.挂断
- 调用接口:
//挂断呼叫
rtcsdk.hangupCall(callID);
- 回调通知:
rtcsdk.on("hangupCallRslt", (callID, sdkErr, cookie) => {
if(sdkErr === 0) {
//挂断发送成功
rtcsdk.exitMeeting(); //退出房间
} else {
//挂断发送失败
}
})
//通知被他人挂断
rtcsdk.on("notifyCallHungup", (callID, usrExtDat) => {
rtcsdk.exitMeeting(); //退出房间
})
相关API请参考:
被叫
1.被呼叫
- 回调通知:
// 通知有呼叫到来
rtcsdk.on("notifyCallIn", (callID, meetID, callerID) => {
if(/* B 接受呼叫, 进入房间*/){
rtcsdk.acceptCall(callID, meetID, meetID); //meetID作为cookie
} else {
// B 拒绝呼叫
rtcsdk.rejectCall(callID)
}
})
//接受呼叫的响应
rtcsdk.on("acceptCallRslt", (callID, sdkErr, cookie) => {
if(sdkErr === 0) {
//接受呼叫成功
rtcsdk.enterMeeting(cookie);
} else {
//接受呼叫失败
}
})
//拒绝呼叫的响应
rtcsdk.on("rejectCallRslt", (callID, sdkErr, cookie) => {
if(sdkErr === 0) {
//拒绝呼叫成功
} else {
//拒绝呼叫失败
}
})
相关API请参考:
2.免打扰
如果用户当前不希望被呼叫,可以把自己的状态设置为免打扰,注意在免打扰状态下不会被呼叫,但是可以主动发起呼叫。
- 调用接口:
rtcsdk.setDNDStatus(1); //开启免打扰
rtcsdk.setDNDStatus(0); //关闭免打扰
- 回调通知:
//设置免打扰状态操作失败响应
rtcsdk.on("setDNDStatusRslt", (sdkErr, cookie) => {
if(sdkErr === 0) {
//设置免打扰成功
} else {
//设置免打扰失败
}
})
相关API请参考: