音视频通话

呼叫

功能介绍

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

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

主叫

1.创建房间

  • 调用接口:
//创建房间
RTCSDK.createMeeting()
  • 回调通知:
//创建房间成功
RTCSDK.on("createMeetingSuccess", ({ ID, cookie }) => {
    //创建成功,获取房间信息meetObj,用于呼叫他人
})

//创建房间失败
RTCSDK.on("createMeetingFail", ({ sdkErr, cookie }) => {
    //创建失败,可以弹出错误提示,不能再执行 进入房间
})

相关API请参考:

2.发起呼叫

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

  • 调用接口:
//A发起呼叫,邀请用户B进入房间。
const callID = RTCSDK.call(calledUserID, ID)
  • 回调通知:
//呼叫操作的结果
RTCSDK.on("callRslt", ({ callID, sdkErr, cookie }) => {
  if(sdkErr === 0) {
    //呼叫发送成功
  } else {
    //呼叫发送失败
  }
})

呼叫他人相关API请参考:

3.接受/拒绝呼叫

  • 回调通知:
//当 B 接受呼叫时,A会收到如下通知:
RTCSDK.on("notifyCallAccepted", ({ callID, ID, usrExtDat }) => {
    //A此时可以进入房间
    RTCSDK.enterMeeting(ID);
})

//当 B 拒绝呼叫时,A会收到如下通知:
RTCSDK.on("notifyCallRejected", ({ callID, sdkErr, usrExtDat }) => {
    console.log("客户拒绝呼叫了");
})

呼叫者相关API请参考:

4.挂断

  • 调用接口:
//挂断呼叫
RTCSDK.hangupCall(callID, usrExtDat, cookie)
  • 回调通知:
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, ID, callerID, usrExtDat }) => {
    if(/* B 接受呼叫, 进入房间*/){
        const cookie = ID
        RTCSDK.acceptCall(callID, ID, cookie);  //ID作为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("setDNDStatusSuccess", ({ cookie }) => {
    
})
//设置免打扰失败
RTCSDK.on("setDNDStatusFail", ({ sdkErr, cookie }) => {

})

相关API请参考: