Friend solution for video intercom SDK Hall

 

Currently, anychat only provides a list of users in the room and business logic for users entering and exiting the room. The new version will enhance support for upper-layer business logic and provide a complete Hall friend solution.

Hall friends solutions include:
1. The Business Server can set the user's friend list, and the client can obtain the friend list without entering the room;
2. The client can receive notifications about the online or offline status of friends;
3. The Business Server can customize user attributes (such as name, signature, gender, and remarks) and synchronize them to the client. The client can obtain user attributes customized by the Business Server;

The client adds an API: # Define wm_gv_userinfoupdate wm_gv + 16 // <User Information Update notification, wparam (INT) indicates the user ID, and lparam (INT) indicates the update category # Define wm_gv_friendstatus wm_gv + 17 // <friend online status change, wparam (INT) indicates the friend user ID, lparam (INT) indicates the user's current activity status: 0 offline, 1 online // Obtain the user friend ID list Brac_api DWORD brac_getuserfriends (lpdword lpuseridarray, DWORD & dwusernum ); // Obtain the online status of a friend Brac_api DWORD brac_getfriendstatus (DWORD dwfrienduserid, DWORD & dwstatus ); // Obtain the user group ID list Brac_api DWORD brac_getusergroups (lpdword lpgroupidarray, DWORD & dwgroupnum ); // Obtain the list of friends under the Group Brac_api DWORD brac_getgroupfriends (DWORD dwgroupid, lpdword lpuseridarray, DWORD & dwusernum ); // Obtain user information Brac_api DWORD brac_getuserinfo (DWORD dwuserid, DWORD dwinfoid, tchar * lpinfoname, DWORD dwlen ); // Obtain the user group name Brac_api DWORD brac_getgroupname (DWORD dwgroupid, tchar * lpgroupname, DWORD dwlen ); Copy code The following APIs are added to the server: // User information control type definition (API: bras_userinfocontrol incoming parameters, onuserinfocontrol callback parameters) # Define bras_userinfo_ctrlcode_kickout 1 // <kickout the specified user from the system # Define bras_userinfo_ctrlcode_syncdata 2 // <synchronize data of the specified user to the client # Define bras_userinfo_ctrlcode_addgroup 20 // <Add a user group. wparam is the group ID and lpstrvalue is the group name. # Define bras_userinfo_ctrlcode_delgroup 21 // <delete a user group. wparam is the group ID. # Define bras_userinfo_ctrlcode_addfriend 22 // <Add a User Friend With wparam as the friend ID # Define bras_userinfo_ctrlcode_delfriend 23 // <delete a User Friend With wparam as the friend ID # Define bras_userinfo_ctrlcode_setgrouprelation 24 // <sets the relationship between friends and groups. wparam is the group ID and lparam is the friend ID, indicating that friends belong to a group. // Set user details Bras_api DWORD bras_setuserinfo (DWORD dwuserid, DWORD dwinfoid, lpctstr lpinfovalue, DWORD dwflags = 0 ); // Obtain user details Bras_api DWORD bras_getuserinfo (DWORD dwuserid, DWORD dwinfoid, tchar * lpinfovalue, DWORD dwsize ); // User Information Control Bras_api DWORD bras_userinfocontrol (DWORD dwuserid, DWORD dwctrlcode, DWORD wparam = 0, DWORD lparam = 0, lpctstr lpstrvalue = NULL ); Copy code

Server-side business logic processing process

Set the user's friend list, group list, and user attributes in the User Logon success event, and send the data synchronization command: // Callback function definition for successful User Login Typedef void (callback * bras_onuserloginaction_callback) (DWORD dwuserid, lpctstr szusername, DWORD dwlevel, lpctstr szipaddr, lpvoid lpuservalue ); Copy code 1. Add a user group DWORD dwgroupid = 1; Bras_userinfocontrol (dwuserid, bras_userinfo_ctrlcode_addgroup, dwgroupid, 0, "my friends "); Dwgroupid = 2; Bras_userinfocontrol (dwuserid, bras_userinfo_ctrlcode_addgroup, dwgroupid, 0, "company colleague "); Copy code 2. Add User friends DWORD dwfrienduserid = 10010; Bras_userinfocontrol (dwuserid, bras_userinfo_ctrlcode_addfriend, dwfrienduserid ); Dwfrienduserid = 10011; Bras_userinfocontrol (dwuserid, bras_userinfo_ctrlcode_addfriend, dwfrienduserid ); Copy code 3. Set the relationship between friends and groups (that is, the group to which friends belong) DWORD dwgroupid = 1; DWORD dwfrienduserid = 10010; Bras_userinfocontrol (dwuserid, bras_userinfo_ctrlcode_setgrouprelation, dwgroupid, dwfrienduserid ); Dwgroupid = 2; Dwfrienduserid = 10011; Bras_userinfocontrol (dwuserid, bras_userinfo_ctrlcode_setgrouprelation, dwgroupid, dwfrienduserid ); Copy code Iv. Set User Information (User Information) Bras_setuserinfo (dwuserid, 1, "my signature "); Bras_setuserinfo (dwuserid, 2, "020-85276986 "); ...... Copy code 5. Synchronize the information set above to the client Bras_userinfocontrol (dwuserid, bras_userinfo_ctrlcode_syncdata, 0, 0 ); Copy code