javaboolean addConversationGroupListener(@NonNull V2NIMConversationGroupListener listener);

objective-c- (void)addConversationGroupListener:(id<V2NIMConversationGroupListener>)listener;

cppvirtual void addConversaionGroupListener(V2NIMConversationGroupListener listener) = 0;

javaV2NIMConversationGroupListener listener = new V2NIMConversationGroupListener() {
    @Override
    public void onConversationGroupCreated(V2NIMConversationGroup conversationGroup) {
        // handle conversation group created event
    }

    @Override
    public void onConversationGroupDeleted(String groupId) {
        // handle conversation group deleted event
    }

    @Override
    public void onConversationGroupChanged(V2NIMConversationGroup conversationGroup) {
        // handle conversation group changed event
    }

    @Override
    public void onConversationsAddedToGroup(String groupId, List<V2NIMConversation> conversations) {
        // handle conversation add to group event
    }

    @Override
    public void onConversationsRemovedFromGroup(String groupId, List<String> conversationIds) {
        // handle conversation remove from group event
    }
};
NIMClient.getService(V2NIMConversationGroupService.class).addConversationGroupListener(listener);

objective-c@interface V2ConversationGroupServiceSample : NSObject <V2NIMConversationGroupListener>

@end

@implementation V2ConversationGroupServiceSample

- (void)onConversationGroupCreated:(V2NIMConversationGroup *)conversationGroup
{
    // handle conversation group created event
}

- (void)onConversationGroupDeleted:(NSString *)groupId
{
    // handle conversation group deleted event
}

- (void)onConversationGroupChanged:(V2NIMConversationGroup *)conversationGroup
{
    // handle conversation group changed event
}

- (void)onConversationsAddedToGroup:(NSString *)groupId
                      conversations:(NSArray<V2NIMConversation *> *)conversations
{
    // handle conversation add to group event
}

- (void)onConversationsRemovedFromGroup:(NSString *)groupId
                        conversationIds:(NSArray<NSString *> *)conversationIds
{
    // handle conversation remove from group event
}

- (void)addConversationGroupListener
{
    [NIMSDK.sharedSDK.v2ConversationGroupService addConversationGroupListener:self];
}

@end

cppV2NIMConversationGroupListener listener;
listener.onConversationGroupCreated = [](V2NIMConversationGroup conversationGroup, V2NIMConversationList conversations) {
    // handle conversation group created event
};
listener.onConversationGroupDeleted = [](nstd::string groupId) {
    // handle conversation group deleted event
};
listener.onConversationGroupChanged = [](V2NIMConversationGroup conversationGroup) {
    // handle conversation group changed event
};
listener.onConversationsAddedToGroup = [](nstd::string groupId, V2NIMConversationList conversations) {
    // handle conversation add to group event
};
listener.onConversationsRemovedFromGroup = [](nstd::string groupId, nstd::vector<nstd::string> conversationIds) {
    // handle conversation remove from group event
};
conversationGroupService.addConversaionGroupListener(listener);

javavoid removeConversationGroupListener(@NonNull V2NIMConversationGroupListener listener);

objective-c- (void)removeConversationGroupListener:(id<V2NIMConversationGroupListener>)listener;

cppvirtual void removeConversaionGroupListener(V2NIMConversationGroupListener listener) = 0;

javaNIMClient.getService(V2NIMConversationGroupService.class).removeConversationGroupListener(listener);

objective-cid<V2NIMConversationGroupListener> listener;
[NIMSDK.sharedSDK.v2ConversationGroupService removeConversationGroupListener:listener];

cppV2NIMConversationGroupListener listener;
conversationGroupService.removeConversaionGroupListener(listener);

javavoid createConversationGroup(@NonNull String name, String serverExtension, List<String> conversationIds, V2NIMSuccessCallback<V2NIMConversationGroupResult> success, V2NIMFailureCallback failure);

objective-c- (void)createConversationGroup:(NSString *)name
                serverExtension:(nullable NSString *)serverExtension
                conversationIds:(nullable NSArray<NSString *> *)conversationIds
                        success:(nullable V2NIMConversationGroupResultCallback)success
                        failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void createConversationGroup(nstd::string name,
    nstd::optional<nstd::string> serverExtension,
    nstd::vector<nstd::string> conversationIds,
    V2NIMSuccessCallback<V2NIMConversationGroupResult> success,
    V2NIMFailureCallback failure) = 0;	

typescriptcreateConversationGroup(name: string, serverExtension?: string, conversationIds?: string[]): Promise<V2NIMConversationGroupResult>

javaList<String> conversationIds = new ArrayList<>();
conversationIds.add("conversationId");
NIMClient.getService(V2NIMConversationGroupService.class)
    .createConversationGroup("name", "serverExtension", conversationIds, new V2NIMSuccessCallback<V2NIMConversationGroupResult>() {
        @Override
        public void onSuccess(V2NIMConversationGroupResult v2NIMConversationGroupResult) {
            // receive v2NIMConversationGroupResult and check failed list
        }
    }, new V2NIMFailureCallback() {
        @Override
        public void onFailure(V2NIMError error) {
            int code = error.getCode();
            String desc = error.getDesc();
            // handle error
        }
    });

objective-c[NIMSDK.sharedSDK.v2ConversationGroupService createConversationGroup:@"name" serverExtension:@"serverExtension" conversationIds:@[@"conversationIdA", @"conversationIdB"] success:^(V2NIMConversationGroupResult * _Nonnull result) {
    // receive result and check failed list
} failure:^(V2NIMError * _Nonnull error) {
    // handle error
}];

cppauto conversationIds = nstd::vector<nstd::string>{};
conversationIds.emplace_back(V2NIMConversationIdUtil::p2pConversationId("account1"));
conversationIds.emplace_back(V2NIMConversationIdUtil::teamConversationId("team1"));
conversationGroupService.createConversationGroup(
    "group1",
    conversationIds,
    [](V2NIMConversationGroupResult result) {
        // receive result and check failed list
    },
    [](V2NIMError error) {
        // create conversation group failed, handle error
    });

typescriptconst conversationId1 = nim.V2NIMConversationIdUtil.p2pConversationId('TARGET_ACCOUNT_ID')
const conversationId2 = nim.V2NIMConversationIdUtil.teamConversationId('TARGET_TEAM_ID')
try {
  const result = await nim.V2NIMConversationGroupService.createConversationGroup('GROUP_NAME', '', [conversationId1, conversationId2])
  // receive result and check failed list
  // console.log(result.group)
} catch (err) {
  // handle error
  // console.error(error.code)
}

无返回值

Promise 会话分组创建结果，包含会话分组信息和创建分组失败的会话 ID 列表。

• 请求成功，返回 V2NIMSuccessCallback 回调；创建成功，返回 onConversationGroupCreated 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

• 请求成功，返回 V2NIMConversationGroupResultCallback 回调，可自定义设置；创建成功，返回 onConversationGroupCreated 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

创建成功，返回 onConversationGroupCreated 回调。

javavoid deleteConversationGroup(@NonNull String groupId, V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);

objective-c- (void)deleteConversationGroup:(NSString *)groupId
                        success:(nullable V2NIMSuccessCallback)success
                        failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void deleteConversationGroup(nstd::string groupId, V2NIMSuccessCallback<void> success, V2NIMFailureCallback failure) = 0;

typescriptdeleteConversationGroup(groupId: string): Promise<void>

javaNIMClient.getService(V2NIMConversationGroupService.class).deleteConversationGroup("会话分组id",new V2NIMSuccessCallback<Void>(){
    @Override
    public void onSuccess(Void unused) {
        // delete successfully
    }
}, new V2NIMFailureCallback(){
    @Override
    public void onFailure(V2NIMError error){
        int code = error.getCode();
        String desc = error.getDesc();
        // handle error
    }
});

objective-c[NIMSDK.sharedSDK.v2ConversationGroupService deleteConversationGroup:@"groupId" success:^{
    // delete successfully        
        } failure:^(V2NIMError * _Nonnull error) {
            // handle error
        }];

cppconversationGroupService.deleteConversationGroup(
    "groupId",
    []() {
        // delete conversation group succeeded
    },
    [](V2NIMError error) {
        // delete conversation group failed, handle error
    });

typescripttry {
  await nim.V2NIMConversationGroupService.deleteConversationGroup('GROUP_ID')
  // todo: success
} catch (err) {
  // todo: fail
  // console.error(error.code)
}

无返回值

Promise<void> |

• 请求成功，返回 V2NIMSuccessCallback 回调；删除成功，返回 onConversationGroupDeleted 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

删除成功，返回 onConversationGroupDeleted 回调。

javavoid updateConversationGroup(@NonNull String groupId, String name, String serverExtension, V2NIMSuccessCallback<Void> success,
V2NIMFailureCallback failure);

objective-c- (void)updateConversationGroup:(NSString *)groupId
                           name:(nullable NSString *)name
                serverExtension:(nullable NSString *)serverExtension
                        success:(nullable V2NIMSuccessCallback)success
                        failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void updateConversationGroup(nstd::string groupId,
    nstd::string name,
    nstd::string serverExtension,
    V2NIMSuccessCallback<void> success,
    V2NIMFailureCallback failure) = 0;

typescriptupdateConversationGroup(groupId: string, name?: string, serverExtension?: string): Promise<void>

javaNIMClient.getService(V2NIMConversationGroupService.class).updateConversationGroup("groupId", "newname", "serverExtension", new V2NIMSuccessCallback<Void>() {
    @Override
    public void onSuccess(Void unused) {
        // update successfully
    }
}, new V2NIMFailureCallback() {
    @Override
    public void onFailure(V2NIMError error) {
        int code = error.getCode();
        String desc = error.getDesc();
        // handle error
    }
});

objective-c[NIMSDK.sharedSDK.v2ConversationGroupService updateConversationGroup:@"groupId" name:@"newName" serverExtension:@"newServerExtension" success:^{
    // update successfully         
        } failure:^(V2NIMError * _Nonnull error) {
            // handle error
        }];

cppconversationGroupService.updateConversaionGroup(
    "groupId",
    "name",
    "serverExtension",
    [](V2NIMConversationGroup group) {
        // update conversation group succeeded
    },
    [](V2NIMError error) {
        // update conversation group failed, handle error
    });

typescripttry {
  const group = await nim.V2NIMConversationGroupService.createConversationGroup('GROUP_ID', 'NAME', "SERVER_EXTENSION")
  // todo: success
} catch (err) {
  // todo: fail
  // console.error(error.code)
}

无返回值

Promise<void>

• 请求成功，返回 V2NIMSuccessCallback 回调；更新成功，返回 onConversationGroupChanged 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

更新成功，返回 onConversationGroupChanged 回调。

javavoid addConversationsToGroup(@NonNull String groupId, @NonNull List<String> conversationIds, V2NIMSuccessCallback<List<V2NIMConversationOperationResult>> success,
V2NIMFailureCallback failure);

objective-c- (void)addConversationsToGroup:(NSString *)groupId
                conversationIds:(NSArray<NSString *> *)conversationIds
                        success:(nullable V2NIMConversationOperationResultListCallback)success
                        failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void addConversationsToGroup(nstd::string groupId,
    nstd::vector<nstd::string> conversationIds,
    V2NIMSuccessCallback<nstd::vector<V2NIMConversationOperationResult>> success,
    V2NIMFailureCallback failure) = 0;

typescriptaddConversationsToGroup(groupId: string, conversationIds?: string[]): Promise<V2NIMConversationOperationResult[]>

javaNIMClient.getService(V2NIMConversationGroupService.class).addConversationsToGroup("groupId", conversationIds, new V2NIMSuccessCallback<List<V2NIMConversationOperationResult>>() {
    @Override
    public void onSuccess(List<V2NIMConversationOperationResult> results) {
        // receive results and check failed list
    }
}, new V2NIMFailureCallback() {
    @Override
    public void onFailure(V2NIMError error) {
        int code = error.getCode();
        String desc = error.getDesc();
        // handle error
    }
});

objective-c[NIMSDK.sharedSDK.v2ConversationGroupService addConversationsToGroup:@"groupId" conversationIds:@[@"conversationIdA", @"conversationIdB"] success:^(NSArray<V2NIMConversationOperationResult *> * _Nonnull resultList) {
    // receive resultList and check failed list
} failure:^(V2NIMError * _Nonnull error) {
    // handle error
}];

cppauto conversationIds = nstd::vector<nstd::string>{};
conversationIds.emplace_back(V2NIMConversationId::p2pConversationId("account1"));
conversationIds.emplace_back(V2NIMConversationId::teamConversationId("team1"));
conversationGroupService.addConversationsToGroup(
    "groupId",
    conversationIds,
    [](nstd::vector<V2NIMConversationOperationResult> failedList) {
        // add conversations to group succeeded
    },
    [](V2NIMError error) {
        // add conversations to group failed, handle error
    });

typescriptnim.V2NIMConversationGroupService.on('onConversationsAddedToGroup', function (groupId: string, list: V2NIMConversation[]) {})

try {
  const conversationId1 = nim.V2NIMConversationIdUtil.p2pConversationId("account1")
  const conversationId2 = nim.V2NIMConversationIdUtil.teamConversationId("team1")
  const group = await nim.V2NIMConversationGroupService.addConversationToGroup('GROUP_ID', [
    conversationId1,
    conversationId2     
  ])
  // todo: success
} catch (err) {
  // todo: fail
  // console.error(error.code)
}

无返回值

Promise<V2NIMConversationOperationResult[]> 会话操作结果，仅包含添加失败的会话 ID 及其错误信息。

• 请求成功，返回 V2NIMSuccessCallback 回调，包含 List<V2NIMConversationOperationResult>；添加成功，返回 onConversationsAddedToGroup 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

• 请求成功，返回 V2NIMConversationOperationResultListCallback 回调；添加成功，返回 onConversationsAddedToGroup 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

添加成功，返回 onConversationsAddedToGroup 回调。

javavoid removeConversationsFromGroup(@NonNull String groupId, @NonNull List<String> conversationIds, V2NIMSuccessCallback<List<V2NIMConversationOperationResult>> success,
V2NIMFailureCallback failure);

objective-c- (void)removeConversationsFromGroup:(NSString *)groupId
                     conversationIds:(NSArray<NSString *> *)conversationIds
                             success:(nullable V2NIMConversationOperationResultListCallback)success
                             failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void removeConversationsFromGroup(nstd::string groupId,
    nstd::vector<nstd::string> conversationIds,
    V2NIMSuccessCallback<nstd::vector<V2NIMConversationOperationResult>> success,
    V2NIMFailureCallback failure) = 0;

typescriptremoveConversationsFromGroup(groupId: string, conversationIds?: string[]): Promise<void>

javaNIMClient.getService(V2NIMConversationGroupService.class).removeConversationsFromGroup("groupId",conversationIds, new V2NIMSuccessCallback<List<V2NIMConversationOperationResult>>(){
    @Override
    public void onSuccess(List<V2NIMConversationOperationResult> results){
        // receive results and check failed list
    }
}, new V2NIMFailureCallback(){
    @Override
    public void onFailure(V2NIMError error){
        int code = error.getCode();
        String desc = error.getDesc();
        // TODO
    }
});

objective-c[NIMSDK.sharedSDK.v2ConversationGroupService removeConversationsFromGroup:@"groupId"
                                                             conversationIds:@[@"conversationIdA", @"conversationIdB"]
                                                                      success:^(NSArray<V2NIMConversationOperationResult *> * _Nonnull resultList) {
        // receive resultList and check failed list
    } failure:^(V2NIMError * _Nonnull error) {
        // handle error
}];

cppauto conversationIds = nstd::vector<nstd::string>{};
conversationIds.emplace_back(V2NIMConversationId::p2pConversationId("account1"));
conversationIds.emplace_back(V2NIMConversationId::teamConversationId("team1"));
conversationGroupService.removeConversationsFromGroup(
    "groupId",
    conversationIds,
    [](nstd::vector<V2NIMConversationOperationResult> failedList) {
        // remove conversations from group succeeded
    },
    [](V2NIMError error) {
        // remove conversations from group failed, handle error
    });

typescripttry {
  const conversationId1 = nim.V2NIMConversationIdUtil.p2pConversationId("account1")
  const conversationId2 = nim.V2NIMConversationIdUtil.teamConversationId("team1")
  const group = await nim.V2NIMConversationGroupService.removeConversationsFromGroup('GROUP_ID', [
    conversationId1,
    conversationId2     
  ])
  // todo: success
} catch (err) {
  // todo: fail
  // console.error(error.code)
}

无返回值

Promise<V2NIMConversationOperationResult[]> 会话操作结果，仅包含移除失败的会话 ID 及其错误信息。

• 请求成功，返回 V2NIMSuccessCallback 回调，包含 List<V2NIMConversationOperationResult>；移除成功，返回 onConversationsRemovedFromGroup 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

• 请求成功，返回 V2NIMConversationOperationResultListCallback 回调；移除成功，返回 onConversationsRemovedFromGroup 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

移除成功，返回 onConversationsRemovedFromGroup 回调。

javavoid getConversationGroup(@NonNull String groupId,V2NIMSuccessCallback<V2NIMConversationGroup> success, V2NIMFailureCallback failure);

objective-c- (void)getConversationGroup:(NSString *)groupId
                     success:(nullable V2NIMConversationGroupCallback)success
                     failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void getConversationGroup(nstd::string groupId, V2NIMSuccessCallback<V2NIMConversationGroup> success, V2NIMFailureCallback failure) = 0;

typescriptgetConversationGroup(groupId: string): Promise<V2NIMConversationGroup>

javaNIMClient.getService(V2NIMConversationGroupService.class).getConversationGroup("groupId", new V2NIMSuccessCallback<V2NIMConversationGroup>(){
    @Override
    public void onSuccess(V2NIMConversationGroup group){
        // receive group
    }
}, new V2NIMFailureCallback(){
    @Override
    public void onFailure(V2NIMError error){
        int code = error.getCode();
        String desc = error.getDesc();
        // handle error
    }
});

objective-c[NIMSDK.sharedSDK.v2ConversationGroupService getConversationGroup:@"groupId"
    success:^(V2NIMConversationGroup * _Nonnull group) {
        // receive group
    }
    failure:^(V2NIMError * _Nonnull error) {
        // handle error
    }];

cppconversationGroupService.getConversationGroup(
    "groupId",
    [](V2NIMConversationGroup group) {
        // get conversation group succeeded
    },
    [](V2NIMError error) {
        // get conversation group failed, handle error
    });

typescripttry {
  const group = await nim.V2NIMConversationGroupService.getConversationGroup('GROUP_ID')
  // todo: success
} catch (err) {
  // todo: fail
  // console.error(error.code)
}

无返回值

Promise 会话分组信息

• 请求成功，返回 V2NIMSuccessCallback 回调，包含 V2NIMConversationGroup。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

• 请求成功，返回 V2NIMConversationGroupCallback 回调，可自定义设置。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

无

javavoid getConversationGroupList(V2NIMSuccessCallback<List<V2NIMConversationGroup>> success, V2NIMFailureCallback failure);

objective-c- (void)getConversationGroupList:(nullable V2NIMConversationGroupListCallback)success
                         failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void getConversationGroupList(V2NIMSuccessCallback<nstd::vector<V2NIMConversationGroup>> success, V2NIMFailureCallback failure) = 0;

typescriptgetConversationGroupList(): Promise<V2NIMConversationGroup[]>

无参数

javaNIMClient.getService(V2NIMConversationGroupService.class).getConversationGroupList(new V2NIMSuccessCallback<List<V2NIMConversationGroup>>(){
    @Override
    public void onSuccess(List<V2NIMConversationGroup> result){
        // TODO
    }
}, new V2NIMFailureCallback(){
    @Override
    public void onFailure(V2NIMError error){
        int code = error.getCode();
        String desc = error.getDesc();
        // TODO
    }
});

objective-c[NIMSDK.sharedSDK.v2ConversationGroupService getConversationGroupList:^(NSArray<V2NIMConversationGroup *> * _Nonnull groups) {
    // receive all groups
} failure:^(V2NIMError * _Nonnull error) {
    // handle error
}];

cppconversationGroupService.getConversationGroupList(
    [](V2NIMConversationGroupList groupList) {
        // get conversation group list succeeded
    },
    [](V2NIMError error) {
        // get conversation group list failed, handle error
    });

typescripttry {
  const groupList = await nim.V2NIMConversationGroupService.getConversationGroupList()
  // todo: success
} catch (err) {
  // todo: failed
  // console.error(error.code)
}

无返回值

Promise<V2NIMConversationGroup[]> 会话分组列表

• 请求成功，返回 V2NIMSuccessCallback 回调，包含 V2NIMConversationGroup 列表。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

• 请求成功，返回 V2NIMConversationGroupListCallback 回调，可自定义设置。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

无

javavoid getConversationGroupListByIds(@NonNull List<String> groupIds, V2NIMSuccessCallback<List<V2NIMConversationGroup>> success,
V2NIMFailureCallback failure);

objective-c- (void)getConversationGroupListByIds:(NSArray<NSString *> *)groupIds
                              success:(nullable V2NIMConversationGroupListCallback)success
                              failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void getConversationGroupListByIds(nstd::vector<nstd::string> groupIds,
    V2NIMSuccessCallback<V2NIMConversationGroupList> success,
    V2NIMFailureCallback failure) = 0;

typescriptgetConversationGroupListByIds(groupIds: string[]): Promise<V2NIMConversationGroup[]>

javaNIMClient.getService(V2NIMConversationGroupService.class).getConversationGroupListByIds(groupIds,new V2NIMSuccessCallback<List<V2NIMConversationGroup>>(){
    @Override
    public void onSuccess(List<V2NIMConversationGroup> result){
        // receive groups
    }
}, new V2NIMFailureCallback(){
    @Override
    public void onFailure(V2NIMError error){
        int code = error.getCode();
        String desc = error.getDesc();
        // handle error
    }
});

objective-c[NIMSDK.sharedSDK.v2ConversationGroupService getConversationGroupListByIds:@[@"groupIdA", @"groupIdB"] success:^(NSArray<V2NIMConversationGroup *> * _Nonnull groups) {
    // receive groups
} failure:^(V2NIMError * _Nonnull error) {
    // handle error
}];

cppauto groupIds = nstd::vector<nstd::string>{};
groupIds.emplace_back("groupId1");
groupIds.emplace_back("groupId2");
conversationGroupService.getConversationGroupListByIds(
    groupIds,
    [](V2NIMConversationGroupList groupList) {
        // get conversation group list by ids succeeded
    },
    [](V2NIMError error) {
        // get conversation group list by ids failed, handle error
    });

typescripttry {
  const groupList = await nim.V2NIMConversationGroupService.getConversationGroupListByIds(["GROUP_ID1"])
  // todo: success
} catch (err) {
  // todo: fail
  // console.error(error.code)
}

无返回值

Promise<V2NIMConversationGroup[]> 会话分组列表

• 请求成功，返回 V2NIMSuccessCallback 回调，包含 V2NIMConversationGroup 列表。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

• 请求成功，返回 V2NIMConversationGroupListCallback 回调，可自定义设置。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含会话相关错误码。

无