NIMUserManager Protocol Reference

Conforms to NSObject
Declared in NIMUserManagerProtocol.h

Overview

好友协议

– requestFriend:completion: required method

添加好友

- (void)requestFriend:(NIMUserRequest *)request completion:(nullable NIMUserBlock)completion

Parameters

request

添加好友请求
completion

完成回调

Discussion

添加好友

Declared In

NIMUserManagerProtocol.h

– deleteFriend:completion: required method

删除好友

- (void)deleteFriend:(NSString *)userId completion:(nullable NIMUserBlock)completion

Parameters

userId

好友Id
completion

完成回调

Discussion

删除好友

不删除备注等信息

Declared In

NIMUserManagerProtocol.h

– deleteFriend:removeAlias:completion: required method

删除好友

- (void)deleteFriend:(NSString *)userId removeAlias:(BOOL)remove completion:(nullable NIMUserBlock)completion

Parameters

userId

好友Id
remove

是否同时删除备注
completion

完成回调

Discussion

删除好友

Declared In

NIMUserManagerProtocol.h

– myFriends required method

返回我的好友列表

- (nullable NSArray<NIMUser*> *)myFriends

Return Value

NIMUser列表

Discussion

返回我的好友列表

Declared In

NIMUserManagerProtocol.h

– isMyFriend: required method

判断是否是我的好友

- (BOOL)isMyFriend:(NSString *)userId

Parameters

userId

用户Id

Return Value

是否是我的好友 (云信关系)

Discussion

判断是否是我的好友

Declared In

NIMUserManagerProtocol.h

– addToBlackList:completion: required method

添加用户到黑名单

- (void)addToBlackList:(NSString *)userId completion:(NIMUserBlock)completion

Parameters

userId

用户Id
completion

完成回调

Discussion

添加用户到黑名单

Declared In

NIMUserManagerProtocol.h

– removeFromBlackBlackList:completion: required method

将用户从黑名单移除

- (void)removeFromBlackBlackList:(NSString *)userId completion:(NIMUserBlock)completion

Parameters

userId

用户Id
completion

完成回调

Discussion

将用户从黑名单移除

Declared In

NIMUserManagerProtocol.h

– isUserInBlackList: required method

判断用户是否已被拉黑

- (BOOL)isUserInBlackList:(NSString *)userId

Parameters

userId

用户Id

Return Value

是否已被拉黑

Discussion

判断用户是否已被拉黑

Declared In

NIMUserManagerProtocol.h

– myBlackList required method

返回所有在黑名单中的用户列表

- (nullable NSArray<NIMUser*> *)myBlackList

Return Value

黑名单成员NIMUser列表

Discussion

返回所有在黑名单中的用户列表

Declared In

NIMUserManagerProtocol.h

– updateNotifyState:forUser:completion: required method

设置消息提醒

- (void)updateNotifyState:(BOOL)notify forUser:(NSString *)userId completion:(nullable NIMUserBlock)completion

Parameters

notify

是否提醒
userId

用户Id
completion

完成回调

Discussion

设置消息提醒

Declared In

NIMUserManagerProtocol.h

– notifyForNewMsg: required method

是否需要消息通知

- (BOOL)notifyForNewMsg:(NSString *)userId

Parameters

userId

用户Id

Return Value

是否需要消息通知

Discussion

是否需要消息通知

Declared In

NIMUserManagerProtocol.h

– myMuteUserList required method

静音列表

- (nullable NSArray<NIMUser*> *)myMuteUserList

Return Value

返回被我设置为取消消息通知的NIMUser列表

Discussion

静音列表

Declared In

NIMUserManagerProtocol.h

– fetchUserInfos:completion: required method

从云信服务器批量获取用户资料

- (void)fetchUserInfos:(NSArray<NSString*> *)users completion:(nullable NIMUserInfoBlock)completion

Parameters

users

用户id列表
completion

用户信息回调

Discussion

从云信服务器批量获取用户资料

需要将用户信息交给云信托管，此接口才有效。调用此接口，不会触发 - (void)onUserInfoChanged: 回调。 该接口会将获取到的用户信息缓存在本地，所以需要避免此接口的滥调，导致存储过多无用数据到本地而撑爆缓存:如在聊天室请求请求每个聊天室用户数据将造成缓存过大而影响程序性能 本接口一次最多支持 150 个用户信息获取

Declared In

NIMUserManagerProtocol.h

– userInfo: required method

从本地获取用户资料

- (nullable NIMUser *)userInfo:(NSString *)userId

Parameters

userId

用户id

Return Value

NIMUser

Discussion

从本地获取用户资料

需要将用户信息交给云信托管，且数据已经正常缓存到本地，此接口才有效。 用户资料除自己之外，不保证其他用户资料实时更新 其他用户资料更新的时机为: 1.调用 - (void)fetchUserInfos:completion: 方法刷新用户 2.收到此用户发来消息 3.程序再次启动，此时会同步部分好友信息

Declared In

NIMUserManagerProtocol.h

– updateUser:completion: required method

修改自己与目标用户的关系

- (void)updateUser:(NIMUser *)user completion:(nullable NIMUserBlock)completion

Parameters

user

目标用户
completion

修改结果回调

Discussion

修改自己与目标用户的关系

这个接口提供了备注名的修改以及一些扩展。这些值是基于当前用户和目标用户关系的， 同一个目标用户的的属性字段会随着登录用户的改变而改变。

Declared In

NIMUserManagerProtocol.h

– updateMyUserInfo:completion: required method

修改自己的用户资料

- (void)updateMyUserInfo:(NSDictionary<NSNumber*,id> *)values completion:(nullable NIMUserBlock)completion

Parameters

values

需要更新的用户信息键值对
completion

修改结果回调

Discussion

修改自己的用户资料

这个接口可以一次性修改多个属性,如昵称,头像等,传入的数据键值对是 {@(NIMUserInfoUpdateTag) : NSString/NSNumber}, 无效数据将被过滤。一些字段有修改限制，具体请参看 NIMUserInfoUpdateTag 的相关说明

Declared In

NIMUserManagerProtocol.h

– searchUserWithOption:completion: required method

查找成员

- (void)searchUserWithOption:(NIMUserSearchOption *)option completion:(nullable NIMUserInfoBlock)completion

Parameters

option

查询条件
completion

完成回调

Discussion

查找成员

Declared In

NIMUserManagerProtocol.h

– addDelegate: required method

添加好友委托

- (void)addDelegate:(id<NIMUserManagerDelegate>)delegate

Parameters

delegate

好友委托

Discussion

添加好友委托

Declared In

NIMUserManagerProtocol.h

– removeDelegate: required method

移除好友委托

- (void)removeDelegate:(id<NIMUserManagerDelegate>)delegate

Parameters

delegate

好友委托

Discussion

移除好友委托

Declared In

NIMUserManagerProtocol.h