javavoid addUserListener(V2NIMUserListener listener);

objective-c- (void)addUserListener:(id<V2NIMUserListener>)listener;

cppvirtual void addUserListener(V2NIMUserListener listener) = 0;

javaNIMClient.getService(V2NIMUserService.class).addUserListener(new V2NIMUserListener() {
    @Override
    public void onUserProfileChanged(List<V2NIMUser> users) {
        
    }

    @Override
    public void onBlockListAdded(V2NIMUser user) {

    }

    @Override
    public void onBlockListRemoved(String accountId) {

    }
});

objective-c[[[NIMSDK sharedSDK] v2UserService] addUserListener:self];
- (void)onUserProfileChanged:(NSArray<V2NIMUser *> *)users {
}
- (void)onBlockListAdded:(V2NIMUser *)user {
}
- (void)onBlockListRemoved:(NSString *)accountId {
}

cppV2NIMUserListener listener;
listener.onUserProfileChanged = [](std::vector<V2NIMUser> users) {
    // user profile changed
};
listener.onBlockListAdded = [](V2NIMUser user) {
    // user added to blocklist
};
listener.onBlockListRemoved = [](std::string accountId) {
    // user removed from blocklist
};
userService.addUserListener(listener);

javavoid removeUserListener(V2NIMUserListener listener);

objective-c- (void)removeUserListener:(id<V2NIMUserListener>)listener;

cppvirtual void removeUserListener(V2NIMUserListener listener) = 0;

javaNIMClient.getService(V2NIMUserService.class).removeUserListener(listener);

objective-c[[[NIMSDK sharedSDK] v2UserService] removeUserListener:self];

cppV2NIMUserListener listener;
// ...
userService.addUserListener(listener);
// ...
userService.removeUserListener(listener);

typescriptexport interface NIMEBaseServiceInterface<I extends NIMEBaseListener> {
  /**
   * 继承自 eventEmitter3 的监听事件方法
   */
  on<T extends keyof I>(eventName: T, fn: (...args: I[T]) => void): void
  /**
   * 继承自 eventEmitter3 的监听事件方法
   */
  once<T extends keyof I>(eventName: T, fn: (...args: I[T]) => void): void
}

typescriptexport interface NIMEBaseServiceInterface<I extends NIMEBaseListener> {
  /**
   * 继承自 eventEmitter3 的监听事件方法
   */
  on<T extends keyof I>(eventName: T, fn: (...args: I[T]) => void): void
  /**
   * 继承自 eventEmitter3 的监听事件方法
   */
  once<T extends keyof I>(eventName: T, fn: (...args: I[T]) => void): void
}

typescriptnim.V2NIMUserService.on("onUserProfileChanged", function (users: V2NIMUser[]) {})
nim.V2NIMUserService.on("onBlockListAdded", function (user: V2NIMUser) {})
nim.V2NIMUserService.on("onBlockListRemoved", function (accountId: string) {})

typescriptnim.userService.on("onUserProfileChanged", function (users: V2NIMUser[]) {})
nim.userService.on("onBlockListAdded", function (user: V2NIMUser) {})
nim.userService.on("onBlockListRemoved", function (accountId: string) {})

typescriptexport interface NIMEBaseServiceInterface<I extends NIMEBaseListener> {
  /**
   * 继承自 eventEmitter3 的取消监听方法
   */
  off<T extends keyof I>(eventName: T, fn: (...args: I[T]) => void): void
  /**
   * 继承自 eventEmitter3 的移除事件方法
   */
  removeAllListeners<T extends keyof I>(eventName?: T): void
}

typescriptexport interface NIMEBaseServiceInterface<I extends NIMEBaseListener> {
  /**
   * 继承自 eventEmitter3 的取消监听方法
   */
  off<T extends keyof I>(eventName: T, fn: (...args: I[T]) => void): void
  /**
   * 继承自 eventEmitter3 的移除事件方法
   */
  removeAllListeners<T extends keyof I>(eventName?: T): void
}

typescriptnim.V2NIMUserService.off("onUserProfileChanged", function (users: V2NIMUser[]) {})
nim.V2NIMUserService.off("onBlockListAdded", function (user: V2NIMUser) {})
nim.V2NIMUserService.off("onBlockListRemoved", function (accountId: string) {})

typescriptnim.userService.off("onUserProfileChanged", function (users: V2NIMUser[]) {})
nim.userService.off("onBlockListAdded", function (user: V2NIMUser) {})
nim.userService.off("onBlockListRemoved", function (accountId: string) {})

javavoid getUserList(List<String> accountIds, V2NIMSuccessCallback<List<V2NIMUser>> success, V2NIMFailureCallback failure);

objective-c- (void)getUserList:(NSArray<NSString *> *)accountIds
            success:(nullable V2NIMGetUserListSuccess)success
            failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void getUserList(nstd::vector<nstd::string> accountIds,
    V2NIMSuccessCallback<nstd::vector<V2NIMUser>> success,
    V2NIMFailureCallback failure) = 0;

typescriptgetUserList(accountIds: string[]): Promise<V2NIMUser[]>

typescriptgetUserList(accountIds: string[]): Promise<V2NIMUser[]>

javaNIMClient.getService(V2NIMUserService.class).getUserList(accountIds,
    new V2NIMSuccessCallback<List<V2NIMUser>>() {
        @Override
        public void onSuccess(List<V2NIMUser> v2NIMUsers) {
            // TODO: Implement onSuccess logic
        }
    },
    new V2NIMFailureCallback() {
        @Override
        public void onFailure(V2NIMError error) {
            // TODO: Implement onFailure logic
        }
    });

objective-c[[[NIMSDK sharedSDK] v2UserService] getUserList:@[@"accountId1",@"accountId2"] success:^(NSArray<V2NIMUser *> * _Nonnull result) {
    // 成功回调
} failure:^(V2NIMError * _Nonnull error) {
    // 失败回调
}];

cppnstd::vector<nstd::string> accountIds = {"test1", "test2"};
userService.getUserList(
    accountIds,
    [](nstd::vector<V2NIMUser> users) {
        for (auto&& user : users) {
            // do something
        }
    },
    [](V2NIMError error) {
        // get user list failed, handle error
    });

typescriptconst userProfiles = await nim.V2NIMUserService.getUserList(['accid1', 'accid2'])

typescriptconst userProfiles = await nim.userService.getUserList(['accid1', 'accid2'])

无返回值

Promise<V2NIMUser[]>：查询到的用户资料列表。

• 请求成功，返回 V2NIMSuccessCallback 回调，包含 V2NIMUser 用户资料列表。
• 请求失败，返回 V2NIMFailureCallback 回调，包含用户资料知相关错误码。

• 请求成功，返回 V2NIMGetUserListSuccess 回调，可自定义设置。
• 请求失败，返回 V2NIMFailureCallback 回调，包含用户资料知相关错误码。

无

javavoid updateSelfUserProfile(V2NIMUserUpdateParams updateParams, V2NIMSuccessCallback<List<Void>> success, V2NIMFailureCallback failure);

objective-c- (void)updateSelfUserProfile:(V2NIMUserUpdateParams *)updateParams
                     success:(nullable V2NIMSuccessCallback)success
                     failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void updateSelfUserProfile(V2NIMUserUpdateParams updateParams, V2NIMSuccessCallback<void> success, V2NIMFailureCallback failure) = 0;

typescriptupdateSelfUserProfile(updateParams: V2NIMUserUpdateParams): Promise<void>

typescriptupdateSelfUserProfile(updateParams: V2NIMUserUpdateParams): Promise<void>

javaV2NIMUserUpdateParams updateParams = V2NIMUserUpdateParams.V2NIMUserUpdateParamsBuilder.builder()
    .withAvatar(avatar)
    .withBirthday(birthday)
    .withEmail(email)
    .withGender(gender)
    .withMobile(mobile)
    .withName(name)
    .withServerExtension(serverExtension)
    .withSign(sign)
    .build();

NIMClient.getService(V2NIMUserService.class).updateSelfUserProfile(updateParams,
new V2NIMSuccessCallback<List<Void>>() {
    @Override
    public void onSuccess(List<Void> voids) {
        // 处理成功回调
    }
},
new V2NIMFailureCallback() {
    @Override
    public void onFailure(V2NIMError error) {
        // 处理失败回调
    }
});

objective-c[[[NIMSDK sharedSDK] v2UserService] updateSelfUserProfile:userService success:^{
    //成功回调
} failure:^(V2NIMError * _Nonnull error) {
    //失败回调
}];

cppV2NIMUserUpdateParams updateParams;
updateParams.name = "name";
userService.updateSelfUserProfile(
    updateParams,
    []() {
        // update success
    },
    [](V2NIMError error) {
        // update failed, handle error
    });

typescriptnim.V2UserService.updateSelfUserProfile({
    name: 'ab',
});

typescriptnim.userService.updateSelfUserProfile({
    name: 'ab'
})

无返回值

Promise<void>

• 请求成功，返回 V2NIMSuccessCallback 回调。更新成功，返回 onUserProfileChanged 回调。
• 请求失败，返回 V2NIMFailureCallback 回调，包含用户资料知相关错误码。

更新成功，返回 onUserProfileChanged 回调。

javavoid addUserToBlockList(String accountId, V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);

objective-c- (void)addUserToBlockList:(NSString *)accountId
                   success:(nullable V2NIMSuccessCallback)success
                   failure:(nullable V2NIMFailureCallback)failure;

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

typescriptaddUserToBlockList(accountId: string): Promise<void>

typescriptaddUserToBlockList(accountId: string): Promise<void>

javaNIMClient.getService(V2NIMUserService.class).addUserToBlockList(accountId,
new V2NIMSuccessCallback<Void>() {
    @Override
    public void onSuccess(Void unused) {

    }
},
new V2NIMFailureCallback() {
    @Override
    public void onFailure(V2NIMError error) {
        
    }
});

objective-c[[[NIMSDK sharedSDK] v2UserService] addUserToBlockList:@"accountId" success:^{
        
    } failure:^(V2NIMError * _Nonnull error) {
        
    }];

cppuserService.addUserToBlockList(
    "account1",
    []() {
        // add user to blocklist success
    },
    [](V2NIMError error) {
        // add user to blocklist failed, handle error
    }
);

typescriptnim.V2NIMUserService.addUserToBlockList('accid');

typescriptnim.userService.addUserToBlockList('accid')

无返回值

Promise<void>

• 请求成功，返回 V2NIMSuccessCallback 回调。
• 请求失败，返回 V2NIMFailureCallback 回调，包含用户资料知相关错误码。

无

javavoid removeUserFromBlockList(String accountId, V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);

objective-c- (void)removeUserFromBlockList:(NSString *)accountId
                        success:(nullable V2NIMSuccessCallback)success
                        failure:(nullable V2NIMFailureCallback)failure;

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

typescriptremoveUserFromBlockList(accountId: string): Promise<void>

typescriptremoveUserFromBlockList(accountId: string): Promise<void>

javaNIMClient.getService(V2NIMUserService.class).removeUserFromBlockList(accountId, new V2NIMSuccessCallback<Void>() {
    @Override
    public void onSuccess(Void unused) {

    }
}, new V2NIMFailureCallback() {
    @Override
    public void onFailure(V2NIMError error) {

    }
});

objective-c[[[NIMSDK sharedSDK] v2UserService] removeUserFromBlockList:@"accountId" success:^{
        
    } failure:^(V2NIMError * _Nonnull error) {
        
    }];

cppuserService.removeUserFromBlockList(
    "account1",
    []() {
        // remove user from blocklist success
    },
    [](V2NIMError error) {
        // remove user from blocklist failed, handle error
    });

typescriptnim.V2NIMUserService.removeUserFromBlockList('accid');

typescriptnim.userService.removeUserFromBlockList('accid')

无返回值

Promise<void>

• 请求成功，返回 V2NIMSuccessCallback 回调。
• 请求失败，返回 V2NIMFailureCallback 回调，包含用户资料知相关错误码。

无

javavoid getBlockList(V2NIMSuccessCallback<List<String>> success, V2NIMFailureCallback failure);

objective-c- (void)getBlockList:(nullable V2NIMGetBlockListSuccess)success
             failure:(nullable V2NIMFailureCallback)failure;

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

typescriptgetBlockList(): Promise<string[]>

typescriptgetBlockList(): Promise<string[]>

javaNIMClient.getService(V2NIMUserService.class).getBlockList(
    new V2NIMSuccessCallback<List<String>>() {
        @Override
        public void onSuccess(List<String> strings) {

        }
    },
    new V2NIMFailureCallback() {
        @Override
        public void onFailure(V2NIMError error) {

        }
    }
);

objective-c[[[NIMSDK sharedSDK] v2UserService] getBlockList:^(NSArray<NSString *> * _Nonnull result) {

} failure:^(V2NIMError * _Nonnull error) {

}];

cppuserService.getBlockList(
    [](std::vector<std::string> accountIds) {
        for (auto&& accountId : accountIds) {
            // do something
        }
    },
    [](V2NIMError error) {
        // get blocklist failed, handle error
    });

typescriptconst blockList = await nim.V2NIMUserService.getBlockList()

typescriptconst blockList = await nim.userService.getBlockList()

无返回值

Promise<string[]>：查询到的黑名单用户账号 ID 列表。

• 请求成功，返回 V2NIMSuccessCallback 回调，包含黑名单用户账号 ID 列表。
• 请求失败，返回 V2NIMFailureCallback 回调，包含用户资料知相关错误码。

• 请求成功，返回 V2NIMGetBlockListSuccess 回调，可自定义设置。
• 请求失败，返回 V2NIMFailureCallback 回调，包含用户资料知相关错误码。

无

javavoid searchUserByOption(V2NIMUserSearchOption userSearchOption, V2NIMSuccessCallback<List<V2NIMUser>> success, V2NIMFailureCallback failure);

objective-c- (void)searchUserByOption:(V2NIMUserSearchOption *)userSearchOption
            success:(nullable V2NIMGetUserListSuccess)success
            failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void searchUserByOption(const V2NIMUserSearchOption& option,V2NIMSuccessCallback<nstd::vector<V2NIMUser>> success,V2NIMFailureCallback failure) = 0;

typescriptsearchUserByOption(option: V2NIMUserSearchOption): Promise<V2NIMUser[]>

javaV2NIMUserSearchOption option = V2NIMUserSearchOption.V2NIMUserSearchOptionBuilder.builder("搜索关键字")
//             按需配置
//            .withSearchAccountId()
//            .withSearchMobile()
//            .withSearchName()
            .build();
    NIMClient.getService(V2NIMUserService.class).searchUserByOption(option,
            new V2NIMSuccessCallback<List<V2NIMUser>>() {
                @Override
                public void onSuccess(List<V2NIMUser> v2NIMUsers) {

                }
            }, new V2NIMFailureCallback() {
                @Override
                public void onFailure(V2NIMError error) {

                }
            });

objective-cV2NIMUserSearchOption *option = [V2NIMUserSearchOption optionWithKeyword:@"keyword"];
// 按需配置
option.searchName = YES;
option.searchAccountId = YES;
option.searchMobile = YES;
[NIMSDK.sharedSDK.v2UserService searchUserByOption:option
                                           success:^(NSArray <V2NIMUser *> *result)
                                           {
    
                                           }
                                           failure:^(V2NIMError *error)
                                           {

                                           }];

cppV2NIMUserSearchOption option;
option.keyword = "test";
userService.searchUserByOption(
   option,
   [](nstd::vector<V2NIMUser> users) {
   for (auto&& user : users) {
   // do something
   }
   },
   [](V2NIMError error) {
   // search user failed, handle error
   });

typescripttry {
    const users = await nim.V2NIMUserService.searchUserByOption({
        keyword: 'nick',
        searchName: true,
        searchAccountId: false,
        searchMobile: true
    })
} catch(err) {
    console.error('searchUserByOption Error:', err)
}

无返回值

Promise<V2NIMUser[]>：查询到的黑名单用户账号 ID 列表。

• 请求成功，返回 V2NIMSuccessCallback 回调，包含 V2NIMUser 列表。
• 请求失败，返回 V2NIMFailureCallback 回调，包含用户信息相关错误码。

• 请求成功，，返回 V2NIMGetUserListSuccess 回调，可自定义设置。
• 请求失败，返回 V2NIMFailureCallback 回调，包含用户信息相关错误码。

无