详细描述

关系链接口，包含了好友的添加和删除，黑名单的添加和删除等逻辑

Public 成员函数
abstract void	setFriendListener (V2TIMFriendshipListener listener)

abstract void	addFriendListener (V2TIMFriendshipListener listener)

abstract void	removeFriendListener (V2TIMFriendshipListener listener)

abstract void	getFriendList (V2TIMValueCallback< List< V2TIMFriendInfo >> callback)

abstract void	getFriendsInfo (List< String > userIDList, V2TIMValueCallback< List< V2TIMFriendInfoResult >> callback)

abstract void	setFriendInfo (V2TIMFriendInfo info, V2TIMCallback callback)

abstract void	searchFriends (V2TIMFriendSearchParam searchParam, V2TIMValueCallback< List< V2TIMFriendInfoResult >> callback)

abstract void	addFriend (V2TIMFriendAddApplication application, V2TIMValueCallback< V2TIMFriendOperationResult > callback)

abstract void	deleteFromFriendList (List< String > userIDList, int deleteType, V2TIMValueCallback< List< V2TIMFriendOperationResult >> callback)

abstract void	checkFriend (List< String > userIDList, int checkType, V2TIMValueCallback< List< V2TIMFriendCheckResult >> callback)

abstract void	getFriendApplicationList (V2TIMValueCallback< V2TIMFriendApplicationResult > callback)

abstract void	acceptFriendApplication (V2TIMFriendApplication application, int responseType, V2TIMValueCallback< V2TIMFriendOperationResult > callback)

abstract void	acceptFriendApplication (V2TIMFriendApplication application, int responseType, String remark, V2TIMValueCallback< V2TIMFriendOperationResult > callback)

abstract void	refuseFriendApplication (V2TIMFriendApplication application, V2TIMValueCallback< V2TIMFriendOperationResult > callback)

abstract void	deleteFriendApplication (V2TIMFriendApplication application, V2TIMCallback callback)

abstract void	setFriendApplicationRead (V2TIMCallback callback)

abstract void	addToBlackList (List< String > userIDList, V2TIMValueCallback< List< V2TIMFriendOperationResult >> callback)

abstract void	deleteFromBlackList (List< String > userIDList, V2TIMValueCallback< List< V2TIMFriendOperationResult >> callback)

abstract void	getBlackList (V2TIMValueCallback< List< V2TIMFriendInfo >> callback)

abstract void	createFriendGroup (String groupName, List< String > userIDList, final V2TIMValueCallback< List< V2TIMFriendOperationResult >> callback)

abstract void	getFriendGroups (List< String > groupNameList, final V2TIMValueCallback< List< V2TIMFriendGroup >> callback)

abstract void	deleteFriendGroup (List< String > groupNameList, final V2TIMCallback callback)

abstract void	renameFriendGroup (String oldName, String newName, V2TIMCallback callback)

abstract void	addFriendsToFriendGroup (String groupName, List< String > userIDList, V2TIMValueCallback< List< V2TIMFriendOperationResult >> callback)

abstract void	deleteFriendsFromFriendGroup (String groupName, List< String > userIDList, V2TIMValueCallback< List< V2TIMFriendOperationResult >> callback)

abstract void	subscribeOfficialAccount (String officialAccountID, V2TIMCallback callback)

abstract void	unsubscribeOfficialAccount (String officialAccountID, V2TIMCallback callback)

abstract void	getOfficialAccountsInfo (List< String > officialAccountIDList, V2TIMValueCallback< List< V2TIMOfficialAccountInfoResult >> callback)

abstract void	followUser (List< String > userIDList, V2TIMValueCallback< List< V2TIMFollowOperationResult >> callback)

abstract void	unfollowUser (List< String > userIDList, V2TIMValueCallback< List< V2TIMFollowOperationResult >> callback)

abstract void	getMyFollowingList (String nextCursor, V2TIMValueCallback< V2TIMUserInfoResult > callback)

abstract void	getMyFollowersList (String nextCursor, V2TIMValueCallback< V2TIMUserInfoResult > callback)

abstract void	getMutualFollowersList (String nextCursor, V2TIMValueCallback< V2TIMUserInfoResult > callback)

abstract void	getUserFollowInfo (List< String > userIDList, V2TIMValueCallback< List< V2TIMFollowInfo >> callback)

abstract void	checkFollowType (List< String > userIDList, V2TIMValueCallback< List< V2TIMFollowTypeCheckResult >> callback)

成员函数说明

◆ setFriendListener()

abstract void setFriendListener ( V2TIMFriendshipListener listener )

abstract

1.1 设置关系链监听器

◆ addFriendListener()

abstract void addFriendListener ( V2TIMFriendshipListener listener )

abstract

1.2 添加关系链监听器

◆ removeFriendListener()

abstract void removeFriendListener ( V2TIMFriendshipListener listener )

abstract

1.3 移除关系链监听器

◆ getFriendList()

abstract void getFriendList ( V2TIMValueCallback< List< V2TIMFriendInfo >> callback )

abstract

2.1 获取好友列表

◆ getFriendsInfo()

abstract void getFriendsInfo	(	List< String >	userIDList,
		V2TIMValueCallback< List< V2TIMFriendInfoResult >>	callback
	)

abstract

2.2 获取指定好友资料

参数

userIDList

好友 userID 列表

ID 建议一次最大 100 个，因为数量过多可能会导致数据包太大被后台拒绝，后台限制数据包最大为 1M。

◆ setFriendInfo()

abstract void setFriendInfo	(	V2TIMFriendInfo	info,
		V2TIMCallback	callback
	)

abstract

2.3 设置指定好友资料

◆ searchFriends()

abstract void searchFriends	(	V2TIMFriendSearchParam	searchParam,
		V2TIMValueCallback< List< V2TIMFriendInfoResult >>	callback
	)

abstract

2.4 搜索好友（5.4.666 及以上版本支持）

注意

接口返回本地存储的用户资料，可以根据 V2TIMFriendInfoResult 中的 getRelation 来判断是否为好友。
该功能为 IM 旗舰版功能，购买旗舰版套餐包后可使用，详见价格说明

◆ addFriend()

abstract void addFriend	(	V2TIMFriendAddApplication	application,
		V2TIMValueCallback< V2TIMFriendOperationResult >	callback
	)

abstract

2.5 添加好友

◆ deleteFromFriendList()

abstract void deleteFromFriendList	(	List< String >	userIDList,
		int	deleteType,
		V2TIMValueCallback< List< V2TIMFriendOperationResult >>	callback
	)

abstract

2.6 删除好友

参数

userIDList	要删除的好友 userID 列表 ID 建议一次最大 100 个，因为数量过多可能会导致数据包太大被后台拒绝，后台限制数据包最大为 1M。
deleteType	删除类型 V2TIMFriendInfo.V2TIM_FRIEND_TYPE_SINGLE：单向好友 V2TIMFriendInfo.V2TIM_FRIEND_TYPE_BOTH：双向好友

◆ checkFriend()

abstract void checkFriend	(	List< String >	userIDList,
		int	checkType,
		V2TIMValueCallback< List< V2TIMFriendCheckResult >>	callback
	)

abstract

2.7 检查指定用户的好友关系

参数

userIDList	要检查的 userID 列表
checkType	检查类型（单向好友检查、双向好友检查）

注意

checkType 的使用需要注意：

checkType 如果传入 V2TIM_FRIEND_TYPE_SINGLE，结果返回：V2TIM_FRIEND_RELATION_TYPE_NONE、V2TIM_FRIEND_RELATION_TYPE_IN_MY_FRIEND_LIST 两种情况
checkType 如果传入 V2TIM_FRIEND_TYPE_BOTH，结果返回：V2TIM_FRIEND_RELATION_TYPE_NONE、V2TIM_FRIEND_RELATION_TYPE_IN_MY_FRIEND_LIST、 V2TIM_FRIEND_RELATION_TYPE_IN_OTHER_FRIEND_LIST、V2TIM_FRIEND_RELATION_TYPE_BOTH_WAY 四种情况

◆ getFriendApplicationList()

abstract void getFriendApplicationList ( V2TIMValueCallback< V2TIMFriendApplicationResult > callback )

abstract

3.1 获取好友申请列表

注意

好友申请列表包括发起的好友申请和收到的好友申请。
最多支持100个。

◆ acceptFriendApplication() [1/2]

abstract void acceptFriendApplication	(	V2TIMFriendApplication	application,
		int	responseType,
		V2TIMValueCallback< V2TIMFriendOperationResult >	callback
	)

abstract

3.2 同意好友申请

参数

application	好友申请信息，getFriendApplicationList 成功后会返回
responseType	建立单向/双向好友关系 V2TIMFriendApplication.V2TIM_FRIEND_ACCEPT_AGREE：同意添加单向好友 V2TIMFriendApplication.V2TIM_FRIEND_ACCEPT_AGREE_AND_ADD：同意并添加为双向好友

◆ acceptFriendApplication() [2/2]

abstract void acceptFriendApplication	(	V2TIMFriendApplication	application,
		int	responseType,
		String	remark,
		V2TIMValueCallback< V2TIMFriendOperationResult >	callback
	)

abstract

3.3 同意好友申请，并设置备注

参数

application	好友申请信息，getFriendApplicationList 成功后会返回
responseType	建立单向/双向好友关系 V2TIMFriendApplication.V2TIM_FRIEND_ACCEPT_AGREE：同意添加单向好友 V2TIMFriendApplication.V2TIM_FRIEND_ACCEPT_AGREE_AND_ADD：同意并添加为双向好友
remark	好友备注，最长 96 个字节

◆ refuseFriendApplication()

abstract void refuseFriendApplication	(	V2TIMFriendApplication	application,
		V2TIMValueCallback< V2TIMFriendOperationResult >	callback
	)

abstract

3.4 拒绝好友申请

参数

application 好友申请信息，getFriendApplicationList 成功后会返回

◆ deleteFriendApplication()

abstract void deleteFriendApplication	(	V2TIMFriendApplication	application,
		V2TIMCallback	callback
	)

abstract

3.5 删除好友申请

参数

application 好友申请信息，getFriendApplicationList 成功后会返回

◆ setFriendApplicationRead()

abstract void setFriendApplicationRead ( V2TIMCallback callback )

abstract

3.6 设置好友申请已读

◆ addToBlackList()

abstract void addToBlackList	(	List< String >	userIDList,
		V2TIMValueCallback< List< V2TIMFriendOperationResult >>	callback
	)

abstract

4.1 添加用户到黑名单

◆ deleteFromBlackList()

abstract void deleteFromBlackList	(	List< String >	userIDList,
		V2TIMValueCallback< List< V2TIMFriendOperationResult >>	callback
	)

abstract

4.2 把用户从黑名单中删除

◆ getBlackList()

abstract void getBlackList ( V2TIMValueCallback< List< V2TIMFriendInfo >> callback )

abstract

4.3 获取黑名单列表

◆ createFriendGroup()

abstract void createFriendGroup	(	String	groupName,
		List< String >	userIDList,
		final V2TIMValueCallback< List< V2TIMFriendOperationResult >>	callback
	)

abstract

5.1 新建好友分组

参数

groupName	分组名称
userIDList	要添加到分组中的好友 userID 列表

◆ getFriendGroups()

abstract void getFriendGroups	(	List< String >	groupNameList,
		final V2TIMValueCallback< List< V2TIMFriendGroup >>	callback
	)

abstract

5.2 获取分组信息

参数

groupNameList 要获取信息的好友分组名称列表,传入 null 获得所有分组信息

◆ deleteFriendGroup()

abstract void deleteFriendGroup	(	List< String >	groupNameList,
		final V2TIMCallback	callback
	)

abstract

5.3 删除好友分组

◆ renameFriendGroup()

abstract void renameFriendGroup	(	String	oldName,
		String	newName,
		V2TIMCallback	callback
	)

abstract

修改好友分组的名称

参数

oldName	旧的分组名称
newName	新的分组名称
callback	回调

◆ addFriendsToFriendGroup()

abstract void addFriendsToFriendGroup	(	String	groupName,
		List< String >	userIDList,
		V2TIMValueCallback< List< V2TIMFriendOperationResult >>	callback
	)

abstract

5.4 添加好友到一个好友分组

◆ deleteFriendsFromFriendGroup()

abstract void deleteFriendsFromFriendGroup	(	String	groupName,
		List< String >	userIDList,
		V2TIMValueCallback< List< V2TIMFriendOperationResult >>	callback
	)

abstract

5.5 从好友分组中删除好友

◆ subscribeOfficialAccount()

abstract void subscribeOfficialAccount	(	String	officialAccountID,
		V2TIMCallback	callback
	)

abstract

6.1 订阅公众号（7.6 及其以上版本支持）

◆ unsubscribeOfficialAccount()

abstract void unsubscribeOfficialAccount	(	String	officialAccountID,
		V2TIMCallback	callback
	)

abstract

6.2 取消订阅公众号（7.6 及其以上版本支持）

◆ getOfficialAccountsInfo()

abstract void getOfficialAccountsInfo	(	List< String >	officialAccountIDList,
		V2TIMValueCallback< List< V2TIMOfficialAccountInfoResult >>	callback
	)

abstract

6.3 获取公众号列表（7.6 及其以上版本支持）

参数

officialAccountIDList 公众号 ID 列表。

注意: officialAccountIDList 传空时，获取订阅的公众号列表

◆ followUser()

abstract void followUser	(	List< String >	userIDList,
		V2TIMValueCallback< List< V2TIMFollowOperationResult >>	callback
	)

abstract

7.1 关注用户（从 7.8 版本开始支持）

注意

一次最多支持关注 20 个用户。
该功能为 IM 旗舰版功能，购买旗舰版套餐包后可使用，详见价格说明。

◆ unfollowUser()

abstract void unfollowUser	(	List< String >	userIDList,
		V2TIMValueCallback< List< V2TIMFollowOperationResult >>	callback
	)

abstract

7.2 取消关注用户（从 7.8 版本开始支持）

注意

一次最多支持取消关注 20 个用户。
该功能为 IM 旗舰版功能，购买旗舰版套餐包后可使用，详见价格说明。

◆ getMyFollowingList()

abstract void getMyFollowingList	(	String	nextCursor,
		V2TIMValueCallback< V2TIMUserInfoResult >	callback
	)

abstract

7.3 获取我的关注列表（从 7.8 版本开始支持）

参数

nextCursor 分页拉取标志，第一次拉取填 null 或 ""，回调成功如果 nextCursor 不为 ""，需要分页，可以传入该值再次拉取，直至 nextCursor 返回为 ""

注意

该功能为 IM 旗舰版功能，购买旗舰版套餐包后可使用，详见价格说明。

◆ getMyFollowersList()

abstract void getMyFollowersList	(	String	nextCursor,
		V2TIMValueCallback< V2TIMUserInfoResult >	callback
	)

abstract

7.4 获取我的粉丝列表（从 7.8 版本开始支持）

参数

nextCursor 分页拉取标志，第一次拉取填 null 或 ""，回调成功如果 nextCursor 不为 ""，需要分页，可以传入该值再次拉取，直至 nextCursor 返回为 ""

注意

该功能为 IM 旗舰版功能，购买旗舰版套餐包后可使用，详见价格说明。

◆ getMutualFollowersList()

abstract void getMutualFollowersList	(	String	nextCursor,
		V2TIMValueCallback< V2TIMUserInfoResult >	callback
	)

abstract

7.5 获取我的互关列表（从 7.8 版本开始支持）

参数

nextCursor 分页拉取标志，第一次拉取填 null 或 ""，回调成功如果 nextCursor 不为 ""，需要分页，可以传入该值再次拉取，直至 nextCursor 返回为 ""

注意

该功能为 IM 旗舰版功能，购买旗舰版套餐包后可使用，详见价格说明。

◆ getUserFollowInfo()

abstract void getUserFollowInfo	(	List< String >	userIDList,
		V2TIMValueCallback< List< V2TIMFollowInfo >>	callback
	)

abstract

7.6 获取指定用户的关注/粉丝/互关数量信息（从 7.8 版本开始支持）

注意

该功能为 IM 旗舰版功能，购买旗舰版套餐包后可使用，详见价格说明。

◆ checkFollowType()

abstract void checkFollowType	(	List< String >	userIDList,
		V2TIMValueCallback< List< V2TIMFollowTypeCheckResult >>	callback
	)

abstract

7.7 检查指定用户的关注类型（从 7.8 版本开始支持）

注意

该功能为 IM 旗舰版功能，购买旗舰版套餐包后可使用，详见价格说明。

详细描述

关系链接口，包含了好友的添加和删除，黑名单的添加和删除等逻辑

Public 成员函数

成员函数说明

◆ setFriendListener()

◆ addFriendListener()

◆ removeFriendListener()

◆ getFriendList()

◆ getFriendsInfo()

◆ setFriendInfo()

◆ searchFriends()

◆ addFriend()

◆ deleteFromFriendList()

◆ checkFriend()

◆ getFriendApplicationList()

◆ acceptFriendApplication() [1/2]

◆ acceptFriendApplication() [2/2]

◆ refuseFriendApplication()

◆ deleteFriendApplication()

◆ setFriendApplicationRead()

◆ addToBlackList()

◆ deleteFromBlackList()

◆ getBlackList()

◆ createFriendGroup()

◆ getFriendGroups()

◆ deleteFriendGroup()

◆ renameFriendGroup()

修改好友分组的名称

◆ addFriendsToFriendGroup()

◆ deleteFriendsFromFriendGroup()

◆ subscribeOfficialAccount()

◆ unsubscribeOfficialAccount()

◆ getOfficialAccountsInfo()

◆ followUser()

◆ unfollowUser()

◆ getMyFollowingList()

◆ getMyFollowersList()

◆ getMutualFollowersList()

◆ getUserFollowInfo()

◆ checkFollowType()