音视频通话

呼叫

功能介绍

实现用户之间的呼叫功能,流程是:A用户先创建一个房间,然后呼叫B用户,如果B用户接受呼叫,AB进入房间进行通讯。

注意:在登录成功后才可以使用呼叫功能

主叫

1.创建房间

  • 调用接口:
//创建房间
RTCSDK.CreateMeeting()
  • 回调通知:
//创建房间成功
RTCSDK.CreateMeetingSuccess.callback = function(meetObj, cookie){
    //创建成功,获取房间信息meetObj,用于呼叫他人
}
//创建房间失败
RTCSDK.CreateMeetingFail.callback = function(sdkErr, cookie){
    //创建失败,可以弹出错误提示,不能再执行 进入房间
}

相关API请参考:

2.发起呼叫

注意:当用户A呼叫用户B时,只有B成功登录了,才可以收到被呼叫通知

  • 调用接口:
//A发起呼叫,邀请用户B进入房间。
const callID = RTCSDK.Call(userID, meetObj, usrExtDat, cookie)
  • 回调通知:
//呼叫操作成功响应
RTCSDK.CallSuccess.callback = function(callID, cookie){

}

// 呼叫操作失败响应
RTCSDK.CallFail.callback = function(callID, sdkErr, cookie){
    console.log("呼叫他人失败"+ sdkErr);
}

呼叫他人相关API请参考:

3.接受/拒绝呼叫

  • 回调通知:
// SDK通知用户 B 被他人 (即callerID) 呼叫
RTCSDK.NotifyCallIn.callback = function(callID, meetObj, callerID, usrExtDat){
    if(/* B 接受呼叫, 进入房间*/){
        RTCSDK.AcceptCall(callID, meetObj);
        RTCSDK.EnterMeeting3(meetObj.ID, cookie)
    } else {
        // B 拒绝呼叫
        RTCSDK.RejectCall(callID);
    }
}
//当 B 接受呼叫时,A会收到如下通知:
RTCSDK.NotifyCallAccepted.call = function(callID, meetObj, usrExtDat){
    //A此时可以进入房间
    RTCSDK.EnterMeeting3(meetObj.ID, cookie)
}
//当 B 拒绝呼叫时,A会收到如下通知:
RTCSDK.NotifyCallRejected.call = function(callID,meetObj,usrExtDat){
    console.log("客户拒绝呼叫了");
}

被呼叫者相关API请参考:

呼叫者相关API请参考:

4.挂断

  • 调用接口:
//挂断呼叫
RTCSDK.HungupCall(callID)
  • 回调通知:
//挂断呼叫成功
RTCSDK.HungupCallSuccess.callback = function(callID, cookie){
    console.log("挂断呼叫成功")
    RTCSDK.ExitMeeting();  //退出房间
}

//挂断呼叫失败
RTCSDK.HungupCallFail.callback = function(callID, sdkErr, cookie){
   console.log("挂断呼叫失败!错误码:"+ sdkErr);
}

//通知被他人挂断
RTCSDK.NotifyCallHungup.callback = function(callID, usrExtDat){
    RTCSDK.ExitMeeting();  //退出房间
}

相关API请参考:

被叫

1.被呼叫

  • 回调通知:
//通知有呼入
RTCSDK.NotifyCallIn.callback = function(callID, MeetInfoObj, callerID, usrExtDat)
{
    console.log("有呼叫到来!");
}

相关API请参考:

2.接受/拒绝呼叫

  • 调用接口:
//接受呼叫
RTCSDK.AcceptCall(callID, meetObj, "", "");

//拒绝呼叫
RTCSDK.RejectCall(callID, "", "");
  • 回调通知:
//接受呼叫成功
RTCSDK.AcceptCallSuccess.callback = function(callID, cookie)
{
}

//接受呼叫失败
RTCSDK.AcceptCallFail.callback = function(callID,sdkEr,cookie)
{
}

//拒接呼叫成功
RTCSDK.RejectCallSuccess.callback = function(callID,cookie)
{
}

//拒接呼叫失败
RTCSDK.RejectCallFail.callback = function(callID,sdkEr,cookie)
{
}

相关API请参考:

3.免打扰

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

  • 调用接口:
RTCSDK.SetDNDStatus(1); //开启免打扰

RTCSDK.SetDNDStatus(0); //关闭免打扰
  • 回调通知:
//设置免打扰状态操作成功响应
RTCSDK.SetDNDStatusSuccess.callback = function(cookie){
     
}

//设置免打扰状态操作失败响应
RTCSDK.SetDNDStatusFail.callback = function(sdkErr, cookie){
    console.log("设置免打扰状态操作失败,错误码:" + sdkErr);
}

相关API请参考: