新版本AnyChat已经内置视频呼叫(VideoCall)业务逻辑,简化应用层开发工作量,下面详细讲解视频呼叫业务逻辑:
一、视频呼叫业务逻辑概述
视频呼叫业务逻辑主要实现两个终端(PC、手机、Pad等)之间的通话请求流程控制,包括请求(Request)、回复(Reply)、开始(Start)以及结束(Finish)等过程,可以形象理解为打电话的流程:拨号、等待、通话、挂断。

二、视频呼叫业务逻辑流程图

151809bb2k2rgr2sbi2rer.jpg



三、视频呼叫业务逻辑API接口
客户端新增回调函数:

  1. // 视频通话消息通知回调函数定义

  2. typedef void (CALLBACK * BRAC_VideoCallEvent_CallBack)(DWORD dwEventType, DWORD dwUserId, DWORD dwErrorCode, DWORD dwFlags, DWORD dwParam, LPCTSTR lpUserStr, LPVOID lpUserValue);

  3. // 设置视频通话消息通知回调函数

  4. BRAC_API DWORD BRAC_SetVideoCallEventCallBack(BRAC_VideoCallEvent_CallBack lpFunction, LPVOID lpUserValue);


复制代码

客户端新增API接口:


  1. // 视频呼叫事件控制(请求、回复、挂断等)

  2. BRAC_API DWORD BRAC_VideoCallControl(DWORD dwEventType, DWORD dwUserId, DWORD dwErrorCode, DWORD dwFlags, DWORD dwParam, LPCTSTR lpUserStr);


复制代码

服务器新增回调函数


  1. // 视频通话消息通知回调函数定义

  2. typedef DWORD (CALLBACK * BRAS_OnVideoCallEvent_CallBack)(DWORD dwEventType, DWORD dwSrcUserId, DWORD dwTarUserId, DWORD dwErrorCode, DWORD dwFlags, DWORD dwParam, LPCTSTR lpUserStr, LPVOID lpUserValue);

  3. // 设置视频通话消息通知回调函数

  4. BRAS_API DWORD BRAS_SetOnVideoCallEventCallBack(BRAS_OnVideoCallEvent_CallBack lpFunction, LPVOID lpUserValue=NULL);


复制代码

服务器新增API接口:


  1. // 视频呼叫事件控制(请求、回复、挂断等)

  2. BRAS_API DWORD BRAS_VideoCallControl(DWORD dwEventType, DWORD dwUserId, DWORD dwErrorCode, DWORD dwFlags, DWORD dwParam, LPCTSTR lpUserStr);



复制代码

常量定义


  1. // 视频呼叫事件类型定义(API:BRAC_VideoCallControl 传入参数、VideoCallEvent回调参数)

  2. #define BRAC_VIDEOCALL_EVENT_REQUEST              1        ///< 呼叫请求

  3. #define BRAC_VIDEOCALL_EVENT_REPLY                2        ///< 呼叫请求回复

  4. #define BRAC_VIDEOCALL_EVENT_START                3        ///< 视频呼叫会话开始事件

  5. #define BRAC_VIDEOCALL_EVENT_FINISH               4        ///< 挂断(结束)呼叫会话


  6. // 视频呼叫标志定义(API:BRAC_VideoCallControl 传入参数)

  7. #define BRAC_VIDEOCALL_FLAGS_AUDIO             0x01        ///< 语音通话

  8. #define BRAC_VIDEOCALL_FLAGS_VIDEO             0x02        ///< 视频通话

  9. #define BRAC_VIDEOCALL_FLAGS_FBSRCAUDIO        0x10        ///< 禁止源(呼叫端)音频

  10. #define BRAC_VIDEOCALL_FLAGS_FBSRCVIDEO        0x20        ///< 禁止源(呼叫端)视频

  11. #define BRAC_VIDEOCALL_FLAGS_FBTARAUDIO        0x40        ///< 禁止目标(被呼叫端)音频

  12. #define BRAC_VIDEOCALL_FLAGS_FBTARVIDEO        0x80        ///< 禁止目标(被呼叫端)视频


  13. // 视频呼叫

  14. #define AC_ERROR_VIDEOCALL_CANCEL             100101       ///< 源用户主动放弃会话

  15. #define AC_ERROR_VIDEOCALL_OFFLINE            100102       ///< 目标用户不在线

  16. #define AC_ERROR_VIDEOCALL_BUSY               100103       ///< 目标用户忙

  17. #define AC_ERROR_VIDEOCALL_REJECT             100104       ///< 目标用户拒绝会话

  18. #define AC_ERROR_VIDEOCALL_TIMEOUT            100105       ///< 会话请求超时

  19. #define AC_ERROR_VIDEOCALL_DISCONNECT         100106       ///< 网络断线


复制代码

四、其它
1、客户端API(BRAC_VideoCallControl)和回调函数(BRAC_VideoCallEvent_CallBack)中的dwUserId均为对方(被呼叫方)的用户ID;2、被呼叫方拒绝通话时,发送回复(Reply)指令,dwErrorCode=100104;
3、被呼叫方同意通话时,发送回复(Reply)指令,dwErrorCode=0,然后服务器会向双方发送通话开始(Start)指令,dwParam=RoomId,房间号由核心服务器自动分配;
4、结束通话时,任何一方(包括业务服务器)均可以发送结束(Finish)指令,然后服务器会向双方发送通话结束(Finish)指令;
5、业务服务器可干预呼叫流程:在BRAS_OnVideoCallEvent_CallBack收到呼叫请求指令后,返回0表示允许呼叫,否则为出错代码,不允许呼叫;在会话过程中可以发送结束(Finish)指令,强制挂断指定用户的通话;
6、API接口中的dwParam(整型)、lpUserStr(字符串)均为用户自定义用途;
7、一个用户同时只能发起一路呼叫请求,也同时只能被一个用户呼叫;
8、视频呼叫业务流程可以脱离业务服务器,由核心服务器独立支撑,可以不需要在服务器端进行二次开发。