云服务器特惠 99/年起
  1. 腾讯云优惠网首页
  2. 腾讯云产品

即时通信 IM Android&iOS&Windows&Mac（好友分组）

• 腾讯云产品

在某些场景下，可以能需要对好友进行分组，例如分为 “大学同学”、”公司同事” 等，可以以调用以下接口实现。

相关产品
即时通信 IM 产品页，含版本规格、价格与购买入口。

一、新建好友分组

你可以调用 createFriendGroup (Java / Swift / Objective-C / C++) 接口新建好友分组。

示例代码如下：

JavaSwiftObjective-CC++List<String> userIDList = new ArrayList<>();userIDList.add("user1");userIDList.add("user2");V2TIMManager.getFriendshipManager().createFriendGroup("大学好友", userIDList, new V2TIMValueCallback<List<V2TIMFriendOperationResult>>() { @Override public void onSuccess(List<V2TIMFriendOperationResult> v2TIMFriendOperationResults) { // 创建好友分组成功 } @Override public void onError(int code, String desc) { // 创建好友分组失败 }});V2TIMManager.shared.createFriendGroup(groupName: "大学好友", userIDList: ["userID1", "userID2"]) { resultList in resultList.forEach { item in // V2TIMFriendOperationResult print( item.description) }} fail: { code, desc in print( "createFriendGroup fail, \\(code), \\(desc)")}// 创建好友分组[[V2TIMManager sharedInstance] createFriendGroup:@"大学好友" userIDList:@[@"user1", @"user2"] succ:^(NSArray<V2TIMFriendOperationResult *> *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_;};V2TIMString groupName = u8"大学好友";V2TIMStringVector userIDList;userIDList.PushBack(u8"user1");userIDList.PushBack(u8"user2");auto callback = new ValueCallback<V2TIMFriendOperationResultVector>{};callback->SetCallback( [=](const V2TIMFriendOperationResultVector& friendOperationResultList) { // 创建好友分组成功 delete callback; }, [=](int error_code, const V2TIMString& error_message) { // 创建好友分组失败 delete callback; });V2TIMManager::GetInstance()->GetFriendshipManager()->CreateFriendGroup(groupName, userIDList, callback);

二、删除好友分组

你可以调用 deleteFriendGroup (Java / Swift / Objective-C / C++) 接口删除好友分组。删除好友分组不会删除好友关系。

示例代码如下：

JavaSwiftObjective-CC++List<String> friendGroupList = new ArrayList<>();friendGroupList.add("大学好友");V2TIMManager.getFriendshipManager().deleteFriendGroup(friendGroupList, new V2TIMCallback() { @Override public void onSuccess() { // 删除好友分组成功 } @Override public void onError(int code, String desc) { // 删除好友分组失败 }});// 删除好友分组V2TIMManager.shared.deleteFriendGroup(groupNameList: ["大学好友"]) { print( "deleteFriendGroup succ")} fail: { code, desc in print( "deleteFriendGroup fail, \\(code), \\(desc)")}// 删除好友分组[[V2TIMManager sharedInstance] deleteFriendGroup:@[@"大学好友"] succ:^{ // 删除好友分组成功} fail:^(int code, NSString *desc) { // 删除好友分组失败}];class Callback final : public V2TIMCallback {public: using SuccessCallback = std::function<void()>; using ErrorCallback = std::function<void(int, const V2TIMString&)>; Callback() = default; ~Callback() override = default; void SetCallback(SuccessCallback success_callback, ErrorCallback error_callback) { success_callback_ = std::move(success_callback); error_callback_ = std::move(error_callback); } void OnSuccess() override { if (success_callback_) { success_callback_(); } } 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 groupNameList;groupNameList.PushBack(u8"大学好友");auto callback = new Callback{};callback->SetCallback( [=]() { // 删除好友分组成功 delete callback; }, [=](int error_code, const V2TIMString& error_message) { // 删除好友分组失败 delete callback; });V2TIMManager::GetInstance()->GetFriendshipManager()->DeleteFriendGroup(groupNameList, callback);

三、重命名好友分组

你可以调用 renameFriendGroup (Java / Swift / Objective-C / C++) 接口重命名好友分组。

示例代码如下：

JavaSwiftObjective-CC++V2TIMManager.getFriendshipManager().renameFriendGroup("大学好友", "中学好友", new V2TIMCallback() { @Override public void onSuccess() { // 修改好友分组成功 } @Override public void onError(int code, String desc) { // 修改好友分组失败 }});// 修改好友分组V2TIMManager.shared.renameFriendGroup(oldName: "大学好友", newName: "中学好友") { print( "renameFriendGroup succ")} fail: { code, desc in print( "renameFriendGroup fail, \\(code), \\(desc)")}// 修改好友分组[[V2TIMManager sharedInstance] renameFriendGroup:@"大学好友" newName:@"中学好友" succ:^{ // 修改好友分组成功} fail:^(int code, NSString *desc) { // 修改好友分组失败}];class Callback final : public V2TIMCallback {public: using SuccessCallback = std::function<void()>; using ErrorCallback = std::function<void(int, const V2TIMString&)>; Callback() = default; ~Callback() override = default; void SetCallback(SuccessCallback success_callback, ErrorCallback error_callback) { success_callback_ = std::move(success_callback); error_callback_ = std::move(error_callback); } void OnSuccess() override { if (success_callback_) { success_callback_(); } } 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 oldName = u8"大学好友";V2TIMString newName = u8"中学好友";auto callback = new Callback{};callback->SetCallback( [=]() { // 修改好友分组成功 delete callback; }, [=](int error_code, const V2TIMString& error_message) { // 修改好友分组失败 delete callback; });V2TIMManager::GetInstance()->GetFriendshipManager()->RenameFriendGroup(oldName, newName, callback);

四、获取好友分组

你可以调用 getFriendGroupList (Java / Swift / Objective-C / C++) 接口获取好友分组列表。

示例代码如下：

JavaSwiftObjective-CC++List<String> friendGroups = new ArrayList<>();friendGroups.add("大学好友");V2TIMManager.getFriendshipManager().getFriendGroups(friendGroups, new V2TIMValueCallback<List<V2TIMFriendGroup>>() { @Override public void onSuccess(List<V2TIMFriendGroup> v2TIMFriendGroups) { // 获取好友分组成功 } @Override public void onError(int code, String desc) { // 获取好友分组失败 }});// 获取好友分组V2TIMManager.shared.getFriendGroupList(groupNameList: ["大学好友"]) { groups in groups.forEach { item in // V2TIMFriendGroup print( item.description) }} fail: { code, desc in print( "getFriendGroupList fail, \\(code), \\(desc)")}// 获取好友分组[[V2TIMManager sharedInstance] getFriendGroupList:@[@"大学好友"] succ:^(NSArray<V2TIMFriendGroup *> *groups) { // 获取好友分组成功} 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 groupNameList;groupNameList.PushBack(u8"大学好友");auto callback = new ValueCallback<V2TIMFriendGroupVector>{};callback->SetCallback( [=](const V2TIMFriendGroupVector& friendGroupList) { // 获取好友分组成功 delete callback; }, [=](int error_code, const V2TIMString& error_message) { // 获取好友分组失败 delete callback; });V2TIMManager::GetInstance()->GetFriendshipManager()->GetFriendGroups(groupNameList, callback);

五、添加好友到一个分组

你可以调用 addFriendsToFriendGroup (Java / Swift / Objective-C / C++) 接口添加好友到一个分组。

示例代码如下：

JavaSwiftObjective-CC++List<String> userIDList = new ArrayList<>();userIDList.add("user1");userIDList.add("user2");V2TIMManager.getFriendshipManager().addFriendsToFriendGroup("大学好友", userIDList, new V2TIMValueCallback<List<V2TIMFriendOperationResult>>() { @Override public void onSuccess(List<V2TIMFriendOperationResult> v2TIMFriendOperationResults) { // 添加成功 } @Override public void onError(int code, String desc) { // 添加失败 }});V2TIMManager.shared.addFriendsToFriendGroup(groupName: "大学好友", userIDList: ["user1","user2"]) { resultList in resultList.forEach { item in // V2TIMFriendOperationResult print( item.description) } print( "addFriendsToFriendGroup succ")} fail: { code, desc in print( "addFriendsToFriendGroup fail, \\(code), \\(desc)")}// 添加好友到一个分组[[V2TIMManager sharedInstance] addFriendsToFriendGroup:@"大学好友" userIDList:@[@"user1", @"user2"] succ:^(NSArray<V2TIMFriendOperationResult *> *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_;};V2TIMString groupName = u8"大学好友";V2TIMStringVector userIDList;userIDList.PushBack(u8"user1");userIDList.PushBack(u8"user2");auto callback = new ValueCallback<V2TIMFriendOperationResultVector>{};callback->SetCallback( [=](const V2TIMFriendOperationResultVector& friendOperationResultList) { // 添加成功 delete callback; }, [=](int error_code, const V2TIMString& error_message) { // 添加失败 delete callback; });V2TIMManager::GetInstance()->GetFriendshipManager()->AddFriendsToFriendGroup(groupName, userIDList, callback);

六、从分组中删除某好友

你可以调用 deleteFriendsFromFriendGroup (Java / Swift / Objective-C / C++) 从分组中删除某好友。从该分组中删除好友，只会将好友移出分组，不会删除好友关系。

示例代码如下：

JavaSwiftObjective-CC++List<String> userIDList = new ArrayList<>();userIDList.add("user1");userIDList.add("user2");V2TIMManager.getFriendshipManager().deleteFriendsFromFriendGroup("大学好友", userIDList, new V2TIMValueCallback<List<V2TIMFriendOperationResult>>() { @Override public void onSuccess(List<V2TIMFriendOperationResult> v2TIMFriendOperationResults) { // 删除成功 } @Override public void onError(int code, String desc) { // 删除失败 }});V2TIMManager.shared.deleteFriendsFromFriendGroup(groupName: "大学好友", userIDList: ["user1","user2"]) { resultList in resultList.forEach { item in // V2TIMFriendOperationResult print( item.description) } print( "addFriendsToFriendGroup succ")} fail: { code, desc in print( "addFriendsToFriendGroup fail, \\(code), \\(desc)")}// 从分组中删除某好友[[V2TIMManager sharedInstance] deleteFriendsFromFriendGroup:@"大学好友" userIDList:@[@"user1", @"user2"] succ:^(NSArray<V2TIMFriendOperationResult *> *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_;};V2TIMString groupName = u8"大学好友";V2TIMStringVector userIDList;userIDList.PushBack(u8"user1");userIDList.PushBack(u8"user2");auto callback = new ValueCallback<V2TIMFriendOperationResultVector>{};callback->SetCallback( [=](const V2TIMFriendOperationResultVector& friendOperationResultList) { // 删除成功 delete callback; }, [=](int error_code, const V2TIMString& error_message) { // 删除失败 delete callback; });V2TIMManager::GetInstance()->GetFriendshipManager()->DeleteFriendsFromFriendGroup(groupName, userIDList, callback);

七、监听好友分组变更通知

你可以通过 addFriendListener (Java / Swift / Objective-C / C++) 接口来监听好友分组变更的通知。

示例代码如下：

JavaSwiftObjective-CC++V2TIMFriendshipListener v2TIMFriendshipListener = new V2TIMFriendshipListener() { @Override public void onFriendGroupCreated(String groupName, List<V2TIMFriendInfo> friendInfoList) { // 收到好友分组被创建通知 } @Override public void onFriendGroupDeleted(List<String> groupNameList) { // 收到好友分组被删除通知 } @Override public void onFriendGroupNameChanged(String oldGroupName, String newGroupName) { // 收到好友分组重命名通知 } @Override public void onFriendsAddedToGroup(String groupName, List<V2TIMFriendInfo> friendInfoList) { // 收到向好友分组添加好友通知 } @Override public void onFriendsDeletedFromGroup(String groupName, List<String> friendIDList) { // 收到从好友分组中删除好友通知 }};// 添加关系链监听器V2TIMManager.getFriendshipManager().addFriendListener(v2TIMFriendshipListener);// 添加关系链监听器V2TIMManager.shared.addFriendListener(listener: self)func onFriendGroupCreated(groupName: String, friendInfoList: Array<V2TIMFriendInfo>) { print( "groupName: \\(groupName)|friendInfoList: \\(friendInfoList)")}func onFriendGroupDeleted(groupNameList: Array<String>) { print( groupNameList)}func onFriendGroupNameChanged(oldGroupName: String, newGroupName: String) { print( "oldGroupName: \\(oldGroupName)|newGroupName: \\(newGroupName)")}func onFriendsAddedToGroup(groupName: String, friendInfoList: Array<V2TIMFriendInfo>) { print( "groupName: \\(groupName)|friendInfoList: \\(friendInfoList)")}// 添加关系链监听器[[V2TIMManager sharedInstance] addFriendListener:self];- (void)onFriendGroupCreated:(NSString *)groupName friendInfoList:(NSArray<V2TIMFriendInfo *> *)friendInfoList { // 到好友分组被创建通知}- (void)onFriendGroupDeleted:(NSArray<NSString *> *)groupNameList { // 收到好友分组被删除通知}- (void)onFriendGroupNameChanged:(NSString *)oldGroupName newGroupName:(NSString *)newGroupName { // 收到好友分组重命名通知}- (void)onFriendsAddedToGroup:(NSString *)groupName friendInfoList:(NSArray<V2TIMFriendInfo *> *)friendInfoList { // 收到向好友分组添加好友通知}- (void)onFriendsDeletedFromGroup:(NSString *)groupName friendIDList:(NSArray<NSString *> *)friendIDList { // 收到从好友分组中删除好友通知}class FriendshipListener final : public V2TIMFriendshipListener {public: FriendshipListener() = default; ~FriendshipListener() override = default; void OnFriendGroupCreated(const V2TIMString &groupName, const V2TIMFriendInfoVector &friendInfoList) override { // 收到好友分组被创建通知 } void OnFriendGroupDeleted(const V2TIMStringVector &groupNameList) override { // 收到好友分组被删除通知 } void OnFriendGroupNameChanged(const V2TIMString &oldGroupName, const V2TIMString &newGroupName) override { // 收到好友分组重命名通知 } void OnFriendsAddedToGroup(const V2TIMString &groupName, const V2TIMFriendInfoVector &friendInfoList) override { // 收到向好友分组添加好友通知 } void OnFriendsDeletedFromGroup(const V2TIMString &groupName, const V2TIMStringVector &friendIDList) override { // 收到从好友分组中删除好友通知 } // 其他成员函数 …};// 添加关系链事件监听器，注意在移除监听器之前需要保持 friendshipListener 的生命期，以免接收不到事件回调FriendshipListener friendshipListener;V2TIMManager::GetInstance()->GetFriendshipManager()->AddFriendListener(&friendshipListener);

注意：说明：

注意：好友分组变更通知从 8.0 及以上版本支持。

相关内容：

  1. 即时通信 IM Android&iOS&Windows&Mac（清空消息） 清空消息分为两种：清空单聊消息、清空群聊消息。 清空消息会同时清空当前会话内所有的消息，包含本地和云端消息，但不会删除会话本身。清空消息后，会话的 lastMessage 会变为空，那么。...
  2. 即时通信 IM Android&iOS&Windows&Mac（获取会话） IM SDK 提供获取会话的接口，可以获取指定的单个、多个会话的 V2TIMConversation 对象信息。...
  3. 即时通信 IM Android&iOS&Windows&Mac（查询消息） 可以以先从 V2TIMMessage 消息对象中获取到 messageID，然后调用 findMessages 接口，根据 messageID 查询本地消息详情，包括状态 status 为 V2TIM_MSG_STATUS_LOCAL_REVOKED（已撤回）和 V2TIM_MSG_STATUS_HAS_DELETED（已删除）的消息。...
  4. 即时通信 IM Android&iOS&Windows&Mac（黑名单） 这篇说说了腾讯云即时通信（IM）服务中的黑名单功能，包括如何将用户加入黑名单、解除黑名单以及获取黑名单列表的操作方法和相关配置。文章详细描述了不同编程语言的接口调用示例，并解释了相关配置项的作用。拉黑某人: 用户可以通过调用 addToBlackList 接口将某用户加入黑名单，拉黑后会触发 onBlackListAdded 回调。如果用户之间存在好友关系，拉黑后默认会解除双向好友关系。解除拉黑: 用户可以通过调用 。...
  5. 即时通信 IM Android&iOS&Windows&Mac（插入消息） 插入消息只会将消息插入本地数据库，不会发送到服务端。该接口主要用于满足向聊天会话中插入一些提示性消息的需求，例如 “你已经退出该群”、“请注意信息安全，不要在群聊中发送任何账号、密码和验证码等私密信息”等。这类消息有展示在聊天消息区的需求，但并没有发送给其他人的必要。...
  6. 即时通信 IM Android&iOS&Windows&Mac（会话草稿） 在发送消息时，可能会遇到消息尚未编辑完，就要切换至其它聊天窗口的情况。这些未编辑完的消息可通过 setConversationDraft 接口保存，以便于下次回到这个聊天界面时，通过 V2TIMConversation 对象的 draftText 字段，获取到尚未编辑完的内容，继续编辑。...
  7. 即时通信 IM Android&iOS&Windows&Mac（删除会话） 删除好友或退出群组后，SDK 不会自动删除对应的单聊或群聊会话。客户可以调用下面的接口，主动删除会话。会话删除默认不支持多端同步，可以以在 即时通信 IM 控制台 开启多端同步。配置页面如下图所示。...
  8. 即时通信 IM Android&iOS&Windows&Mac（群成员资料） 群成员资料类为 V2TIMGroupMemberFullInfo，内含群成员 userID、自定义信息、角色、禁言等信息。 相关方法在核心类 V2TIMGroupManager(Java) / V2TIMManager+Group (Objective-C、Swift 语言) 中。...
赞 (0)
上一篇 4天前
下一篇 4天前