• UIKit
  • SDK
  • 服务端 API
Chat/
SDK/
Android/
用户/
SDK
  • 集成 SDK
  • 初始化
  • 登录登出
  • 消息
    • 介绍
    • 发送消息
    • 接收消息
    • 历史消息
    • 转发消息
    • 消息变更
    • 插入消息
    • 删除消息
    • 清空消息
    • 撤回消息
    • 在线消息
    • 已读回执
    • 查询消息
    • 群 @ 消息
    • 群定向消息
    • 消息免打套
    • 消息扩展
    • 消息回应
    • 消息翻译
    • 消息置顶
  • 会话
    • 介绍
    • 会话列表
    • 获取会话
    • 会话未读数
    • 置顶会话
    • 删除会话
    • 会话草稿
    • 会话标记
    • 会话分组
  • 群组
    • 介绍
    • 管理群组
    • 群资料
    • 管理群成员
    • 群成员资料
    • 自定义属性
    • 群计数器
  • 社群话题
    • 管理社群
    • 权限组
  • 用户
    • 用户资料
    • 用户状态
    • 管理好友
    • 好友分组
    • 黑名单
    • 关注与粉丝
  • 本地搜索
    • 搜索消息
    • 搜索好友
    • 搜索群组
    • 搜索群成员
  • 信令
  • 客户端 API
    • Java
  • 开发指引
  • 控制台指南
    • 创建和升级应用
    • 基本配置
    • 功能配置
    • 账号管理
    • 群组管理
    • 回调配置
  • 产品介绍
    • 消息管理
      • 单聊消息
      • 消息存储
      • 离线推送
      • 群消息
      • 消息格式
    • 账号系统
      • 登陆验证
      • 在线状态管理
    • 群相关
      • 群组系统
      • 群组管理
    • 用户资料和关系链
      • 资料管理
      • 关系链管理
  • 购买指南
    • 计费概述
    • 价格中心
  • 错误码

关注与粉丝

功能描述

关注功能允许用户选择他们感兴趣的其他用户,以便及时获取这些用户最新的动态、发布或活动信息,系统可以根据用户的关注列表提供个性化的内容推荐。
粉丝功能是指用户被其他人关注的状态,当用户 A 关注用户 B 时,A 就成为了 B 的粉丝。用户可以在自己的个人资料页面上查看粉丝数量、粉丝列表或者粉丝的资料信息等。
通过关注和粉丝功能,社交应用和网站能够创建一个活跃的、相互连接的用户网络,促进信息的传播和社区的构建。
说明:
增强版 7.8 及以上版本支持。
此功能为进阶版功能,需要您购买 进阶版

功能演示



关注用户

您可以调用 followUser (Android / iOS & Mac / Windows) 接口来关注指定的用户。
示例代码如下:
Android
iOS & Mac
Windows
List<String> userIDList = Arrays.asList("useridA", "useridB");
V2TIMManager.getFriendshipManager().followUser(userIDList, new V2TIMValueCallback<List<V2TIMFollowOperationResult>>() {
@Override
public void onSuccess(List<V2TIMFollowOperationResult> followOperationResultList) {
// 关注用户操作成功
}

@Override
public void onError(int code, String desc) {
// 关注用户操作失败
}
});
NSArray *useridList = @[@"useridA", @"useridB"];
[[V2TIMManager sharedInstance] followUser:userIDList succ:^(NSArray<V2TIMFollowOperationResult *> *resultList) {
// 关注用户操作成功
} fail:^(int code, NSString *desc) {
// 关注用户操作失败
}];
template <class T>
class ValueCallback final : public V2TIMValueCallback<T> {
public:
using SuccessCallback = std::function<void(const T&)>;
using ErrorCallback = std::function<void(int, const V2TIMString&)>;

ValueCallback() = default;
~ValueCallback() override = default;

void SetCallback(SuccessCallback success_callback, ErrorCallback error_callback) {
success_callback_ = std::move(success_callback);
error_callback_ = std::move(error_callback);
}

void OnSuccess(const T& value) override {
if (success_callback_) {
success_callback_(value);
}
}
void OnError(int error_code, const V2TIMString& error_message) override {
if (error_callback_) {
error_callback_(error_code, error_message);
}
}

private:
SuccessCallback success_callback_;
ErrorCallback error_callback_;
};

V2TIMStringVector userIDList;
userIDList.PushBack(u8"useridA");
userIDList.PushBack(u8"useridB");

auto callback = new ValueCallback<V2TIMFollowOperationResultVector>{};
callback->SetCallback(
[=](const V2TIMFollowOperationResultVector& followOperationResultList) {
// 关注用户操作成功
delete callback;
},
[=](int error_code, const V2TIMString& error_message) {
// 关注用户操作失败
delete callback;
});

V2TIMManager::GetInstance()->GetFriendshipManager()->FollowUser(userIDList, callback);
说明:
该接口一次最多支持关注 20 个用户(除了自己之外,其他用户都可以关注)。
每个用户的关注用户数量上限为 5000 人,粉丝用户数量无上限。

取消关注用户

您可以调用 unfollowUser (Android / iOS & Mac / Windows) 接口来取消关注指定的用户。
示例代码如下:
Android
iOS & Mac
Windows
List<String> userIDList = Arrays.asList("useridA", "useridB");
V2TIMManager.getFriendshipManager().unfollowUser(userIDList, new V2TIMValueCallback<List<V2TIMFollowOperationResult>>() {
@Override
public void onSuccess(List<V2TIMFollowOperationResult> followOperationResultList) {
// 取消关注用户操作成功
}

@Override
public void onError(int code, String desc) {
// 取消关注用户操作失败
}
});
NSArray *useridList = @[@"useridA", @"useridB"];
[[V2TIMManager sharedInstance] unfollowUser:userIDList succ:^(NSArray<V2TIMFollowOperationResult *> *resultList) {
// 取消关注用户操作成功
} fail:^(int code, NSString *desc) {
// 取消关注用户操作失败
}];
template <class T>
class ValueCallback final : public V2TIMValueCallback<T> {
public:
using SuccessCallback = std::function<void(const T&)>;
using ErrorCallback = std::function<void(int, const V2TIMString&)>;

ValueCallback() = default;
~ValueCallback() override = default;

void SetCallback(SuccessCallback success_callback, ErrorCallback error_callback) {
success_callback_ = std::move(success_callback);
error_callback_ = std::move(error_callback);
}

void OnSuccess(const T& value) override {
if (success_callback_) {
success_callback_(value);
}
}
void OnError(int error_code, const V2TIMString& error_message) override {
if (error_callback_) {
error_callback_(error_code, error_message);
}
}

private:
SuccessCallback success_callback_;
ErrorCallback error_callback_;
};

V2TIMStringVector userIDList;
userIDList.PushBack(u8"useridA");
userIDList.PushBack(u8"useridB");

auto callback = new ValueCallback<V2TIMFollowOperationResultVector>{};
callback->SetCallback(
[=](const V2TIMFollowOperationResultVector& followOperationResultList) {
// 取消关注用户操作成功
delete callback;
},
[=](int error_code, const V2TIMString& error_message) {
// 取消关注用户操作失败
delete callback;
});

V2TIMManager::GetInstance()->GetFriendshipManager()->UnfollowUser(userIDList, callback);
说明:
一次最多支持取消关注 20 个用户。

获取我的关注用户列表

您可以调用getMyFollowingList (Android / iOS & Mac / Windows) 接口来拉取已经关注的用户列表。
示例代码如下:
Android
iOS & Mac
Windows
{
...
String nextCursor = "";
getMyFollowingList(nextCursor);
...
}

public void getMyFollowingList(String nextCursor) {
V2TIMManager.getFriendshipManager().getMyFollowingList(nextCursor, new V2TIMValueCallback<V2TIMUserInfoResult>() {
@Override
public void onSuccess(V2TIMUserInfoResult v2TIMUserInfoResult) {
StringBuilder stringBuilder = new StringBuilder();
if (v2TIMUserInfoResult.getNextCursor().length() > 0) {
// 继续分页拉取
getMyFollowingList(v2TIMUserInfoResult.getNextCursor());
...
} else {
// 拉取结束
}
}

@Override
public void onError(int code, String desc) {
// 拉取失败
}
});
}
- (void)getMyFollowingList:(NSString *)cursor {
[[V2TIMManager sharedInstance] getMyFollowingList:cursor succ:^(NSString *nextCursor, NSArray<V2TIMUserFullInfo *> *userInfoList) {
if (nextCursor.length > 0) {
// 继续分页拉取
[self getMyFollowingList:nextCursor];
//...
} else {
// 拉取结束
}
} fail:^(int code, NSString *desc) {
// 拉取失败
}];
}
template <class T>
class ValueCallback final : public V2TIMValueCallback<T> {
public:
using SuccessCallback = std::function<void(const T&)>;
using ErrorCallback = std::function<void(int, const V2TIMString&)>;

ValueCallback() = default;
~ValueCallback() override = default;

void SetCallback(SuccessCallback success_callback, ErrorCallback error_callback) {
success_callback_ = std::move(success_callback);
error_callback_ = std::move(error_callback);
}

void OnSuccess(const T& value) override {
if (success_callback_) {
success_callback_(value);
}
}
void OnError(int error_code, const V2TIMString& error_message) override {
if (error_callback_) {
error_callback_(error_code, error_message);
}
}

private:
SuccessCallback success_callback_;
ErrorCallback error_callback_;
};

V2TIMString nextCursor = u8"";

void GetMyFollowingList(const V2TIMString& nextCursor) {
auto callback = new ValueCallback<V2TIMUserInfoResult>{};
callback->SetCallback(
[=](const V2TIMUserInfoResult& userInfoResult) {
if (userInfoResult.nextCursor.Length() > 0) {
// 继续分页拉取
GetMyFollowingList(userInfoResult.nextCursor);
...
} else {
// 拉取结束
}

delete callback;
},
[=](int error_code, const V2TIMString& error_message) {
// 拉取失败
delete callback;
});

V2TIMManager::GetInstance()->GetFriendshipManager()->GetMyFollowingList(nextCursor, callback);
}
说明:
该接口每次最多返回 500 个用户。
首次拉取时,可以将接口的 nextCursor 参数填写为 "", 回调成功后如果返回的 nextCursor 不为 "",可以传入该值再次拉取,直至 nextCursor 返回为 "",表示全部拉取完成。

获取我的粉丝用户列表

您可以调用getMyFollowersList (Android / iOS & Mac / Windows) 接口来拉取自己的粉丝用户列表。
示例代码如下:
Android
iOS & Mac
Windows
{
...
String nextCursor = "";
getMyFollowersList(nextCursor);
...
}

public void getMyFollowersList(String nextCursor) {
V2TIMManager.getFriendshipManager().getMyFollowersList(nextCursor, new V2TIMValueCallback<V2TIMUserInfoResult>() {
@Override
public void onSuccess(V2TIMUserInfoResult v2TIMUserInfoResult) {
StringBuilder stringBuilder = new StringBuilder();
// 拉取成功
if (v2TIMUserInfoResult.getNextCursor().length() > 0) {
// 继续分页拉取
getMyFollowersList(v2TIMUserInfoResult.getNextCursor());
...
} else {
// 拉取结束
}
}

@Override
public void onError(int code, String desc) {
// 拉取失败
}
});
}
- (void)getMyFollowersList:(NSString *)cursor {
[[V2TIMManager sharedInstance] getMyFollowersList:cursor succ:^(NSString *nextCursor, NSArray<V2TIMUserFullInfo *> *userInfoList) {
if (nextCursor.length > 0) {
// 继续分页拉取
[self getMyFollowersList:nextCursor];
//...
} else {
// 拉取结束
}
} fail:^(int code, NSString *desc) {
// 拉取失败
}];
}
template <class T>
class ValueCallback final : public V2TIMValueCallback<T> {
public:
using SuccessCallback = std::function<void(const T&)>;
using ErrorCallback = std::function<void(int, const V2TIMString&)>;

ValueCallback() = default;
~ValueCallback() override = default;

void SetCallback(SuccessCallback success_callback, ErrorCallback error_callback) {
success_callback_ = std::move(success_callback);
error_callback_ = std::move(error_callback);
}

void OnSuccess(const T& value) override {
if (success_callback_) {
success_callback_(value);
}
}
void OnError(int error_code, const V2TIMString& error_message) override {
if (error_callback_) {
error_callback_(error_code, error_message);
}
}

private:
SuccessCallback success_callback_;
ErrorCallback error_callback_;
};

V2TIMString nextCursor = u8"";

void GetMyFollowersList(const V2TIMString& nextCursor) {
auto callback = new ValueCallback<V2TIMUserInfoResult>{};
callback->SetCallback(
[=](const V2TIMUserInfoResult& userInfoResult) {
// 拉取成功
if (userInfoResult.nextCursor.Length() > 0) {
// 继续分页拉取
GetMyFollowersList(userInfoResult.nextCursor);
...
} else {
// 拉取结束
}

delete callback;
},
[=](int error_code, const V2TIMString& error_message) {
// 拉取失败
delete callback;
});

V2TIMManager::GetInstance()->GetFriendshipManager()->GetMyFollowersList(nextCursor, callback);
}
说明:
该接口每次最多返回 500 个用户。
首次拉取时,可以将接口的 nextCursor 参数填写为 "", 回调成功后如果返回的 nextCursor 不为 "",可以传入该值再次拉取,直至 nextCursor 返回为 "",表示全部拉取完成。

获取与我互相关注的用户列表

您可以调用getMutualFollowersList (Android / iOS & Mac / Windows) 接口来拉取与自己互相关注的用户列表(互相关注的用户都可以在彼此的关注用户列表和粉丝用户列表中找到对方)。
示例代码如下:
Android
iOS & Mac
Windows
{
...
String nextCursor = "";
getMutualFollowersList(nextCursor);
...
}

public void getMutualFollowersList(String nextCursor) {
V2TIMManager.getFriendshipManager().getMutualFollowersList(nextCursor, new V2TIMValueCallback<V2TIMUserInfoResult>() {
@Override
public void onSuccess(V2TIMUserInfoResult v2TIMUserInfoResult) {
StringBuilder stringBuilder = new StringBuilder();
// 拉取成功
if (v2TIMUserInfoResult.getNextCursor().length() > 0) {
// 继续分页拉取
getMutualFollowersList(v2TIMUserInfoResult.getNextCursor());
...
} else {
// 拉取结束
}
}

@Override
public void onError(int code, String desc) {
// 拉取失败
}
});
}
- (void)getMutualFollowersList:(NSString *)cursor {
[[V2TIMManager sharedInstance] getMutualFollowersList:cursor succ:^(NSString *nextCursor, NSArray<V2TIMUserFullInfo *> *userInfoList) {
if (nextCursor.length > 0) {
// 继续分页拉取
[self getMutualFollowersList:nextCursor];
//...
} else {
// 拉取结束
}
} fail:^(int code, NSString *desc) {
// 拉取失败
}];
}
template <class T>
class ValueCallback final : public V2TIMValueCallback<T> {
public:
using SuccessCallback = std::function<void(const T&)>;
using ErrorCallback = std::function<void(int, const V2TIMString&)>;

ValueCallback() = default;
~ValueCallback() override = default;

void SetCallback(SuccessCallback success_callback, ErrorCallback error_callback) {
success_callback_ = std::move(success_callback);
error_callback_ = std::move(error_callback);
}

void OnSuccess(const T& value) override {
if (success_callback_) {
success_callback_(value);
}
}
void OnError(int error_code, const V2TIMString& error_message) override {
if (error_callback_) {
error_callback_(error_code, error_message);
}
}

private:
SuccessCallback success_callback_;
ErrorCallback error_callback_;
};

V2TIMString nextCursor = u8"";

void GetMutualFollowersList(const V2TIMString& nextCursor) {
auto callback = new ValueCallback<V2TIMUserInfoResult>{};
callback->SetCallback(
[=](const V2TIMUserInfoResult& userInfoResult) {
// 拉取成功
if (userInfoResult.nextCursor.Length() > 0) {
// 继续分页拉取
GetMutualFollowersList(userInfoResult.nextCursor);
...
} else {
// 拉取结束
}

delete callback;
},
[=](int error_code, const V2TIMString& error_message) {
// 拉取失败
delete callback;
});

V2TIMManager::GetInstance()->GetFriendshipManager()->GetMutualFollowersList(nextCursor, callback);
}
说明:
该接口每次最多返回 500 个用户。
首次拉取时,可以将接口的 nextCursor 参数填写为 "", 回调成功后如果返回的 nextCursor 不为 "",可以传入该值再次拉取,直至 nextCursor 返回为 "",表示全部拉取完成。

获取用户的关注/粉丝/互关用户数量

您可以调用 getUserFollowInfo (Android / iOS & Mac / Windows) 接口来获取指定用户的关注/粉丝/互关用户的数量信息 。
在回调信息中,您可以从 V2TIMFollowInfo (Android / iOS & Mac / Windows) 的 followingCountfollowersCountmutualFollowersCount 来获取指定用户的关注、粉丝和互关用户数量。
示例代码如下:
Android
iOS & Mac
Windows
List<String> userIDList = Arrays.asList("useridA", "useridB");
V2TIMManager.getFriendshipManager().getUserFollowInfo(userIDList, new V2TIMValueCallback<List<V2TIMFollowInfo>>() {
@Override
public void onSuccess(List<V2TIMFollowInfo> followInfoList) {
// 获取成功
for (V2TIMFollowInfo followInfo : V2TIMFollowInfoList) {
if (followInfo.getResultCode() == 0) {
// 此处可以获取到用户 followInfo.getUserID() 对应的关注/粉丝/互关用户的数量信息
// 也即 followInfo.getFollowingCount(), followInfo.getFollowersCount() 和 followInfo.getMutualFollowersCount()
}
}
}

@Override
public void onError(int code, String desc) {
// 获取失败
}
});
NSArray *useridList = @[@"useridA", @"useridB"];
[[V2TIMManager sharedInstance] getUserFollowInfo:userIDList succ:^(NSArray<V2TIMFollowInfo *> *resultList) {
// 获取成功
for (V2TIMFollowInfo *result in resultList) {
if (result.resultCode == 0) {
// 此处可以获取到用户 result.userID 对应的关注/粉丝/互关用户的数量信息
// 也即 result.followingCount, result.followersCount 以及 result.mutualFollowersCount 信息
}
}
} fail:^(int code, NSString *desc) {
// 获取失败
}];
template <class T>
class ValueCallback final : public V2TIMValueCallback<T> {
public:
using SuccessCallback = std::function<void(const T&)>;
using ErrorCallback = std::function<void(int, const V2TIMString&)>;

ValueCallback() = default;
~ValueCallback() override = default;

void SetCallback(SuccessCallback success_callback, ErrorCallback error_callback) {
success_callback_ = std::move(success_callback);
error_callback_ = std::move(error_callback);
}

void OnSuccess(const T& value) override {
if (success_callback_) {
success_callback_(value);
}
}
void OnError(int error_code, const V2TIMString& error_message) override {
if (error_callback_) {
error_callback_(error_code, error_message);
}
}

private:
SuccessCallback success_callback_;
ErrorCallback error_callback_;
};

V2TIMStringVector userIDList;
userIDList.PushBack(u8"useridA");
userIDList.PushBack(u8"useridB");

auto callback = new ValueCallback<V2TIMFollowInfoVector>{};
callback->SetCallback(
[=](const V2TIMFollowInfoVector& followInfoList) {
// 获取成功
for (size_t i = 0; i < followInfoList.Size(); ++i) {
if (followInfoList[i].resultCode == 0) {
// 此处可以获取到用户 followInfoList[i].userID 对应的关注/粉丝/互关用户的数量信息
// 也即 followInfoList[i].followingCount, followInfoList[i].followersCount 和 followInfoList[i].mutualFollowersCount
}
}

delete callback;
},
[=](int error_code, const V2TIMString& error_message) {
// 获取失败
delete callback;
});

V2TIMManager::GetInstance()->GetFriendshipManager()->GetUserFollowInfo(userIDList, callback);

检查关注关系

您可以调用 checkFollowType (Android / iOS & Mac / Windows) 接口用来检查自己与指定用户的关注关系。
在回调信息中,您可以通过 V2TIMFollowTypeCheckResult (Android / iOS & Mac / Windows) 的 followType 字段来获取自己与该用户的关系:
V2TIMFollowTypeCheckResult.followType
与自己的关系

V2TIM_FOLLOW_TYPE_NONE

无任何关系

V2TIM_FOLLOW_TYPE_IN_MY_FOLLOWING_LIST

对方仅在我的关注列表中

V2TIM_FOLLOW_TYPE_IN_MY_FOLLOWERS_LIST

对方仅在我的粉丝列表中

V2TIM_FOLLOW_TYPE_IN_BOTH_FOLLOWERS_LIST

对方与我互相关注(对方既在我的关注列表,也在我的粉丝列表)
示例代码如下:
Android
iOS & Mac
Windows
List<String> userIDList = Arrays.asList("useridA", "useridB");
V2TIMManager.getFriendshipManager().checkFollowType(userIDList, new V2TIMValueCallback<List<V2TIMFollowTypeCheckResult>>() {
@Override
public void onSuccess(List<V2TIMFollowTypeCheckResult> followTypeCheckResultList) {
// 检查关注关系成功
for (V2TIMFollowTypeCheckResult followTypeCheckResult : followTypeCheckResultList) {
if (followTypeCheckResult.getResultCode() == 0) {
// 此处可以获取到自己与用户 followTypeCheckResult.getUserID() 的关系 followTypeCheckResult.getFollowType()
}
}
}

@Override
public void onError(int code, String desc) {
// 检查关注关系失败
}
});
NSArray *useridList = @[@"useridA", @"useridB"];
[[V2TIMManager sharedInstance] checkFollowType:userIDList succ:^(NSArray<V2TIMFollowTypeCheckResultListSucc *> *resultList) {
// 检查关注关系成功
for (V2TIMFollowTypeCheckResult *result in resultList) {
if (result.resultCode == 0) {
// 此处可以获取到自己与用户 result.userID 的关系 result.followType
}
}
} fail:^(int code, NSString *desc) {
// 检查关注关系失败
}];
template <class T>
class ValueCallback final : public V2TIMValueCallback<T> {
public:
using SuccessCallback = std::function<void(const T&)>;
using ErrorCallback = std::function<void(int, const V2TIMString&)>;

ValueCallback() = default;
~ValueCallback() override = default;

void SetCallback(SuccessCallback success_callback, ErrorCallback error_callback) {
success_callback_ = std::move(success_callback);
error_callback_ = std::move(error_callback);
}

void OnSuccess(const T& value) override {
if (success_callback_) {
success_callback_(value);
}
}
void OnError(int error_code, const V2TIMString& error_message) override {
if (error_callback_) {
error_callback_(error_code, error_message);
}
}

private:
SuccessCallback success_callback_;
ErrorCallback error_callback_;
};

V2TIMStringVector userIDList;
userIDList.PushBack(u8"useridA");
userIDList.PushBack(u8"useridB");

auto callback = new ValueCallback<V2TIMFollowTypeCheckResultVector>{};
callback->SetCallback(
[=](const V2TIMFollowTypeCheckResultVector& followTypeCheckResultList) {
// 检查关注关系成功
for (size_t i = 0; i < followTypeCheckResultList.Size(); ++i) {
if (followTypeCheckResultList[i].resultCode == 0) {
// 此处可以获取到自己与用户 followTypeCheckResultList[i].userID 的关系 followTypeCheckResultList[i].followType
}
}

delete callback;
},
[=](int error_code, const V2TIMString& error_message) {
// 检查关注关系失败
delete callback;
});

V2TIMManager::GetInstance()->GetFriendshipManager()->FollowUser(userIDList, callback);
说明:
该接口限频为每 5s 内最多调用 20 次,且每次最多支持传入 100 个用户 。

关注/粉丝/互关列表变更通知

具体的列表变更通知如下:
列表变更通知
说明
关注列表变更通知
onMyFollowingListChanged
(Android / iOS & Mac / Windows)
当通知中的isAddtrue 时,表示列表新增用户的通知,此时会返回完整的用户资料
当通知中的isAddfalse 时,表示列表删除用户的通知,此时返回的用户资料中仅有用户 ID
粉丝列表变更通知
onMyFollowersListChanged
(Android / iOS & Mac / Windows)
互关列表变更通知
onMutualFollowersListChanged
(Android / iOS & Mac / Windows)
说明:
您需要预先调用 addFriendListener (Android / iOS & Mac / Windows) 添加关系链事件监听器,之后才能收到上述相关事件的通知。

列表新增用户通知的场景示例

假设有两个没有任何关系用户 AliceBob,这两个用户相互关注过程中,相关列表变更通知和关系变更如下:
事件
Alice
Bob
收到的通知
Bob 的关系
收到的通知
Alice 的关系
Alice 关注 Bob
关注
粉丝
Bob 关注 Alice

列表删除用户通知的场景示例

假设有两个已经互相关注的用户 AliceBob, 这两个用户相互取消关注过程中,相关列表变更通知和关系变更如下:
事件
Alice
Bob
收到的通知
Bob 的关系
收到的通知
Alice 的关系
Alice 取消关注 Bob
粉丝
关注
Bob 取消关注 Alice
示例代码如下:
Android
iOS & Mac
Windows
V2TIMFriendshipListener v2TIMFriendshipListener = new V2TIMFriendshipListener() {
@Override
public void onMyFollowingListChanged(List<V2TIMUserFullInfo> userInfoList, boolean isAdd) {
if (isAdd) {
// 关注列表新增用户的通知
} else {
// 关注列表删除用户的通知
}
}

@Override
public void onMyFollowersListChanged(List<V2TIMUserFullInfo> userInfoList, boolean isAdd) {
if (isAdd) {
// 粉丝列表新增用户的通知
} else {
// 粉丝列表删除用户的通知
}
}

@Override
public void onMutualFollowersListChanged(List<V2TIMUserFullInfo> userInfoList, boolean isAdd) {
if (isAdd) {
// 互关列表新增用户的通知
} else {
// 互关列表删除用户的通知
}
}
};

// 添加关系链监听器
V2TIMManager.getFriendshipManager().addFriendListener(v2TIMFriendshipListener);
// 添加关系链监听器
[[V2TIMManager sharedInstance] addFriendListener:self];

- (void)onMyFollowingListChanged:(NSArray<V2TIMUserFullInfo *> *)userInfoList isAdd:(BOOL)isAdd {
if (isAdd) {
// 关注列表新增用户的通知
} else {
// 关注列表删除用户的通知
}
}
- (void)onMyFollowersListChanged:(NSArray<V2TIMUserFullInfo *> *)userInfoList isAdd:(BOOL)isAdd {
if (isAdd) {
// 粉丝列表新增用户的通知
} else {
// 粉丝列表删除用户的通知
}
}
- (void)onMutualFollowersListChanged:(NSArray<V2TIMUserFullInfo *> *)userInfoList isAdd:(BOOL)isAdd {
if (isAdd) {
// 互关列表新增用户的通知
} else {
// 互关列表删除用户的通知
}
}
class FriendshipListener final : public V2TIMFriendshipListener {
public:
FriendshipListener() = default;
~FriendshipListener() override = default;

void OnMyFollowingListChanged(const V2TIMUserFullInfoVector &userInfoList, bool isAdd) override {
if (isAdd) {
// 关注列表新增用户的通知
} else {
// 关注列表删除用户的通知
}
}

void OnMyFollowersListChanged(const V2TIMUserFullInfoVector &userInfoList, bool isAdd) override {
if (isAdd) {
// 粉丝列表新增用户的通知
} else {
// 粉丝列表删除用户的通知
}
}

void OnMutualFollowersListChanged(const V2TIMUserFullInfoVector &userInfoList, bool isAdd) override {
if (isAdd) {
// 互关列表新增用户的通知
} else {
// 互关列表删除用户的通知
}
}

// 其他成员函数 ...
};

// 添加关系链事件监听器,注意在移除监听器之前需要保持 friendshipListener 的生命期,以免接收不到事件回调
FriendshipListener friendshipListener;
V2TIMManager::GetInstance()->GetFriendshipManager()->AddFriendListener(&friendshipListener);