压缩包可以从这里获得:http://anychat.storage.aliyun.com/AnyChatCoreSDK_Win32(MBCS)_V4.5.zip
下载后,首先将其解压到一个临时文件夹中,然后开始后续工作。
编译后我们获得的是.lib文件。
AnyChat SDK向上层应用开放了内核的P2P连接策略,可以让应用程序来干预内核的P2P连接,以满足各种场合下的应用需求。
设置P2P连接策略的典型代码如下:
1.DWORD dwP2PPolitic = 3;
2.BRAC_SetSDKOption(BRAC_SO_NETWORK_P2PPOLITIC,(const char*)&dwP2PPolitic,sizeof(DWORD));
目前开放的P2P连接策略包含如下值:
- 0 禁止P2P连接,不主动与其它用户建立P2P连接,也不接受其它用户发起的P2P连接请求;
- 1 服务器控制P2P[默认],自动与当前房间内的所有用户建立P2P;
- 2 上层应用控制P2P连接,不主动与其它用户建立P2P连接,但可接受其它用户发起的P2P连接请求,但应用程序可以下达与指定用户建立P2P连接的指令,收到上层应用的指令后,再尝试与该用户建立P2P连接;
- 3 按需建立P2P连接,在需要建立P2P连接时(如请求对方的音频、视频数据),便自动尝试与该用户建立P2P连接,也自动接受其它用户的P2P连接请求;
P2P连接建立成功,或是断时,会通过P2P状态变化消息通知上层应用。
由于每个客户端的P2P连接资源是有限的(每个客户端最多可与30个用户建立P2P连接),所以不同的应用环境,需要设置不同的P2P连接策略。
AnyChat SDK默认是“服务器控制P2P”策略,用户进入房间后,将主动与房间内的所有用户建立P2P,该模式适用于同一个房间不超过50个用户(考虑到与部分客户端的P2P连接可能建立不成功)的应用,如果同一个房间的用户数较多,建议上层应用使用“上层应用控制P2P连接”或是“按需建立P2P连接”模式,使得客户端可以与需要的用户建立P2P,而不至于出现P2P连接资源被无关的用户占用的情况。
P2P连接策略可以初始化成功之后动态调整,但只有“禁止P2P连接”模式被设置后,会断开与其它用户的P2P连接,设置其它的模式,均不会断开现有P2P连接。当客户端设置为“禁止P2P连接”策略后,所有的音频、视频数据(包括自己传给其它用户,其它用户传给自己)都将通过服务器中转,可适用于某些特殊的应用场合。
在所有P2P连接策略中,最优的策略是“按需建立P2P连接”,但没有将其作为SDK的默认P2P连接策略,主要是该策略是新增,而为了兼容老版本的SDK,便将“服务器控制P2P”策略设置为默认连接策略。
当设置为“上层应用控制P2P连接”之后,便可以通过SDK提供的接口主动与指定的用户建立P2P连接,典型代码如下:
1.DWORD dwTargetUserId = 100;
2.BRAC_SetSDKOption(BRAC_SO_NETWORK_P2PCONNECT,(const char*)&dwTargetUserId,sizeof(DWORD));
我们建议一个应用平台上,均采用相同的P2P连接策略,否则可能出现特殊情况,例如:A用
户采用“上层应用控制P2P连接”策略,B用户采用“服务器控制P2P”策略,两个用户进入房间后,虽然上层应用没有向A用户下达与B用户建立P2P连接的请求,但实际上A、B两用户之间仍然会建立P2P连接,因为B用户会主动与A用户建立连接。
注:上述所有“建立P2P连接”并不代表P2P连接一定能建立成功,这与实际的网络状态相关,只是表示“尝试与对方建立P2P连接”。