开放录像服务器SDK接口（AnyChat Record Server SDK）

admin

亲，非常高兴的告诉您，从AnyChat r4115版本开始，我们开放了录像服务器SDK接口（AnyChat Record Server SDK）。

录像服务器SDK支持的平台包括Windows、Linux（x86、x64），支持的开发语言有C++、Java，示例代码位于SDK的src\recordserver目录下。
AnyChat Record Server SDK是服务器端SDK，用于上层应用实现特定的服务器录制功能。通过SDK接口可以获取到每个用户的视频、语音、通信数据，由上层应用自己写入文件。

录像服务器SDK的工作原理是：

一、录像服务器启动：调用API：BRRS_InitSDK(0);之后，录像服务器主动与核心服务器建立连接，连接成功之后，将会触发录像服务器的回调事件：BRRS_OnServerAppMessage_CallBack；录像服务器读当前目录下的配置文件AnyChatRecordServer.ini，配置文件会指明核心服务器的IP地址、端口信息；录像服务器与核心服务器连接成功之后，业务服务器也将收到相关的事件通知；

二、录像任务的下达：
1、客户端下达录像指令：调用API接口：BRAC_StreamRecordCtrl(dwUserId, TRUE,dwFlags, 0)，其中dwFlags参数增加标志：BRAC_RECORD_FLAGS_SERVER；
2、或是业务服务器下达录像指令：调用API接口：BRAS_StreamRecordCtrl(dwUserId, TRUE, 0, 0);

三、录像任务的执行：
1、开始录像事件：当录像服务器收到录像任务后，将产生一个回调事件：BRRS_OnRecordStart_CallBack(userid)，通知上层应用录像开始，上层应用可以创建一个文件用于录像；
2、录像数据事件：当录像服务器收到语音、视频、通信数据之后，将重复的产生回调事件：BRRS_OnRecordBuffer_CallBack(userid, buf)，通知上层有录像数据，上层应用可以将这些数据写入到文件中；

四、录像任务的停止：
1、客户端下达停止指令：调用API接口：BRAC_StreamRecordCtrl(dwUserId, FALSE, 0, 0)，
2、或是业务服务器下达录像指令：调用API接口：BRAS_StreamRecordCtrl(dwUserId, FALSE, 0, 0);


五、事件回调：
1、录像停止事件：当录像服务器收到停止指令之后，将在录像服务器上产生一个回调事件：BRRS_OnRecordFinish_CallBack(userid)，上层应用可以关闭文件，并将录像文件名通过事件参数反馈给录像服务器，录像服务器会将相关信息通知到业务服务器；
2、录像任务事件：当业务服务器收到录像服务器返回的录像任务相关信息之后，将在业务服务器上产生一个回调事件：BRAS_OnServerRecord_CallBack(userid, lpRecordFileName)，业务服务器可以将相关的录像记录进行保存等操作；

admin

1. 
   
2. #define BRRS_API extern "C"
   
3. 
   
4. #define BRRS_SERVERAPPMSG_CONNECTED                1                ///< 连接AnyChat服务器成功
   
5. #define BRRS_SERVERAPPMSG_DISCONNECT               2                ///< 与AnyChat服务器断开连接
   
6. 
   
7. // 查询信息类型定义（API：BRRS_QueryUserInfo 传入参数）
   
8. #define BRRS_USERINFO_TYPE_NICKNAME                    1                ///< 用户名
   
9. #define BRRS_USERINFO_TYPE_VCODEC                      10               ///< 视频编码器
   
10. #define BRRS_USERINFO_TYPE_WIDTH                        11               ///< 视频宽度
    
11. #define BRRS_USERINFO_TYPE_HEIGHT                       12                ///< 视频高度
    
12. #define BRRS_USERINFO_TYPE_FRAMERATE                13                ///< 视频帧率
    
13. #define BRRS_USERINFO_TYPE_ACODEC                     20                ///< 音频编码器
    
14. #define BRRS_USERINFO_TYPE_SAMPLERATE              21                ///< 音频采样率
    
15. #define BRRS_USERINFO_TYPE_CHANNELS                  22                ///< 音频采样通道数
    
16. #define BRRS_USERINFO_TYPE_SAMPLEBITS               23                ///< 音频采样位数
    
17. 
    
18. // 参数设置类型定义（API：BRRS_SetSDKOption 传入参数）
    
19. #define BRRS_SO_USESERVERTIMESTAMP                     1                ///< 使用服务器时间戳
    
20. 
    
21. // 数据类型标志（回调函数：OnAnyChatRecordBufferCallBack 参数）
    
22. #define BRRS_RECORD_FLAGS_AUDIO                        0x01            ///< 音频数据
    
23. #define BRRS_RECORD_FLAGS_VIDEO                        0x02            ///< 音频数据
    
24. #define BRRS_RECORD_FLAGS_BUFFER                      0x04            ///< 透明通道缓冲区数据
    
25. #define BRRS_RECORD_FLAGS_BUFFEREX                  0x08            ///< 透明通道扩展缓冲区
    
26. #define BRRS_RECORD_FLAGS_KEYFRAME                 0x10            ///< 视频关键帧
    
27. #define BRRS_RECORD_FLAGS_SILENCE                    0x20            ///< 音频静音帧
    
28. 
    
29. 
    
30. // 服务器应用程序消息回调函数定义
    
31. typedef void (CALLBACK* BRRS_OnServerAppMessage_CallBack)(DWORD dwMsg, DWORD wParam, DWORD lParam, LPVOID lpUserValue);
    
32. // 开始录像事件回调函数定义
    
33. typedef DWORD (CALLBACK* BRRS_OnRecordStart_CallBack)(DWORD dwUserId, LPVOID lpUserValue);
    
34. // 录像数据事件回调函数定义
    
35. typedef DWORD (CALLBACK* BRRS_OnRecordBuffer_CallBack)(DWORD dwUserId, CHAR* lpBuf, DWORD dwSize, DWORD dwTimeStamp, DWORD dwFlags, LPVOID lpUserValue);
    
36. // 结束录像事件回调函数定义
    
37. typedef DWORD (CALLBACK* BRRS_OnRecordFinish_CallBack)(DWORD dwUserId, CHAR* lpFileName, DWORD dwSize, DWORD* lpRecordSeconds, LPVOID lpUserValue);
    
38. 
    
39. /**
    
40. *  API 方法定义
    
41. */
    
42. // 设置服务器应用程序消息回调函数
    
43. BRRS_API DWORD BRRS_SetOnServerAppMessageCallBack(BRRS_OnServerAppMessage_CallBack lpFunction, LPVOID lpUserValue=NULL);
    
44. // 设置开始录像事件回调函数
    
45. BRRS_API DWORD BRRS_SetOnRecordStartCallBack(BRRS_OnRecordStart_CallBack lpFunction, LPVOID lpUserValue=NULL);
    
46. // 设置录像数据事件回调函数
    
47. BRRS_API DWORD BRRS_SetOnRecordBufferCallBack(BRRS_OnRecordBuffer_CallBack lpFunction, LPVOID lpUserValue=NULL);
    
48. // 设置录像完成事件回调函数
    
49. BRRS_API DWORD BRRS_SetOnRecordFinishCallBack(BRRS_OnRecordFinish_CallBack lpFunction, LPVOID lpUserValue=NULL);
    
50. 
    
51. // 获取SDK版本信息
    
52. BRRS_API DWORD BRRS_GetSDKVersion(DWORD& dwMainVer, DWORD& dwSubVer, TCHAR* lpCompileTime, DWORD dwBufLen);
    
53. // 初始化SDK
    
54. BRRS_API DWORD BRRS_InitSDK(DWORD dwReserved);
    
55. // 释放资源
    
56. BRRS_API DWORD BRRS_Release(void);
    
57. 
    
58. 
    
59. // 查询用户信息
    
60. BRRS_API DWORD BRRS_QueryUserInfo(DWORD dwUserId, DWORD dwInfoName, CHAR* lpValue, DWORD dwSize);
    
61. // SDK内核参数设置
    
62. BRRS_API DWORD BRRS_SetSDKOption(DWORD optname, CHAR* optval, DWORD optlen);
    
63. 
    

复制代码