IMSDK
即时通信 IM 提供全球接入、单聊、群聊、消息推送、资料关系链托管、帐号鉴权等全方位解决方案,并提供完备的 App 接入、后台管理接口。
V2TIMManager(Friendship)

构造函数

(void) - setFriendListener:
 
(void) - getFriendList:fail:
 
(void) - getFriendsInfo:succ:fail:
 
(void) - setFriendInfo:succ:fail:
 
(void) - addFriend:succ:fail:
 
(void) - deleteFromFriendList:deleteType:succ:fail:
 
(void) - checkFriend:succ:fail:
 
(void) - getFriendApplicationList:fail:
 
(void) - acceptFriendApplication:type:succ:fail:
 
(void) - refuseFriendApplication:succ:fail:
 
(void) - deleteFriendApplication:succ:fail:
 
(void) - setFriendApplicationRead:fail:
 
(void) - addToBlackList:succ:fail:
 
(void) - deleteFromBlackList:succ:fail:
 
(void) - getBlackList:fail:
 
(void) - createFriendGroup:userIDList:succ:fail:
 
(void) - getFriendGroupList:succ:fail:
 
(void) - deleteFriendGroup:succ:fail:
 
(void) - renameFriendGroup:newName:succ:fail:
 
(void) - addFriendsToFriendGroup:userIDList:succ:fail:
 
(void) - deleteFriendsFromFriendGroup:userIDList:succ:fail:
 

成员类型定义说明

◆ V2TIMFriendInfoListSucc

- (typedef void(^ V2TIMFriendInfoListSucc) (NSArray< V2TIMFriendInfo * > *infoList))
protected

获取好友列表成功回调

◆ V2TIMFriendInfoResultListSucc

- (typedef void(^ V2TIMFriendInfoResultListSucc) (NSArray< V2TIMFriendInfoResult * > *resultList))
protected

获取指定好友信息成功回调

◆ V2TIMFriendOperationResultSucc

- (typedef void(^ V2TIMFriendOperationResultSucc) (V2TIMFriendOperationResult *result))
protected

好友操作成功回调

◆ V2TIMFriendOperationResultListSucc

- (typedef void(^ V2TIMFriendOperationResultListSucc) (NSArray< V2TIMFriendOperationResult * > *resultList))
protected

好友列表操作成功回调

◆ V2TIMFriendCheckResultSucc

- (typedef void(^ V2TIMFriendCheckResultSucc) (V2TIMFriendCheckResult *result))
protected

好友检查成功回调

◆ V2TIMFriendGroupListSucc

- (typedef void(^ V2TIMFriendGroupListSucc) (NSArray< V2TIMFriendGroup * > *groups))
protected

获取群分组列表成功回调

◆ V2TIMFriendApplicationResultSucc

- (typedef void(^ V2TIMFriendApplicationResultSucc) (V2TIMFriendApplicationResult *result))
protected

获取好友申请列表成功回调

成员枚举类型说明

◆ V2TIMFriendApplicationType

- (enum V2TIMFriendApplicationType) :
protected

好友申请类型

枚举值
V2TIM_FRIEND_APPLICATION_COME_IN 

别人发给我的

V2TIM_FRIEND_APPLICATION_SEND_OUT 

我发给别人的

V2TIM_FRIEND_APPLICATION_BOTH 

别人发给我的 和 我发给别人的。仅拉取时有效

◆ V2TIMFriendType

- (enum V2TIMFriendType) :
protected

好友类型

枚举值
V2TIM_FRIEND_TYPE_SINGLE 

单向好友

V2TIM_FRIEND_TYPE_BOTH 

双向好友

◆ V2TIMFriendRelationType

- (enum V2TIMFriendRelationType) :
protected

好友关系类型

枚举值
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 

互为好友

◆ V2TIMFriendAcceptType

- (enum V2TIMFriendAcceptType) :
protected

好友申请接受类型

枚举值
V2TIM_FRIEND_ACCEPT_AGREE 

接受加好友(建立单向好友)

V2TIM_FRIEND_ACCEPT_AGREE_AND_ADD 

接受加好友并加对方为好友(建立双向好友)

函数文档

◆ setFriendListener:()

- (void) setFriendListener: (id< V2TIMFriendshipListener >)  listener

1.1 设置关系链监听器

◆ getFriendList:fail:()

- (void) getFriendList: (V2TIMFriendInfoListSucc succ
fail: (V2TIMFail)  fail 

2.1 获取好友列表

◆ getFriendsInfo:succ:fail:()

- (void) getFriendsInfo: (NSArray< NSString * > *)  userIDList
succ: (V2TIMFriendInfoResultListSucc succ
fail: (V2TIMFail)  fail 

2.2 获取指定好友资料

参数
userIDList好友 userID 列表
  • ID 建议一次最大 100 个,因为数量过多可能会导致数据包太大被后台拒绝,后台限制数据包最大为 1M。

◆ setFriendInfo:succ:fail:()

- (void) setFriendInfo: (V2TIMFriendInfo *)  info
succ: (V2TIMSucc)  succ
fail: (V2TIMFail)  fail 

2.3 设置指定好友资料

◆ addFriend:succ:fail:()

- (void) addFriend: (V2TIMFriendAddApplication *)  application
succ: (V2TIMFriendOperationResultSucc succ
fail: (V2TIMFail)  fail 

2.4 添加好友

◆ deleteFromFriendList:deleteType:succ:fail:()

- (void) deleteFromFriendList: (NSArray *)  userIDList
deleteType: (V2TIMFriendType deleteType
succ: (V2TIMFriendOperationResultListSucc succ
fail: (V2TIMFail)  fail 

2.5 删除好友

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

◆ checkFriend:succ:fail:()

- (void) checkFriend: (NSString *)  userID
succ: (V2TIMFriendCheckResultSucc succ
fail: (V2TIMFail)  fail 

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

◆ getFriendApplicationList:fail:()

- (void) getFriendApplicationList: (V2TIMFriendApplicationResultSucc succ
fail: (V2TIMFail)  fail 

3.1 获取好友申请列表

◆ acceptFriendApplication:type:succ:fail:()

- (void) acceptFriendApplication: (V2TIMFriendApplication *)  application
type: (V2TIMFriendAcceptType acceptType
succ: (V2TIMFriendOperationResultSucc succ
fail: (V2TIMFail)  fail 

3.2 同意好友申请

参数
application好友申请信息,getFriendApplicationList 成功后会返回
acceptType建立单向/双向好友关系

◆ refuseFriendApplication:succ:fail:()

- (void) refuseFriendApplication: (V2TIMFriendApplication *)  application
succ: (V2TIMFriendOperationResultSucc succ
fail: (V2TIMFail)  fail 

3.3 拒绝好友申请

参数
application好友申请信息,getFriendApplicationList 成功后会返回

◆ deleteFriendApplication:succ:fail:()

- (void) deleteFriendApplication: (V2TIMFriendApplication *)  application
succ: (V2TIMSucc)  succ
fail: (V2TIMFail)  fail 

3.4 删除好友申请

参数
application好友申请信息,getFriendApplicationList 成功后会返回

◆ setFriendApplicationRead:fail:()

- (void) setFriendApplicationRead: (V2TIMSucc)  succ
fail: (V2TIMFail)  fail 

3.5 设置好友申请已读

◆ addToBlackList:succ:fail:()

- (void) addToBlackList: (NSArray *)  userIDList
succ: (V2TIMFriendOperationResultListSucc succ
fail: (V2TIMFail)  fail 

4.1 添加用户到黑名单

◆ deleteFromBlackList:succ:fail:()

- (void) deleteFromBlackList: (NSArray *)  userIDList
succ: (V2TIMFriendOperationResultListSucc succ
fail: (V2TIMFail)  fail 

4.2 把用户从黑名单中删除

◆ getBlackList:fail:()

- (void) getBlackList: (V2TIMFriendInfoListSucc succ
fail: (V2TIMFail)  fail 

4.3 获取黑名单列表

◆ createFriendGroup:userIDList:succ:fail:()

- (void) createFriendGroup: (NSString *)  groupName
userIDList: (NSArray *)  userIDList
succ: (V2TIMFriendOperationResultListSucc succ
fail: (V2TIMFail)  fail 

5.1 新建好友分组

参数
groupName分组名称
userIDList要添加到分组中的好友

◆ getFriendGroupList:succ:fail:()

- (void) getFriendGroupList: (NSArray *)  groupNameList
succ: (V2TIMFriendGroupListSucc succ
fail: (V2TIMFail)  fail 

5.2 获取分组信息

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

◆ deleteFriendGroup:succ:fail:()

- (void) deleteFriendGroup: (NSArray *)  groupNameList
succ: (V2TIMSucc)  succ
fail: (V2TIMFail)  fail 

5.3 删除好友分组

◆ renameFriendGroup:newName:succ:fail:()

- (void) renameFriendGroup: (NSString *)  oldName
newName: (NSString *)  newName
succ: (V2TIMSucc)  succ
fail: (V2TIMFail)  fail 

5.4 修改好友分组的名称

◆ addFriendsToFriendGroup:userIDList:succ:fail:()

- (void) addFriendsToFriendGroup: (NSString *)  groupName
userIDList: (NSArray *)  userIDList
succ: (V2TIMFriendOperationResultListSucc succ
fail: (V2TIMFail)  fail 

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

◆ deleteFriendsFromFriendGroup:userIDList:succ:fail:()

- (void) deleteFriendsFromFriendGroup: (NSString *)  groupName
userIDList: (NSArray *)  userIDList
succ: (V2TIMFriendOperationResultListSucc succ
fail: (V2TIMFail)  fail 

5.6 从好友分组中删除好友