企业🤖AI智能体构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
### **透明通道传送缓冲区** 函数: BRAC_TransBuffer(INT dwUserId, STRING lpBuf) 功能: 透明通道传送缓冲区 参数: dwUserId:整型值,目标用户编号,-1表示大家(用户当前房间所有人) lpBuf: 缓冲区,BYTE数组 返回值:0表示成功,否则为出错代码 说明: 可以利用该方法实现自定义功能,缓冲区采用透明传输,目标对象可以向房间用户发送文件,也可以是指定的对象发送文件。 该方法将会触发对方的OnAnyChatTransBuffer事件回调函数。 该API方法支持跨房间传输缓冲区数据,目标用户为指定用户时,目标用户可以与自己在不同的房间,或是目标用户没有进入任何房间,或是源用户(自己)没有进入任何房间,只要双方都登录服务器成功,则可利用该方法传输缓冲区,当目标用户编号为-1时,则源用户(自己)必须已经在房间中,表示向该房间的其它用户广播数据(注:自己不能发送给自己)。 ### **透明通道传送缓冲区扩展** 函数: BRAC_TransBufferEx(INT dwUserId, STRING lpBuf, INT wParam, INT lParam, INT dwFlags) 功能: 扩展透明通道传送缓冲区 参数: userid: 整型值,目标用户编号,只针对某一个用户,不能为-1(所有人) wParam:整型值,附带参数,由上层应用自定义 lParam: 整型值,附带参数2,由上层应用自定义 dwFlags:整型值,特殊功能标志,当对该缓冲区有特殊要求时,可通过使用相关的功能标志,通知SDK进行特殊的处理,默认为0,SDK将自动根据网络状态选择合适的传输途径(TCP、UDP or P2P) 返回值:>0表示任务ID号(可利用该ID查询文件传输进度),否则表示出错。 说明: 该函数与“BRAC_TransBuffer”功能相同,都是传输上层应用自定义(透明通道)数据,区别在于该方法通过设置相应的功能标识,如可选择采用UDP通道传输,但是只针对指定的用户传输,而“BRAC_TransBuffer”方法则固定采用TCP通道传输,且缓冲区大小不能超过1024个字节,但可以针对所有用户传输。 从应用来看: (1)、BRAC_TransBuffer适合数据量小、要求实时传输的缓冲区传递,如控制指令等; (2)、BRAC_TransBufferEx适合数据量大、对实时性要求不高的需求;