tencent cloud



Last updated: 2023-07-17 16:56:36


    Only locally stored groups can be searched for, such as the list of joined groups and group profiles that have been pulled.
    The local group search feature is supported only by v5.4.666 or later.
    The local group search feature is only available on the IM Premium edition. To use it, purchase the Premium edition. For more information, see Billing Overview.

    Searching a Local Group

    Call the searchGroups API (Android / iOS and Mac / Windows) to search a local group. You can set the search keyword keywordList and specify the search scope to set whether to search by the userID and groupName fields of a group.
    Sample code:
    iOS and macOS
    V2TIMGroupSearchParam searchParam = new V2TIMGroupSearchParam();
    V2TIMManager.getGroupManager().searchGroups(searchParam, new V2TIMValueCallback<List<V2TIMGroupInfo>>() {
    public void onSuccess(List<V2TIMGroupInfo> v2TIMGroupInfos) {
    // Group found successfully
    public void onError(int code, String desc) {
    // Failed to find the group
    V2TIMGroupSearchParam *searchParam = [[V2TIMGroupSearchParam alloc] init];
    searchParam.keywordList = @[@"keyword1", @"keyword2"];
    searchParam.isSearchGroupID = YES;
    searchParam.isSearchGroupName = YES;
    [[V2TIMManager sharedInstance] searchGroups:searchParam succ:^(NSArray<V2TIMGroupInfo *> *groupList) {
    // Group found successfully
    } fail:^(int code, NSString *desc) {
    // Failed to find the group
    template <class T>
    class ValueCallback final : public V2TIMValueCallback<T> {
    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_) {
    void OnError(int error_code, const V2TIMString& error_message) override {
    if (error_callback_) {
    error_callback_(error_code, error_message);
    SuccessCallback success_callback_;
    ErrorCallback error_callback_;
    V2TIMGroupSearchParam searchParam;
    searchParam.keywordList = keywordList;
    searchParam.isSearchGroupID = true;
    searchParam.isSearchGroupName = true;
    auto callback = new ValueCallback<V2TIMGroupInfoVector>{};
    [=](const V2TIMGroupInfoVector& groupInfoList) {
    // Group found successfully
    delete callback;
    [=](int error_code, const V2TIMString& error_message) {
    // Failed to find the group
    delete callback;
    V2TIMManager::GetInstance()->GetGroupManager()->SearchGroups(searchParam, callback);
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support