大廳好友解決方案包括:
1、業務服務器可以設置用戶的好友列表,客戶端可以獲得好友列表,不需要進入房間;
2、客戶端可以獲得好友上線、下線的狀態通知;
3、業務服務器可以自定義設置用戶的任意屬性(如名稱、簽名、性別、備註等)並能同步到客戶端,客戶端可以獲取業務服務器自定義的用戶屬性;
下面以一款在市面上功能強大的SDK爲例做功能實現說明。詳情可諮詢bbs.anychat.cn
客戶端API接口:
-
#define WM_GV_USERINFOUPDATE WM_GV + 16 ///< 用戶信息更新通知,wParam(INT)表示用戶ID號,lParam(INT)表示更新類別
-
#define WM_GV_FRIENDSTATUS WM_GV + 17 ///< 好友在線狀態變化,wParam(INT)表示好友用戶ID號,lParam(INT)表示用戶的當前活動狀態:0 離線, 1 上線
-
-
// 獲取用戶好友ID列表
-
BRAC_API DWORD BRAC_GetUserFriends(LPDWORD lpUserIDArray, DWORD& dwUserNum);
-
// 獲取好友在線狀態
-
BRAC_API DWORD BRAC_GetFriendStatus(DWORD dwFriendUserId, DWORD& dwStatus);
-
// 獲取用戶分組ID列表
-
BRAC_API DWORD BRAC_GetUserGroups(LPDWORD lpGroupIDArray, DWORD& dwGroupNum);
-
// 獲取分組下面的好友列表
-
BRAC_API DWORD BRAC_GetGroupFriends(DWORD dwGroupId, LPDWORD lpUserIDArray, DWORD& dwUserNum);
-
// 獲取用戶信息
-
BRAC_API DWORD BRAC_GetUserInfo(DWORD dwUserId, DWORD dwInfoId, TCHAR* lpInfoName, DWORD dwLen);
-
// 獲取用戶分組名稱
- BRAC_API DWORD BRAC_GetGroupName(DWORD dwGroupId, TCHAR* lpGroupName, DWORD dwLen);
-
// 用戶信息控制類型定義(API:BRAS_UserInfoControl 傳入參數、OnUserInfoControl回調參數)
-
#define BRAS_USERINFO_CTRLCODE_KICKOUT 1 ///< 將指定用戶從系統中踢掉
-
#define BRAS_USERINFO_CTRLCODE_SYNCDATA 2 ///< 將指定用戶的數據同步給客戶端
-
-
#define BRAS_USERINFO_CTRLCODE_ADDGROUP 20 ///< 添加用戶分組,wParam爲分組Id,lpStrValue爲分組名稱
-
#define BRAS_USERINFO_CTRLCODE_DELGROUP 21 ///< 刪除用戶分組,wParam爲分組Id
-
#define BRAS_USERINFO_CTRLCODE_ADDFRIEND 22 ///< 添加用戶好友,wParam爲好友Id
-
#define BRAS_USERINFO_CTRLCODE_DELFRIEND 23 ///< 刪除用戶好友,wParam爲好友Id
-
#define BRAS_USERINFO_CTRLCODE_SETGROUPRELATION 24 ///< 設置好友與分組的關聯關係,wParam爲分組Id,lParam爲好友Id,表示好友屬於某個分組
-
-
-
// 設置用戶的詳細信息
-
BRAS_API DWORD BRAS_SetUserInfo(DWORD dwUserId, DWORD dwInfoId, LPCTSTR lpInfoValue, DWORD dwFlags=0);
-
// 獲取用戶的詳細信息
-
BRAS_API DWORD BRAS_GetUserInfo(DWORD dwUserId, DWORD dwInfoId, TCHAR* lpInfoValue, DWORD dwSize);
-
// 用戶信息控制
- BRAS_API DWORD BRAS_UserInfoControl(DWORD dwUserId, DWORD dwCtrlCode, DWORD wParam=0, DWORD lParam=0, LPCTSTR lpStrValue=NULL);
服務器端業務邏輯處理流程
在用戶登錄成功事件中設置用戶的好友列表、分組列表、用戶屬性,併發送數據同步指令: | 一、添加用戶分組 二、添加用戶好友 三、設置好友與分組的關係(即好友屬於哪一個分組) 四、設置用戶信息(用戶資料) 五、將前面設置的資料同步給客戶端