即时通讯技术 好友列表业务逻辑详解

大厅好友解决方案包括：
1、业务服务器可以设置用户的好友列表，客户端可以获得好友列表，不需要进入房间；
2、客户端可以获得好友上线、下线的状态通知；
3、业务服务器可以自定义设置用户的任意属性（如名称、签名、性别、备注等）并能同步到客户端，客户端可以获取业务服务器自定义的用户属性；

下面以一款在市面上功能强大的SDK为例做功能实现说明。详情可咨询bbs.anychat.cn

客户端API接口：

1. #define WM_GV_USERINFOUPDATE   WM_GV + 16                ///< 用户信息更新通知，wParam（INT）表示用户ID号，lParam（INT）表示更新类别
   
2. #define WM_GV_FRIENDSTATUS     WM_GV + 17                ///< 好友在线状态变化，wParam（INT）表示好友用户ID号，lParam（INT）表示用户的当前活动状态：0 离线， 1 上线
   
3. 
   
4. // 获取用户好友ID列表
   
5. BRAC_API DWORD BRAC_GetUserFriends(LPDWORD lpUserIDArray, DWORD& dwUserNum);
   
6. // 获取好友在线状态
   
7. BRAC_API DWORD BRAC_GetFriendStatus(DWORD dwFriendUserId, DWORD& dwStatus);
   
8. // 获取用户分组ID列表
   
9. BRAC_API DWORD BRAC_GetUserGroups(LPDWORD lpGroupIDArray, DWORD& dwGroupNum);
   
10. // 获取分组下面的好友列表
    
11. BRAC_API DWORD BRAC_GetGroupFriends(DWORD dwGroupId, LPDWORD lpUserIDArray, DWORD& dwUserNum);
    
12. // 获取用户信息
    
13. BRAC_API DWORD BRAC_GetUserInfo(DWORD dwUserId, DWORD dwInfoId, TCHAR* lpInfoName, DWORD dwLen);
    
14. // 获取用户分组名称
    
15. BRAC_API DWORD BRAC_GetGroupName(DWORD dwGroupId, TCHAR* lpGroupName, DWORD dwLen);

1. // 用户信息控制类型定义（API：BRAS_UserInfoControl 传入参数、OnUserInfoControl回调参数）
   
2. #define BRAS_USERINFO_CTRLCODE_KICKOUT          1         ///< 将指定用户从系统中踢掉
   
3. #define BRAS_USERINFO_CTRLCODE_SYNCDATA         2         ///< 将指定用户的数据同步给客户端
   
4. 
   
5. #define BRAS_USERINFO_CTRLCODE_ADDGROUP         20        ///< 添加用户分组，wParam为分组Id，lpStrValue为分组名称
   
6. #define BRAS_USERINFO_CTRLCODE_DELGROUP         21        ///< 删除用户分组，wParam为分组Id
   
7. #define BRAS_USERINFO_CTRLCODE_ADDFRIEND        22        ///< 添加用户好友，wParam为好友Id
   
8. #define BRAS_USERINFO_CTRLCODE_DELFRIEND        23        ///< 删除用户好友，wParam为好友Id
   
9. #define BRAS_USERINFO_CTRLCODE_SETGROUPRELATION 24        ///< 设置好友与分组的关联关系，wParam为分组Id，lParam为好友Id，表示好友属于某个分组
   
10. 
    
11. 
    
12. // 设置用户的详细信息
    
13. BRAS_API DWORD BRAS_SetUserInfo(DWORD dwUserId, DWORD dwInfoId, LPCTSTR lpInfoValue, DWORD dwFlags=0);
    
14. // 获取用户的详细信息
    
15. BRAS_API DWORD BRAS_GetUserInfo(DWORD dwUserId, DWORD dwInfoId, TCHAR* lpInfoValue, DWORD dwSize);
    
16. // 用户信息控制
    
17. BRAS_API DWORD BRAS_UserInfoControl(DWORD dwUserId, DWORD dwCtrlCode, DWORD wParam=0, DWORD lParam=0, LPCTSTR lpStrValue=NULL);

服务器端业务逻辑处理流程