群组相关

更新时间: 2024/04/18 18:11:00

NetEase IM SDK(以下简称 NIM SDK)提供了高级群和超大群两种形式的群组功能,支持用户创建、加入、退出、转让、修改、查询、解散群组,拥有完善的管理功能。

本文介绍群组管理相关 API。更多群组相关功能请参考开发指南文档群组概述

支持平台

Android iOS macOS/Windows Web/uni-app/小程序 Harmony

API 概览

群组监听

Android/iOS/macOS/Windows
API 描述 起始版本
addTeamListener 注册群组相关监听器 v10.2.0
removeTeamListener 移除群组相关监听器 v10.2.0
Web/uni-app/小程序/Harmony
API 描述 起始版本
on("EventName") 注册群组相关监听 v10.2.0(对应 Harmony v0.5.0)
off("EventName") 取消注册群组相关监听 v10.2.0(对应 Harmony v0.5.0)

群组操作

API 描述 起始版本
createTeam 创建一个群组 v10.2.0(对应 Harmony v0.5.0)
updateTeamInfo 修改群组信息 v10.2.0(对应 Harmony v0.5.0)
leaveTeam 退出群组 v10.2.0(对应 Harmony v0.5.0)
getTeamInfo 获取群组信息 v10.2.0(对应 Harmony v0.5.0)
getTeamInfoByIds 根据群组 ID 批量获取群组信息 v10.2.0(对应 Harmony v0.5.0)
dismissTeam 解散群组 v10.2.0(对应 Harmony v0.5.0)
inviteMember 邀请成员加入群组 v10.2.0(对应 Harmony v0.5.0)
acceptInvitation 接受入群邀请 v10.2.0(对应 Harmony v0.5.0)
rejectInvitation 拒绝入群邀请 v10.2.0(对应 Harmony v0.5.0)
kickMember 踢出群成员 v10.2.0(对应 Harmony v0.5.0)
applyJoinTeam 申请加入群组 v10.2.0(对应 Harmony v0.5.0)
acceptJoinApplication 同意入群申请 v10.2.0(对应 Harmony v0.5.0)
rejectJoinApplication 拒绝入群申请 v10.2.0(对应 Harmony v0.5.0)
updateTeamMemberRole 修改群成员角色 v10.2.0(对应 Harmony v0.5.0)
transferTeamOwner 转让群主身份 v10.2.0(对应 Harmony v0.5.0)
updateSelfTeamMemberInfo 修改自己的群成员信息 v10.2.0(对应 Harmony v0.5.0)
updateTeamMemberNick 修改群成员昵称 v10.2.0(对应 Harmony v0.5.0)
setTeamChatBannedMode 设置群组禁言模式 v10.2.0(对应 Harmony v0.5.0)
setTeamMemberChatBannedStatus 设置群成员聊天禁言状态 v10.2.0(对应 Harmony v0.5.0)
getJoinedTeamList 获取当前已经加入的群组列表 v10.2.0(对应 Harmony v0.5.0)
getJoinedTeamCount 获取当前已经加入的群组数量 v10.2.0(对应 Harmony v0.5.0)
getTeamMemberList 分页获取群组成员列表 v10.2.0(对应 Harmony v0.5.0)
getTeamMemberListByIds 根据账号批量获取群组成员列表 v10.2.0(对应 Harmony v0.5.0)
getTeamMemberInvitor 根据账号获取群组成员邀请人 v10.2.0(对应 Harmony v0.5.0)
getTeamJoinActionInfoList 获取入群操作相关信息列表 v10.2.0(对应 Harmony v0.5.0)

接口类

V2NIMTeamService 类提供群组相关接口,包括注册群组监听,创建、修改、退出、解散、加入群组、获取群组相关信息等接口。

addTeamListener

接口描述

注册群组相关监听器。

注册成功后,当事件发生时,SDK 会返回对应的回调。

  • 建议在初始化后调用该方法。

  • 全局只需注册一次。

  • 该方法为同步。

参数说明

Android
javavoid addTeamListener(V2NIMTeamListener listener);
参数名称 类型 是否必填 默认值 描述
listener V2NIMTeamListener - 群组相关监听器
iOS
objective-c- (void)addTeamListener:(id<V2NIMTeamListener>)listener;
参数名称 类型 是否必填 默认值 描述
listener V2NIMTeamListener - 群组相关监听器
macOS/Windows
cppvirtual void addTeamListener(V2NIMTeamListener listener) = 0;
参数名称 类型 是否必填 默认值 描述
listener V2NIMTeamListener - 群组相关监听器

示例代码

Android
javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
V2NIMTeamListener listener = new V2NIMTeamListener() {
    @Override
    public void onSyncStarted() {
        // 开始同步群组信息
    }

    @Override
    public void onSyncFinished() {
        // 同步群组信息完成
    }

    @Override
    public void onSyncFailed(V2NIMError error) {
        // 同步群组信息失败
    }

    @Override
    public void onTeamCreated(V2NIMTeam team) {
        // 创建群组成功
    }

    @Override
    public void onTeamDismissed(V2NIMTeam team) {
        // 解散群组成功
    }

    @Override
    public void onTeamJoined(V2NIMTeam team) {
        // 加入群组成功
    }

    @Override
    public void onTeamLeft(V2NIMTeam team, boolean isKicked) {
        // 离开群组成功
    }

    @Override
    public void onTeamInfoUpdated(V2NIMTeam team) {
        // 群组信息更新回调
    }

    @Override
    public void onTeamMemberJoined(List<V2NIMTeamMember> teamMembers) {
        // 群组成员加入回调
    }

    @Override
    public void onTeamMemberKicked(String operatorAccountId, List<V2NIMTeamMember> teamMembers) {
        // 群组成员被踢回调
    }

    @Override
    public void onTeamMemberLeft(List<V2NIMTeamMember> teamMembers) {
        // 群组成员退出群组回调
    }

    @Override
    public void onTeamMemberInfoUpdated(List<V2NIMTeamMember> teamMembers) {
        // 群组成员信息更新回调
    }

    @Override
    public void onReceiveTeamJoinActionInfo(V2NIMTeamJoinActionInfo joinActionInfo) {
        // 入群操作回调
    }
};
v2TeamService.addTeamListener(listener);
iOS
objective-c[[[NIMSDK sharedSDK] v2TeamService] addTeamListener:self];
- (void)onSyncStarted{};

/**
 *  同步完成
 */
- (void)onSyncFinished{};

/**
 *  同步失败
 *
 *  @param error 错误
 */
- (void)onSyncFailed:(V2NIMError *)error{};

/**
 *  群组创建回调
 *
 *  @param team 新创建的群组
 */
- (void)onTeamCreated:(V2NIMTeam *)team{};

/**
 *  群组解散回调
 *
 *  @param team 解散的群组
 *
 *  @discussion 仅teamId和teamType字段有效
 */
- (void)onTeamDismissed:(V2NIMTeam *)team{};

/**
 *  加入群组回调
 *
 *  @param team 加入的群组
 */
- (void)onTeamJoined:(V2NIMTeam *)team{};

/**
 *  离开群组回调
 *
 *  @param team 离开的群组
 *  @param isKicked 是否被踢出群组
 *
 *  @discussion 主动离开群组或被管理员踢出群组
 */
- (void)onTeamLeft:(V2NIMTeam *)team
          isKicked:(BOOL)isKicked{};

/**
 *  群组信息更新回调
 *
 *  @param team 更新信息群组
 */
- (void)onTeamInfoUpdated:(V2NIMTeam *)team{};

/**
 *  群组成员加入回调
 *
 *  @param teamMembers 加入的群组成员列表
 */
- (void)onTeamMemberJoined:(NSArray<V2NIMTeamMember *> *)teamMembers{};

/**
 *  群组成员被踢回调
 *
 *  @param operatorAccountId 操作账号id
 *  @param teamMembers teamMembers的群组成员列表
 */
- (void)onTeamMemberKicked:(NSString *)operatorAccountId
               teamMembers:(NSArray<V2NIMTeamMember *> *)teamMembers{};

/**
 *  群组成员退出回调
 *
 *  @param teamMembers 退出的群组成员列表
 */
- (void)onTeamMemberLeft:(NSArray<V2NIMTeamMember *> *)teamMembers{};

/**
 *  群组成员信息变更回调
 *
 *  @param teamMembers 信息变更的群组成员列表
 */
- (void)onTeamMemberInfoUpdated:(NSArray<V2NIMTeamMember *> *)teamMembers{};

/**
 *  入群操作回调
 *
 *  @param joinActionInfo 入群操作信息
 */
- (void)onReceiveTeamJoinActionInfo:(V2NIMTeamJoinActionInfo *)joinActionInfo{};
macOS/Windows
cppV2NIMTeamListener listener;
listener.onSyncStarted = []() {
    // team sync started
};
listener.onSyncFinished = []() {
    // team sync finished
};
listener.onSyncFailed = [](V2NIMError error) {
    // team sync failed, handle error
};
listener.onTeamCreated = [](V2NIMTeam team) {
    // team created
};
listener.onTeamDismissed = [](nstd::vector<V2NIMTeam> teams) {
    // team dismissed
};
listener.onTeamJoined = [](V2NIMTeam team) {
    // team joined
};
listener.onTeamLeft = [](V2NIMTeam team, bool isKicked) {
    // team left
};
listener.onTeamInfoUpdated = [](V2NIMTeam team) {
    // team info updated
};
listener.onTeamMemberJoined = [](nstd::vector<V2NIMTeamMember> teamMembers) {
    // team member joined
};
listener.onTeamMemberKicked = [](nstd::string operateAccountId, nstd::vector<V2NIMTeamMember> teamMembers) {
    team member kicked
};
listener.onTeamMemberLeft = [](nstd::vector<V2NIMTeamMember> teamMembers) {
    // team member left
};
listener.onTeamMemberInfoUpdated = [](nstd::vector<V2NIMTeamMember> teamMembers) {
    // team member info updated
};
listener.onReceiveTeamJoinActionInfo = [](V2NIMTeamJoinActionInfo joinActionInfo) {
    // receive team join action info
};
teamService.addTeamListener(listener);

返回值

removeTeamListener

接口描述

移除群组相关监听器。

该方法为同步。

参数说明

Android
javavoid removeTeamListener(V2NIMTeamListener listener);
参数名称 类型 是否必填 默认值 描述
listener V2NIMTeamListener - 群组相关监听器
iOS
objective-c- (void)removeTeamListener:(id<V2NIMTeamListener>)listener;
参数名称 类型 是否必填 默认值 描述
listener V2NIMTeamListener - 群组相关监听器
macOS/Windows
cppvirtual void removeTeamListener(V2NIMTeamListener listener) = 0;
参数名称 类型 是否必填 默认值 描述
listener V2NIMTeamListener - 群组相关监听器

示例代码

Android
javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
v2TeamService.removeTeamListener(listener);
iOS
objective-c[[[NIMSDK sharedSDK] v2TeamService] removeTeamListener:self];
macOS/Windows
cppV2NIMTeamListener listener;
// ...
teamService.removeTeamListener(listener);

返回值

on("EventName")

接口描述

注册群组相关监听。

注册成功后,当事件发生时,SDK 会返回对应的回调。

  • 建议在初始化后调用该方法。

  • 全局只需注册一次。

  • 该方法为同步。

参数说明

Web/uni-app/小程序
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;
}
参数名称 类型 是否必填 默认值 描述
eventName V2NIMTeamListener - 事件名称:
  • onSyncStarted:群组信息同步开始回调,包括群组信息、群成员信息。
  • onSyncFinished:群组信息同步结束回调。如果群组信息同步已开始,建议在同步结束后进行群组相关操作(例如查询群组列表),否则可能导致数据不完整。
  • onSyncFailed:群组信息同步失败回调,返回 V2NIMError 错误码。收到该回调后进行群组相关操作可能导致数据不完整。
  • onTeamCreated:群组成功创建回调,返回 V2NIMTeam。当本地端或多端同步创建群组成功时会触发该回调。
  • onTeamDismissed:群组解散回调,返回 V2NIMTeam。当本地端或多端同步解散群组成功时会触发该回调。群组内所有成员均会收到该回调。
  • onTeamJoined:加入群组回调,返回 V2NIMTeam。当本地端或多端同步加入群组时会触发该回调。
  • onTeamLeft:离开群组回调,返回 V2NIMTeam。当本地端或多端主动离开群组或被踢出群组时会触发该回调。
  • onTeamInfoUpdated:群组信息更新回调,返回 V2NIMTeam。群组内所有成员均会收到该回调。
  • onTeamMemberJoined:成员加入群组回调,返回 V2NIMTeamMember。群组内所有成员均会收到该回调。
  • onTeamMemberKicked:群成员被踢出群组回调,返回 V2NIMTeamMember 列表。群组内所有成员均会收到该回调。
  • onTeamMemberLeft:群成员离开群组回调,返回 V2NIMTeamMember 列表。群组内所有成员均会收到该回调。
  • onTeamMemberInfoUpdated:群成员信息变更回调,返回 V2NIMTeamMember 列表。群组内所有成员均会收到该回调。
  • onReceiveTeamJoinActionInfo:收到入群操作信息回调,返回 V2NIMTeamJoinActionInfo
  • fn function - 监听事件的回调函数。当事件触发时,会调用该函数进行处理。
    Harmony
    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
    }
    
    参数名称 类型 是否必填 默认值 描述
    eventName V2NIMTeamListener - 事件名称:
  • onSyncStarted:群组信息同步开始回调,包括群组信息、群成员信息。
  • onSyncFinished:群组信息同步结束回调。如果群组信息同步已开始,建议在同步结束后进行群组相关操作(例如查询群组列表),否则可能导致数据不完整。
  • onSyncFailed:群组信息同步失败回调,返回 V2NIMError 错误码。收到该回调后进行群组相关操作可能导致数据不完整。
  • onTeamCreated:群组成功创建回调,返回 V2NIMTeam。当本地端或多端同步创建群组成功时会触发该回调。
  • onTeamDismissed:群组解散回调,返回 V2NIMTeam。当本地端或多端同步解散群组成功时会触发该回调。群组内所有成员均会收到该回调。
  • onTeamJoined:加入群组回调,返回 V2NIMTeam。当本地端或多端同步加入群组时会触发该回调。
  • onTeamLeft:离开群组回调,返回 V2NIMTeam。当本地端或多端主动离开群组或被踢出群组时会触发该回调。
  • onTeamInfoUpdated:群组信息更新回调,返回 V2NIMTeam。群组内所有成员均会收到该回调。
  • onTeamMemberJoined:成员加入群组回调,返回 V2NIMTeamMember。群组内所有成员均会收到该回调。
  • onTeamMemberKicked:群成员被踢出群组回调,返回 V2NIMTeamMember 列表。群组内所有成员均会收到该回调。
  • onTeamMemberLeft:群成员离开群组回调,返回 V2NIMTeamMember 列表。群组内所有成员均会收到该回调。
  • onTeamMemberInfoUpdated:群成员信息变更回调,返回 V2NIMTeamMember 列表。群组内所有成员均会收到该回调。
  • onReceiveTeamJoinActionInfo:收到入群操作信息回调,返回 V2NIMTeamJoinActionInfo
  • fn function - 监听事件的回调函数。当事件触发时,会调用该函数进行处理。

    示例代码

    Web/uni-app/小程序
    typescriptnim.V2NIMTeamService.on('onSyncStarted', () => { console.log("recv onSyncStarted") })
    nim.V2NIMTeamService.on('onSyncFinished', () => { console.log("recv onSyncFinished") })
    nim.V2NIMTeamService.on('onSyncFailed', (error) => { console.log("recv onSyncFailed", error) })
    nim.V2NIMTeamService.on('onTeamCreated', (team) => { console.log("recv onTeamCreated", team) })
    nim.V2NIMTeamService.on('onTeamJoined', (team) => { console.log("recv onTeamJoined", team) })
    nim.V2NIMTeamService.on('onTeamLeft', (team, isKicked) => { console.log("recv onTeamLeft", team, isKicked) })
    nim.V2NIMTeamService.on('onTeamInfoUpdated', (team) => { console.log("recv onTeamInfoUpdated", team) })
    nim.V2NIMTeamService.on('onTeamMemberJoined', (teamMembers) => { console.log("recv onTeamMemberJoined", teamMembers) })
    nim.V2NIMTeamService.on('onTeamMemberKicked', (operateAccountId, teamMembers) => { console.log("recv onTeamMemberKicked", operateAccountId, teamMembers) })
    nim.V2NIMTeamService.on('onTeamMemberLeft', (teamMembers) => { console.log("recv onTeamMemberLeft", teamMembers) })
    nim.V2NIMTeamService.on('onTeamMemberInfoUpdated', (teamMembers) => { console.log("recv onTeamMemberInfoUpdated", teamMembers) })
    nim.V2NIMTeamService.on('onReceiveTeamJoinActionInfo', (joinActionInfo) => { console.log("recv onReceiveTeamJoinActionInfo", joinActionInfo) })
    
    Harmony
    typescriptnim.teamService.on('onSyncStarted', () => { console.log("recv onSyncStarted") })
    nim.teamService.on('onSyncFinished', () => { console.log("recv onSyncFinished") })
    nim.teamService.on('onSyncFailed', (error) => { console.log("recv onSyncFailed", error) })
    nim.teamService.on('onTeamCreated', (team) => { console.log("recv onTeamCreated", team) })
    nim.teamService.on('onTeamDismissed', (team) => { console.log("recv onTeamDismissed", team) })
    nim.teamService.on('onTeamJoined', (team) => { console.log("recv onTeamJoined", team) })
    nim.teamService.on('onTeamLeft', (team, isKicked) => { console.log("recv onTeamLeft", team, isKicked) })
    nim.teamService.on('onTeamInfoUpdated', (team) => { console.log("recv onTeamInfoUpdated", team) })
    nim.teamService.on('onTeamMemberJoined', (teamMembers) => { console.log("recv onTeamMemberJoined", teamMembers) })
    nim.teamService.on('onTeamMemberKicked', (operateAccountId, teamMembers) => { console.log("recv onTeamMemberKicked", operateAccountId, teamMembers) })
    nim.teamService.on('onTeamMemberLeft', (teamMembers) => { console.log("recv onTeamMemberLeft", teamMembers) })
    nim.teamService.on('onTeamMemberInfoUpdated', (teamMembers) => { console.log("recv onTeamMemberInfoUpdated", teamMembers) })
    nim.teamService.on('onReceiveTeamJoinActionInfo', (joinActionInfo) => { console.log("recv onReceiveTeamJoinActionInfo", joinActionInfo) })
    

    返回值

    off("EventName")

    接口描述

    取消注册群组相关监听。

    该方法为同步。

    参数说明

    Web/uni-app/小程序
    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;
    }
    
    参数名称 类型 是否必填 默认值 描述
    eventName V2NIMTeamListener - 事件名称:
  • onSyncStarted:群组信息同步开始回调,包括群组信息、群成员信息。
  • onSyncFinished:群组信息同步结束回调。如果群组信息同步已开始,建议在同步结束后进行群组相关操作(例如查询群组列表),否则可能导致数据不完整。
  • onSyncFailed:群组信息同步失败回调,返回 V2NIMError 错误码。收到该回调后进行群组相关操作可能导致数据不完整。
  • onTeamCreated:群组成功创建回调,返回 V2NIMTeam。当本地端或多端同步创建群组成功时会触发该回调。
  • onTeamDismissed:群组解散回调,返回 V2NIMTeam。当本地端或多端同步解散群组成功时会触发该回调。群组内所有成员均会收到该回调。
  • onTeamJoined:加入群组回调,返回 V2NIMTeam。当本地端或多端同步加入群组时会触发该回调。
  • onTeamLeft:离开群组回调,返回 V2NIMTeam。当本地端或多端主动离开群组或被踢出群组时会触发该回调。
  • onTeamInfoUpdated:群组信息更新回调,返回 V2NIMTeam。群组内所有成员均会收到该回调。
  • onTeamMemberJoined:成员加入群组回调,返回 V2NIMTeamMember。群组内所有成员均会收到该回调。
  • onTeamMemberKicked:群成员被踢出群组回调,返回 V2NIMTeamMember 列表。群组内所有成员均会收到该回调。
  • onTeamMemberLeft:群成员离开群组回调,返回 V2NIMTeamMember 列表。群组内所有成员均会收到该回调。
  • onTeamMemberInfoUpdated:群成员信息变更回调,返回 V2NIMTeamMember 列表。群组内所有成员均会收到该回调。
  • onReceiveTeamJoinActionInfo:收到入群操作信息回调,返回 V2NIMTeamJoinActionInfo
  • fn function - 监听事件的回调函数。当事件触发时,会调用该函数进行处理。
    Harmony
    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
    }
    
    参数名称 类型 是否必填 默认值 描述
    eventName V2NIMTeamListener - 事件名称:
  • onSyncStarted:群组信息同步开始回调,包括群组信息、群成员信息。
  • onSyncFinished:群组信息同步结束回调。如果群组信息同步已开始,建议在同步结束后进行群组相关操作(例如查询群组列表),否则可能导致数据不完整。
  • onSyncFailed:群组信息同步失败回调,返回 V2NIMError 错误码。收到该回调后进行群组相关操作可能导致数据不完整。
  • onTeamCreated:群组成功创建回调,返回 V2NIMTeam。当本地端或多端同步创建群组成功时会触发该回调。
  • onTeamDismissed:群组解散回调,返回 V2NIMTeam。当本地端或多端同步解散群组成功时会触发该回调。群组内所有成员均会收到该回调。
  • onTeamJoined:加入群组回调,返回 V2NIMTeam。当本地端或多端同步加入群组时会触发该回调。
  • onTeamLeft:离开群组回调,返回 V2NIMTeam。当本地端或多端主动离开群组或被踢出群组时会触发该回调。
  • onTeamInfoUpdated:群组信息更新回调,返回 V2NIMTeam。群组内所有成员均会收到该回调。
  • onTeamMemberJoined:成员加入群组回调,返回 V2NIMTeamMember。群组内所有成员均会收到该回调。
  • onTeamMemberKicked:群成员被踢出群组回调,返回 V2NIMTeamMember 列表。群组内所有成员均会收到该回调。
  • onTeamMemberLeft:群成员离开群组回调,返回 V2NIMTeamMember 列表。群组内所有成员均会收到该回调。
  • onTeamMemberInfoUpdated:群成员信息变更回调,返回 V2NIMTeamMember 列表。群组内所有成员均会收到该回调。
  • onReceiveTeamJoinActionInfo:收到入群操作信息回调,返回 V2NIMTeamJoinActionInfo
  • fn function - 监听事件的回调函数。当事件触发时,会调用该函数进行处理。

    示例代码

    Web/uni-app/小程序
    typescript// remove one listeners
    nim.V2NIMTeamService.off("onSyncStarted")
    // remove all listeners
    nim.V2NIMTeamService.removeAllListeners()
    
    Harmony
    typescript// remove one listeners
    nim.teamService.off('onSyncStarted', theListner)
    nim.teamService.off('onSyncFinished', theListner)
    nim.teamService.off('onSyncFailed', theListner)
    nim.teamService.off('onTeamCreated', theListner)
    nim.teamService.off('onTeamDismissed', theListner)
    nim.teamService.off('onTeamJoined', theListner)
    nim.teamService.off('onTeamLeft', theListner)
    nim.teamService.off('onTeamInfoUpdated', theListner)
    nim.teamService.off('onTeamMemberJoined', theListner)
    nim.teamService.off('onTeamMemberKicked', theListner)
    nim.teamService.off('onTeamMemberLeft', theListner)
    nim.teamService.off('onTeamMemberInfoUpdated', theListner})
    nim.teamService.off('onReceiveTeamJoinActionInfo', theListner)
    // remove all listeners
    nim.teamService.removeAllListeners()
    

    返回值

    createTeam

    接口描述

    创建一个群组。支持创建高级群和超大群,二者区别详见群组概述

    本地端或多端同步创建成功后,SDK 会返回创建成功回调 onTeamCreated,并同步缓存和数据库。

    • 超大群功能需要额外开通。创建超大群前,请确保已在云信控制台开通该功能。
    • 客户端 SDK 不支持创建 2000 人以上的超大群,请调用服务端 API 创建群组

    参数说明

    Android
    javavoid createTeam(V2NIMCreateTeamParams createTeamParams, List<String> inviteeAccountIds, String postscript, V2NIMAntispamConfig antispamConfig, V2NIMSuccessCallback<V2NIMCreateTeamResult> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    createTeamParams V2NIMCreateTeamParams - 群组创建配置参数
    inviteeAccountIds List null 被邀请加入群组的成员列表,单次调用不超过 50 人。
    postscript String null 邀请入群附言
    antispamConfig V2NIMAntispamConfig null 易盾反垃圾相关配置。使用云信安全通无需配置该参数。
    success V2NIMSuccessCallback - 群组创建成功回调,返回 V2NIMCreateTeamResult
    failure V2NIMFailureCallback - 群组创建失败回调,返回错误码
    iOS
    objective-c- (void)createTeam:(V2NIMCreateTeamParams *)createTeamParams
     inviteeAccountIds:(nullable NSArray<NSString *> *)inviteeAccountIds
            postscript:(nullable NSString *)postscript
        antispamConfig:(nullable V2NIMAntispamConfig *)antispamConfig
               success:(nullable V2NIMCreateTeamResultCallback)success
               failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    createTeamParams V2NIMCreateTeamParams - 群组创建配置参数
    inviteeAccountIds NSArray<NSString *> * null 被邀请加入群组的成员列表,单次调用不超过 50 人。
    postscript NSString * null 邀请入群附言
    antispamConfig V2NIMAntispamConfig null 易盾反垃圾相关配置。使用云信安全通无需配置该参数。
    success V2NIMCreateTeamResultCallback - 群组创建成功回调,可自定义设置。
    failure V2NIMFailureCallback - 群组创建失败回调,返回错误码
    macOS/Windows
    cppvirtual void createTeam(V2NIMCreateTeamParams createTeamParams,
                            std::vector<std::string> inviteeAccountIds,
                            std::string postscript,
                            V2NIMAntispamConfig antispamConfig,
                            V2NIMSuccessCallback<V2NIMCreateTeamResult> success,
                            V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    createTeamParams V2NIMCreateTeamParams - 群组创建配置参数
    inviteeAccountIds vector<std::string> null 被邀请加入群组的成员列表,单次调用不超过 50 人。
    postscript string null 邀请入群附言
    antispamConfig V2NIMAntispamConfig null 易盾反垃圾相关配置。使用云信安全通无需配置该参数。
    success V2NIMSuccessCallback - 群组创建成功回调,返回 V2NIMCreateTeamResult
    failure V2NIMFailureCallback - 群组创建失败回调,返回错误码
    Web/uni-app/小程序
    typescriptcreateTeam(
      createTeamParams: V2NIMCreateTeamParams,
      inviteeAccountIds?: string[],
      postscript?: string,
      antispamConfig?: V2NIMAntispamConfig
    ): Promise<V2NIMCreateTeamResult>
    
    参数名称 类型 是否必填 默认值 描述
    createTeamParams V2NIMCreateTeamParams - 群组创建配置参数
    inviteeAccountIds string[] null 被邀请加入群组的成员列表,单次调用不超过 50 人。
    postscript string null 邀请入群附言
    antispamConfig V2NIMAntispamConfig null 易盾反垃圾相关配置。使用云信安全通无需配置该参数。
    Harmony
    typescriptcreateTeam(
      createTeamParams: V2NIMCreateTeamParams,
      inviteeAccountIds?: string[],
      postscript?: string,
      antispamConfig?: V2NIMAntispamConfig
    ): Promise<V2NIMCreateTeamResult>
    
    参数名称 类型 是否必填 默认值 描述
    createTeamParams V2NIMCreateTeamParams - 群组创建配置参数
    inviteeAccountIds string[] null 被邀请加入群组的成员列表,单次调用不超过 50 人。
    postscript string null 邀请入群附言
    antispamConfig V2NIMAntispamConfig null 易盾反垃圾相关配置。使用云信安全通无需配置该参数。

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    // 创建群组参数
    V2NIMCreateTeamParams createTeamParams = new V2NIMCreateTeamParams();
    createTeamParams.setName("test");
    createTeamParams.setTeamType(V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL);
    createTeamParams.setMemberLimit(100);
    createTeamParams.setIntro("test");
    createTeamParams.setAnnouncement("test");
    createTeamParams.setAvatar("http://test.png");
    createTeamParams.setServerExtension("test");
    createTeamParams.setAgreeMode(V2NIMTeamAgreeMode.V2NIM_TEAM_AGREE_MODE_AUTH);
    createTeamParams.setJoinMode(V2NIMTeamJoinMode.V2NIM_TEAM_JOIN_MODE_INVITE);
    createTeamParams.setInviteMode(V2NIMTeamInviteMode.V2NIM_TEAM_INVITE_MODE_MANAGER);
    createTeamParams.setUpdateInfoMode(V2NIMTeamUpdateInfoMode.V2NIM_TEAM_UPDATE_INFO_MODE_MANAGER);
    createTeamParams.setUpdateExtensionMode(V2NIMTeamUpdateExtensionMode.V2NIM_TEAM_UPDATE_EXTENSION_MODE_MANAGER);
    // 创建群组时,同时被邀请加入群的成员列表
    List<String> inviteeAccountIds = new ArrayList<>();
    inviteeAccountIds.add("test1");
    inviteeAccountIds.add("test2");
    String postscript = "test";
    // 易盾反垃圾配置,如果不审核,该配置不需要配置;如果开启了安全通,默认采用安全通,该配置不需要配置;如果需要审核,且直接对接易盾,则配置该配置
    V2NIMAntispamConfig antispamConfig = null;
    v2TeamService.createTeam(createTeamParams, inviteeAccountIds, postscript, antispamConfig, result -> {
        // 创建群组成功
    }, error -> {
        // 创建群组失败
    });
    
    iOS
    objective-cV2NIMCreateTeamParams *teamParams = [V2NIMCreateTeamParams new];
        teamParams.name = @"test";
        teamParams.teamType = V2NIM_TEAM_TYPE_NORMAL;
        teamParams.memberLimit = 100;
        teamParams.intro = @"test";
        teamParams.announcement = @"test";
        teamParams.avatar = @"http://test.png";
        teamParams.agreeMode = V2NIM_TEAM_AGREE_MODE_AUTH;
        teamParams.joinMode = V2NIM_TEAM_JOIN_MODE_FREE;
        teamParams.inviteMode = V2NIM_TEAM_INVITE_MODE_MANAGER;
        teamParams.updateInfoMode = V2NIM_TEAM_UPDATE_INFO_MODE_MANAGER;
        teamParams.updateExtensionMode = V2NIM_TEAM_UPDATE_EXTENSION_MODE_MANAGER;
        V2NIMAntispamConfig *config = [V2NIMAntispamConfig new];
        [[[NIMSDK sharedSDK] v2TeamService] createTeam:teamParams inviteeAccountIds:@[@"test1",@"test2"] postscript:@"test" antispamConfig:config success:^(V2NIMCreateTeamResult * _Nonnull result) {
                // 群组创建成功
            } failure:^(V2NIMError * _Nonnull error) {
                // 群组创建失败
            }];
    
    macOS/Windows
    cppV2NIMCreateTeamParams createTeamParams;
    createTeamParams.name = "teamName";
    nstd::vector<nstd::string> inviteeAccountIds;
    inviteeAccountIds.push_back("account1");
    V2NIMAntispamConfig antispamConfig;
    teamService.createTeam(
        createTeamParams,
        inviteeAccountIds,
        "postscript",
        antispamConfig,
        [](nstd::vector<V2NIMMessage> messages) {
            for (auto&& message : messages) {
                // do something
            }
        },
        [](V2NIMError error) {
            // get message list failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.createTeam(
      {
        "name": "群名",
        "teamType": 1,
        "memberLimit": 200,
      }
    )
    
    Harmony
    typescripttry {  
        const params: V2NIMCreateTeamParams = {
        name: this.name,
        teamType: this.teamType,
        memberLimit: this.memberLimit,
        intro: this.intro,
        announcement: this.announcement,
        avatar: this.avatar,
        serverExtension: this.serverExtension,
        joinMode: this.joinMode,
        agreeMode: this.agreeMode,
        inviteMode: this.inviteMode,
        updateInfoMode: this.updateInfoMode,
        updateExtensionMode: this.updateExtensionMode,
        chatBannedMode: this.chatBannedMode
      }
    
      const result:V2NIMCreateTeamResult = await nim.teamService.createTeam(params, [], '')
      // success
    } catch (error) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<V2NIMCreateTeamResult> 群组创建结果

    相关回调

    Android/iOS/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调,包含 V2NIMCreateTeamResult;创建成功,返回 onTeamCreated 回调。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    iOS
    • 请求成功,返回 V2NIMCreateTeamResultCallback 回调,可自定义设置;创建成功,返回 onTeamCreated 回调。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    创建成功,返回 onTeamCreated 回调。

    leaveTeam

    接口描述

    退出指定群组。

    本地端或多端同步退出群组成功后:

    • 本端 SDK 会触发退出群组回调 onTeamLeft
    • 群组内所有成员会收到通知消息,通知消息类型为 V2NIMMessageNotificationType.V2NIM_MESSAGE_NOTIFICATION_TYPE_TEAM_LAVE(2);以及 onTeamMemberLeft 回调。

    参数说明

    Android
    javavoid leaveTeam(String teamId, V2NIMTeamType teamType,V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    teamId String - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    success V2NIMSuccessCallback - 离开群组成功回调
    failure V2NIMFailureCallback - 离开群组失败回调,返回错误码
    iOS
    objective-c- (void)leaveTeam:(NSString *)teamId
             teamType:(V2NIMTeamType)teamType
              success:(nullable V2NIMSuccessCallback)success
              failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    teamId NSString * - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    success V2NIMSuccessCallback - 离开群组成功回调
    failure V2NIMFailureCallback - 离开群组失败回调,返回错误码
    macOS/Windows
    cppvirtual void leaveTeam(nstd::string teamId, V2NIMTeamType teamType, V2NIMSuccessCallback<void> success, V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    teamId nstd::string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    success V2NIMSuccessCallback - 离开群组成功回调
    failure V2NIMFailureCallback - 离开群组失败回调,返回错误码
    Web/uni-app/小程序
    typescriptleaveTeam(teamId: string, teamType: V2NIMTeamType): Promise<V2NIMLeaveTeamResult>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    Harmony
    typescriptleaveTeam(teamId: string, teamType: V2NIMTeamType): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    String teamId = "123456";
    V2NIMTeamType teamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL;
    v2TeamService.leaveTeam(teamId,teamType, result -> {
        // 离开群组成功
    }, error -> {
        // 离开群组失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] leaveTeam:@"teamId" teamType:V2NIM_TEAM_TYPE_NORMAL success:^{
            // 离开群组成功
        } failure:^(V2NIMError * _Nonnull error) {
            // 离开群组失败
        }];
    
    macOS/Windows
    cppteamService.leaveTeam(
        "teamId",
        V2NIM_TEAM_TYPE_NORMAL,
        []() {
            // leave team success
        },
        [](V2NIMError error) {
            // leave team failed, handle error
        }
    );
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.leaveTeam("123456", 1)
    
    Harmony
    typescriptconst teamId = "123456"
    const teamType: V2NIMTeamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL
    try {
      await nim.teamService.leaveTeam(teamId, teamType)
      // success
    } catch (error) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<void>

    相关回调

    Android/iOS/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调;退出群组成功,返回 onTeamLeft 回调。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    退出群组成功,返回 onTeamLeft 回调。

    updateTeamInfo

    接口描述

    更新指定群组信息。

    本地端或多端同步更新成功后,群组内所有成员会收到群组信息变更回调 onTeamInfoUpdated,以及群组信息更新的通知消息,通知消息类型为 V2NIM_MESSAGE_NOTIFICATION_TYPE_TEAM_UPDATE_TINFO(3)

    更新前请确保该群组已存在。

    参数说明

    Android
    javavoid updateTeamInfo(String teamId, V2NIMTeamType teamType, V2NIMUpdateTeamInfoParams updateTeamInfoParams, V2NIMAntispamConfig antispamConfig,V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    teamId String - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    updateTeamInfoParams V2NIMUpdateTeamInfoParams - 群组信息更新配置参数
    antispamConfig V2NIMAntispamConfig null 易盾反垃圾相关配置。使用云信安全通无需配置该参数。
    success V2NIMSuccessCallback - 更新群组信息成功回调
    failure V2NIMFailureCallback - 更新群组信息失败回调,返回错误码
    iOS
    objective-c- (void)updateTeamInfo:(NSString *)teamId
                  teamType:(V2NIMTeamType)teamType
      updateTeamInfoParams:(V2NIMUpdateTeamInfoParams *)updateTeamInfoParams
            antispamConfig:(nullable V2NIMAntispamConfig *)antispamConfig
                   success:(nullable V2NIMSuccessCallback)success
                   failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    teamId NSString * - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    updateTeamInfoParams V2NIMUpdateTeamInfoParams - 群组信息更新配置参数
    antispamConfig V2NIMAntispamConfig null 易盾反垃圾相关配置。使用云信安全通无需配置该参数。
    success V2NIMSuccessCallback - 更新群组信息成功回调
    failure V2NIMFailureCallback - 更新群组信息失败回调,返回错误码
    macOS/Windows
    cppvirtual void updateTeamInfo(std::string teamId,
                                V2NIMTeamType teamType,
                                V2NIMUpdateTeamInfoParams updateTeamInfoParams,
                                V2NIMAntispamConfig antispamConfig,
                                V2NIMSuccessCallback<void> success,
                                V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    teamId std::string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    updateTeamInfoParams V2NIMUpdateTeamInfoParams - 群组信息更新配置参数
    antispamConfig V2NIMAntispamConfig null 易盾反垃圾相关配置。使用云信安全通无需配置该参数。
    success V2NIMSuccessCallback - 更新群组信息成功回调
    failure V2NIMFailureCallback - 更新群组信息失败回调,返回错误码
    Web/uni-app/小程序
    typescriptupdateTeamInfo(teamId: string, teamType: V2NIMTeamType, updateTeamInfoParams: V2NIMUpdateTeamInfoParams, antispamConfig?: V2NIMAntispamConfig): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    updateTeamInfoParams V2NIMUpdateTeamInfoParams - 群组信息更新配置参数
    antispamConfig V2NIMAntispamConfig null 易盾反垃圾相关配置。使用云信安全通无需配置该参数。
    Harmony
    typescriptupdateTeamInfo(teamId: string, teamType: V2NIMTeamType, updateTeamInfoParams: V2NIMUpdateTeamInfoParams, antispamConfig?: V2NIMAntispamConfig): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    updateTeamInfoParams V2NIMUpdateTeamInfoParams - 群组信息更新配置参数
    antispamConfig V2NIMAntispamConfig null 易盾反垃圾相关配置。使用云信安全通无需配置该参数。

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    String teamId = "123456";
    V2NIMTeamType teamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL;
    V2NIMUpdateTeamInfoParams updateTeamInfoParams = new V2NIMUpdateTeamInfoParams();
    updateTeamInfoParams.setName("test_update");
    updateTeamInfoParams.setMemberLimit(100);
    updateTeamInfoParams.setIntro("test");
    updateTeamInfoParams.setAnnouncement("test");
    updateTeamInfoParams.setAvatar("http://test.png");
    updateTeamInfoParams.setServerExtension("test");
    updateTeamInfoParams.setAgreeMode(V2NIMTeamAgreeMode.V2NIM_TEAM_AGREE_MODE_AUTH);
    updateTeamInfoParams.setJoinMode(V2NIMTeamJoinMode.V2NIM_TEAM_JOIN_MODE_INVITE);
    updateTeamInfoParams.setInviteMode(V2NIMTeamInviteMode.V2NIM_TEAM_INVITE_MODE_MANAGER);
    updateTeamInfoParams.setUpdateInfoMode(V2NIMTeamUpdateInfoMode.V2NIM_TEAM_UPDATE_INFO_MODE_MANAGER);
    updateTeamInfoParams.setUpdateExtensionMode(V2NIMTeamUpdateExtensionMode.V2NIM_TEAM_UPDATE_EXTENSION_MODE_MANAGER);
    // 易盾反垃圾配置,如果不审核,该配置不需要配置;如果开启了安全通,默认采用安全通,该配置不需要配置;如果需要审核,且直接对接易盾,则配置该配置
    V2NIMAntispamConfig antispamConfig = null;
    v2TeamService.updateTeamInfo(teamId,teamType, updateTeamInfoParams, antispamConfig, result -> {
        // 修改群组信息成功
    }, error -> {
        // 修改群组信息失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] updateTeamInfo:@"teamId" teamType:V2NIM_TEAM_TYPE_NORMAL updateTeamInfoParams:infoParams antispamConfig:config success:^{
        // 修改群组信息成功
    } failure:^(V2NIMError * _Nonnull error) {
        // 修改群组信息失败
    }];
    
    macOS/Windows
    cppV2NIMUpdateTeamInfoParams updateTeamInfoParams;
    updateTeamInfoParams.name = "new team name";
    V2NIMAntispamConfig antispamConfig;
    teamService.updateTeamInfo(
        "teamId",
        V2NIM_TEAM_TYPE_NORMAL,
        updateTeamInfoParams,
        antispamConfig,
        []() {
            // update team info success
        },
        [](V2NIMError error) {
            // update team info failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.updateTeamInfo(
      "123456",
      1,
      {
        "name": "群名1",
        "memberLimit": 200,
        "joinMode": 0,
        "agreeMode": 0,
        "inviteMode": 0,
        "updateInfoMode": 0,
        "updateExtensionMode": 0,
        "chatBannedMode": 0
      }
    )
    
    Harmony
    typescripttry {
      console.info(`-----------update team----------- \n`)
      const params: V2NIMUpdateTeamInfoParams = {
        name: this.name,
        memberLimit: this.memberLimit,
        intro: this.intro,
        announcement: this.announcement,
        avatar: this.avatar,
        serverExtension: this.serverExtension,
        joinMode: this.joinMode,
        agreeMode: this.agreeMode,
        inviteMode: this.inviteMode,
        updateInfoMode: this.updateInfoMode,
        updateExtensionMode: this.updateExtensionMode,
      }
    
      await nim.teamService.updateTeamInfo(this.teamId, this.teamType, params )
      // success
    } catch (error) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<void>

    相关回调

    Android/iOS/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调;更新成功,返回 onTeamInfoUpdated 回调。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    更新成功,返回 onTeamInfoUpdated 回调。

    getTeamInfo

    接口描述

    获取指定的单个群组信息。

    参数说明

    Android
    javavoid getTeamInfo(String teamId, V2NIMTeamType teamType,V2NIMSuccessCallback<V2NIMTeam> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    teamId String - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    success V2NIMSuccessCallback - 获取成功回调,返回 V2NIMTeam
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    iOS
    objective-c- (void)getTeamInfo:(NSString *)teamId
               teamType:(V2NIMTeamType)teamType
                success:(nullable V2NIMTeamInfoCallback)success
                failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    teamId NSString * - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    success V2NIMTeamInfoCallback - 获取成功回调,可自定义设置。
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    macOS/Windows
    cppvirtual void getTeamInfo(nstd::string teamId, V2NIMTeamType teamType, V2NIMSuccessCallback<V2NIMTeam> success, V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    teamId nstd::string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    success V2NIMSuccessCallback - 获取成功回调,返回 V2NIMTeam
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    Web/uni-app/小程序
    typescriptgetTeamInfo(teamId: string, teamType: V2NIMTeamType): Promise<V2NIMTeam>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    Harmony
    typescriptgetTeamInfo(teamId: string, teamType: V2NIMTeamType): Promise<V2NIMTeam>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    String teamId = "123456";
    V2NIMTeamType teamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL;
    v2TeamService.getTeamInfo(teamId,teamType, result -> {
        // 获取群组信息成功
    }, error -> {
        // 获取群组信息失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] getTeamInfo:@"teamId" teamType:V2NIM_TEAM_TYPE_NORMAL success:^(V2NIMTeam * _Nonnull team) {
        // 获取群组信息成功
    } failure:^(V2NIMError * _Nonnull error) {
        // 获取群组信息失败
    }];
    
    macOS/Windows
    cppteamService.getTeamInfo(
        "teamId",
        V2NIM_TEAM_TYPE_NORMAL,
        [](V2NIMTeam team) {
            // get team info success
        },
        [](V2NIMError error) {
            // get team info failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.getTeamInfo("123456", 1)
    
    Harmony
    typescriptconst teamId = "123456"
    const teamType: V2NIMTeamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL
    try {
      const team: V2NIMTeam = await nim.teamService.getTeamInfo(teamId, teamType)
      // success
    } catch (error) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<V2NIMTeam> 群组信息

    相关回调

    Android/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调,包含 V2NIMTeam
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    iOS
    • 请求成功,返回 V2NIMTeamInfoCallback 回调,可自定义设置。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    getTeamInfoByIds

    接口描述

    根据群组 ID 批量获取群组信息列表(包含已退出或已被解散的群组)。

    SDK 获取策略如下:

    查询引用消息.drawio.png

    群组数据同步(V2NIMTeamListener.onSyncFinished)完成前,可能获取不到完整数据。

    参数说明

    Android
    javavoid getTeamInfoByIds(List<String> teamIds, V2NIMTeamType teamType,V2NIMSuccessCallback<List<V2NIMTeam>> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    teamIds List - 群组 ID 列表,不可为空,否则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    success V2NIMSuccessCallback - 获取成功回调,返回 List<V2NIMTeam>。
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    iOS
    objective-c- (void)getTeamInfoByIds:(NSArray<NSString *> *)teamIds
                    teamType:(V2NIMTeamType)teamType
                     success:(nullable V2NIMTeamInfoListCallback)success
                     failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    teamIds NSArray<NSString *> * - 群组 ID 列表,不可为空,否则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    success V2NIMTeamInfoListCallback - 获取成功回调,可自定义设置。
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    macOS/Windows
    cppvirtual void getTeamInfoByIds(std::vector<std::string> teamIds,
        V2NIMTeamType teamType,
        V2NIMSuccessCallback<std::vector<V2NIMTeam>> success,
        V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    teamIds std::vectorstd::string - 群组 ID 列表,不可为空,否则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    success V2NIMSuccessCallback - 获取成功回调,返回 std::vector<V2NIMTeam>。
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    Web/uni-app/小程序
    typescriptgetTeamInfoByIds(teamIds: string[], teamType: V2NIMTeamType): Promise<V2NIMTeam[]>
    
    参数名称 类型 是否必填 默认值 描述
    teamIds string[] - 群组 ID 列表,不可为空,否则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    Harmony
    typescriptgetTeamInfoByIds(teamIds: string[], teamType: V2NIMTeamType): Promise<V2NIMTeam[]>
    
    参数名称 类型 是否必填 默认值 描述
    teamIds string[] - 群组 ID 列表,不可为空,否则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    List<String> teamIds = new ArrayList<>();
    teamIds.add("123456");
    teamIds.add("654321");
    V2NIMTeamType teamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL;
    v2TeamService.getTeamInfoByIds(teamIds,teamType, result -> {
        // 根据群组ID获取群组信息成功
    }, error -> {
        // 根据群组ID获取群组信息失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService]getTeamInfoByIds:@[@"teamId1",@"teamId2"] teamType:V2NIM_TEAM_TYPE_NORMAL success:^(NSArray<V2NIMTeam *> * _Nonnull teamList) {
            // 根据群组ID获取群组信息成功
        } failure:^(V2NIMError * _Nonnull error) {
            // 根据群组ID获取群组信息失败
        }];
    
    macOS/Windows
    cppnstd::vector<nstd::string> teamIds;
    teamIds.push_back("teamId1");
    teamIds.push_back("teamId2");
    teamService.getTeamInfoByIds(
        teamIds,
        V2NIM_TEAM_TYPE_NORMAL,
        [](nstd::vector<V2NIMTeam> teamList) {
            // get team info success
        },
        [](V2NIMError error) {
            // get team info failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.getTeamInfoByIds(["123456"], 1)
    
    Harmony
    typescriptconst teamIds = ["123456", "7890"]
    const teamType: V2NIMTeamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL
    try {
      const teams: V2NIMTeam[] = await nim.teamService.getTeamInfoByIds(teamIds, teamType)
      // success
    } catch (error) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<V2NIMTeam[]> 群组信息列表

    相关回调

    Android/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调,包含 V2NIMTeam 列表。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    iOS
    • 请求成功,返回 V2NIMTeamInfoListCallback 回调,可自定义设置。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    dismissTeam

    接口描述

    解散指定群组。

    本地端或多端同步解散群组成功后:

    • 本地端 SDK 会返回删除成功回调 onTeamDismissed
    • 群组内所有成员会收到通知消息,通知消息类型为 V2NIMMessageNotificationType.V2NIM_MESSAGE_NOTIFICATION_TYPE_TEAM_DISMISS(4)

    仅允许群主调用该接口,否则返回错误码 109427。

    参数说明

    Android
    javavoid dismissTeam(String teamId, V2NIMTeamType teamType,V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    teamId String - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    success V2NIMSuccessCallback - 解散群组成功回调
    failure V2NIMFailureCallback - 解散群组失败回调,返回错误码
    iOS
    objective-c- (void)dismissTeam:(NSString *)teamId
               teamType:(V2NIMTeamType)teamType
                success:(nullable V2NIMSuccessCallback)success
                failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    teamId NSString * - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    success V2NIMSuccessCallback - 解散群组成功回调
    failure V2NIMFailureCallback - 解散群组失败回调,返回错误码
    macOS/Windows
    cppvirtual void dismissTeam(nstd::string teamId, V2NIMTeamType teamType, V2NIMSuccessCallback<void> success, V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    teamId nstd::string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    success V2NIMSuccessCallback - 解散群组成功回调
    failure V2NIMFailureCallback - 解散群组失败回调,返回错误码
    Web/uni-app/小程序
    typescriptdismissTeam(teamId: string, teamType: V2NIMTeamType): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    Harmony
    typescriptdismissTeam(teamId: string, teamType: V2NIMTeamType): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    String teamId = "123456";
    V2NIMTeamType teamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL;
    v2TeamService.dismissTeam(teamId,teamType, result -> {
        // 解散群组成功
    }, error -> {
        // 解散群组失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] dismissTeam:@"teamId" teamType:V2NIM_TEAM_TYPE_NORMAL success:^{
        // 解散群组成功
    } failure:^(V2NIMError * _Nonnull error) {
        // 解散群组失败
    }];
    
    macOS/Windows
    cppteamService.dismissTeam(
        "teamId",
        V2NIM_TEAM_TYPE_NORMAL,
        []() {
            // dismiss team success
        },
        [](V2NIMError error) {
            // dismiss team failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.dismissTeam("123456", 1)
    
    Harmony
    typescriptconst teamId = "123456"
    const teamType: V2NIMTeamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL
    try {
      await nim.teamService.dismissTeam(teamId, teamType)
      // success
    } catch (error) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<void>

    相关回调

    Android/iOS/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调;解散成功,返回 onTeamDismissed 回调。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    删除成功,返回 onTeamDismissed 回调。

    inviteMember

    接口描述

    邀请用户加入群组。

    本地端或多端同步邀请成功后,群组内其他成员收到一条通知类消息,类型为 V2NIMMessageNotificationType.V2NIM_MESSAGE_NOTIFICATION_TYPE_TEAM_INVITE。根据创建群组时设置的被邀请方同意模式,有以下回调场景:

    参数说明

    Android
    javavoid inviteMember(String teamId, V2NIMTeamType teamType, List<String> inviteeAccountIds, String postscript,V2NIMSuccessCallback<List<String>> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    teamId String - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    inviteeAccountIds List - 被邀请入群的用户账号列表。不可为空,否则返回 191004 参数错误。
    postscript String null 邀请入群附言。
    success V2NIMSuccessCallback - 邀请入群成功回调,返回邀请失败的用户账号列表。
    failure V2NIMFailureCallback - 邀请入群失败回调,返回错误码
    iOS
    objective-c- (void)inviteMember:(NSString *)teamId
                teamType:(V2NIMTeamType)teamType
       inviteeAccountIds:(NSArray<NSString *> *)inviteeAccountIds
              postscript:(nullable NSString *)postscript
                 success:(nullable V2NIMTeamInviteMemberCallback)success
                 failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    teamId NSString * - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    inviteeAccountIds NSArray<NSString *> * - 被邀请入群的用户账号列表。不可为空,否则返回 191004 参数错误。
    postscript NSString * null 邀请入群附言。
    success V2NIMTeamInviteMemberCallback - 邀请入群成功回调,可自定义设置。
    failure V2NIMFailureCallback - 邀请入群失败回调,返回错误码
    macOS/Windows
    cppvirtual void inviteMember(nstd::string teamId,
                              V2NIMTeamType teamType,
                              nstd::vector<nstd::string> inviteeAccountIds,
                              nstd::string postscript,
                              V2NIMSuccessCallback<nstd::vector<nstd::string>> success,
                              V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    teamId nstd::string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    inviteeAccountIds nstd::vectornstd::string - 被邀请入群的用户账号列表。不可为空,否则返回 191004 参数错误。
    postscript nstd::string null 邀请入群附言。
    success V2NIMSuccessCallback - 邀请入群成功回调,返回邀请失败的用户账号列表。
    failure V2NIMFailureCallback - 邀请入群失败回调,返回错误码
    Web/uni-app/小程序
    typescriptinviteMember(teamId: string, teamType: V2NIMTeamType, inviteeAccountIds: string[], postscript?: string): Promise<string[]>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    inviteeAccountIds string[] - 被邀请入群的用户账号列表。不可为空,否则返回 191004 参数错误。
    postscript string null 邀请入群附言。
    Harmony
    typescriptinviteMember(teamId: string, teamType: V2NIMTeamType, inviteeAccountIds: string[], postscript?: string): Promise<string[]>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    inviteeAccountIds string[] - 被邀请入群的用户账号列表。不可为空,否则返回 191004 参数错误。
    postscript string null 邀请入群附言。

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    String teamId = "123456";
    V2NIMTeamType teamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL;
    List<String> inviteeAccountIds = new ArrayList<>();
    inviteeAccountIds.add("test1");
    inviteeAccountIds.add("test2");
    String postscript = "test";
    v2TeamService.inviteMember(teamId,teamType, inviteeAccountIds, postscript, result -> {
        // 邀请成员加入群组成功
    }, error -> {
        // 邀请成员加入群组失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] inviteMember:@"teamId" teamType:V2NIM_TEAM_TYPE_NORMAL inviteeAccountIds:@[@"accountId1"] postscript:@"test" success:^(NSArray<NSString *> * _Nonnull failedList) {
            // 邀请成员加入群组成功
        } failure:^(V2NIMError * _Nonnull error) {
            // 邀请成员加入群组失败
        }];
    
    macOS/Windows
    cppnstd::vector<nstd::string> inviteeAccountIds;
    inviteeAccountIds.push_back("account1");
    teamService.inviteMember(
        "teamId",
        V2NIM_TEAM_TYPE_NORMAL,
        inviteeAccountIds,
        "postscript",
        [](nstd::vector<nstd::string> failedList) {
            // invite member success
        },
        [](V2NIMError error) {
            // invite member failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.inviteMember("123456", 1, ["accountId1"])
    
    Harmony
    typescripttry {
      const teamId: string = "123456"
      const teamType: V2NIMTeamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL
      const inviteeAccountIds: string[] = ["acc1", "acc2"]
      const postscript: string | undefined = "postscript"
    
      const res = await teamService.inviteMember(teamId, teamType, inviteeAccountIds, postscript)
      // success
    }
    catch (err) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<string[]> 邀请失败的用户账号(accountId)列表

    相关回调

    Android/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调,包含邀请失败的用户账号(accountId)列表。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    iOS
    • 请求成功,返回 V2NIMTeamInviteMemberCallback 回调,包含邀请失败的用户账号(accountId)列表,可自定义设置。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    acceptInvitation

    接口描述

    接受入群邀请。

    本地端或多端同步接受入群邀请成功后:

    参数说明

    Android
    javavoid acceptInvitation(V2NIMTeamJoinActionInfo invitationInfo,V2NIMSuccessCallback<V2NIMTeam> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    invitationInfo V2NIMTeamJoinActionInfo - 邀请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_INVITATION,否则返回 191004 参数错误。
    success V2NIMSuccessCallback - 接受入群邀请成功回调,返回 V2NIMTeam
    failure V2NIMFailureCallback - 接受入群邀请失败回调,返回错误码
    iOS
    objective-c- (void)acceptInvitation:(V2NIMTeamJoinActionInfo *)invitationInfo
                     success:(nullable V2NIMTeamInfoCallback)success
                     failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    invitationInfo V2NIMTeamJoinActionInfo - 邀请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_INVITATION,否则返回 191004 参数错误。
    success V2NIMTeamInfoCallback - 接受入群邀请成功回调,返回 V2NIMTeam,可自定义设置。
    failure V2NIMFailureCallback - 接受入群邀请失败回调,返回错误码
    macOS/Windows
    cppvirtual void acceptInvitation(V2NIMTeamJoinActionInfo invitationInfo, V2NIMSuccessCallback<V2NIMTeam> success, V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    invitationInfo V2NIMTeamJoinActionInfo - 邀请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_INVITATION,否则返回 191004 参数错误。
    success V2NIMSuccessCallback - 接受入群邀请成功回调,返回 V2NIMTeam
    failure V2NIMFailureCallback - 接受入群邀请失败回调,返回错误码
    Web/uni-app/小程序
    typescriptacceptInvitation(invitationInfo: V2NIMTeamJoinActionInfo): Promise<V2NIMTeam>
    
    参数名称 类型 是否必填 默认值 描述
    invitationInfo V2NIMTeamJoinActionInfo - 邀请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_INVITATION,否则返回 191004 参数错误。
    Harmony
    typescriptacceptInvitation(invitationInfo: V2NIMTeamJoinActionInfo): Promise<V2NIMTeam>
    
    参数名称 类型 是否必填 默认值 描述
    invitationInfo V2NIMTeamJoinActionInfo - 邀请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_INVITATION,否则返回 191004 参数错误。

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    // 收到的邀请信息
    V2NIMTeamJoinActionInfo invitationInfo = getInvitationInfo();
    v2TeamService.acceptInvitation(invitationInfo, result -> {
        // 同意邀请入群成功
    }, error -> {
        // 同意邀请入群失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] acceptInvitation:invitationInfo success:^(V2NIMTeam * _Nonnull team) {
        // 同意邀请入群成功
    } failure:^(V2NIMError * _Nonnull error) {
        // 同意邀请入群失败
    }];
    
    macOS/Windows
    cppV2NIMTeamJoinActionInfo invitationInfo;
    // get invitationInfo from notification or query
    // ...
    teamService.acceptInvitation(
        invitationInfo,
        [](V2NIMTeam team) {
            // accept invitation success
        },
        [](V2NIMError error) {
            // accept invitation failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.acceptInvitation(
      {
        "teamId": "123456",
        "teamType": 1,
        "operatorAccountId": "accountId1",
        "actionType": 2
      }
    )
    
    Harmony
    typescripttry{
      const invitationInfo: V2NIMTeamJoinActionInfo = {
        actionType: V2NIMTeamJoinActionType.V2NIM_TEAM_JOIN_ACTION_TYPE_INVITATION,
        teamId: "123456",
        teamType: V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL,
        operatorAccountId: "account1",
      }
      
      const team: V2NIMTeam = await nim.teamService.acceptInvitation(invitationInfo)
      // success
    }
    catch (err) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<V2NIMTeam>

    相关回调

    Android/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调,包含 V2NIMTeam。接受入群邀请成功,收到加入群组成功回调 onTeamJoined
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    iOS
    • 请求成功,返回 V2NIMTeamInfoCallback 回调,可自定义设置。接受入群邀请成功,收到加入群组成功回调 onTeamJoined
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    rejectInvitation

    接口描述

    拒绝入群邀请。

    本地端或多端拒绝入群邀请成功后,群主和群管理员收到 onReceiveTeamJoinActionInfo 回调,V2NIMTeamJoinActionTypeV2NIM_TEAM_JOIN_ACTION_TYPE_REJECT_INVITATION(3)

    参数说明

    Android
    javavoid rejectInvitation(V2NIMTeamJoinActionInfo invitationInfo, String postscript,V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    invitationInfo V2NIMTeamJoinActionInfo - 邀请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_INVITATION,否则返回 191004 参数错误。
    postscript String null 拒绝邀请附言
    success V2NIMSuccessCallback - 拒绝入群邀请成功回调
    failure V2NIMFailureCallback - 拒绝入群邀请失败回调,返回错误码
    iOS
    objective-c- (void)rejectInvitation:(V2NIMTeamJoinActionInfo *)invitationInfo
                  postscript:(nullable NSString *)postscript
                     success:(nullable V2NIMSuccessCallback)success
                     failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    invitationInfo V2NIMTeamJoinActionInfo - 邀请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_INVITATION,否则返回 191004 参数错误。
    postscript NSString * null 拒绝邀请附言
    success V2NIMSuccessCallback - 拒绝入群邀请成功回调
    failure V2NIMFailureCallback - 拒绝入群邀请失败回调,返回错误码
    macOS/Windows
    cppvirtual void rejectInvitation(V2NIMTeamJoinActionInfo invitationInfo,
                                 std::string postscript,
                                 V2NIMSuccessCallback<void> success,
                                 V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    invitationInfo V2NIMTeamJoinActionInfo - 邀请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_INVITATION,否则返回 191004 参数错误。
    postscript std::string null 拒绝邀请附言
    success V2NIMSuccessCallback - 拒绝入群邀请成功回调
    failure V2NIMFailureCallback - 拒绝入群邀请失败回调,返回错误码
    Web/uni-app/小程序
    typescriptrejectInvitation(invitationInfo: V2NIMTeamJoinActionInfo, postscript?: string): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    invitationInfo V2NIMTeamJoinActionInfo - 邀请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_INVITATION,否则返回 191004 参数错误。
    postscript string null 拒绝邀请附言
    Harmony
    typescriptrejectInvitation(invitationInfo: V2NIMTeamJoinActionInfo, postscript?: string): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    invitationInfo V2NIMTeamJoinActionInfo - 邀请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_INVITATION,否则返回 191004 参数错误。
    postscript string null 拒绝邀请附言

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    // 收到的邀请信息
    V2NIMTeamJoinActionInfo invitationInfo = getInvitationInfo();
    String postscript = "test";
    v2TeamService.rejectInvitation(invitationInfo, postscript, result -> {
        // 拒绝邀请入群成功
    }, error -> {
        // 拒绝邀请入群失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] rejectInvitation:invitationInfo postscript:@"test" success:^{
        // 拒绝邀请入群成功
    } failure:^(V2NIMError * _Nonnull error) {
        // 拒绝邀请入群失败
    }];
    
    macOS/Windows
    cppV2NIMTeamJoinActionInfo invitationInfo;
    // get invitationInfo from notification or query
    // ...
    teamService.rejectInvitation(
        invitationInfo,
        "postscript",
        []() {
            // reject invitation success
        },
        [](V2NIMError error) {
            // reject invitation failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.rejectInvitation(
      {
        "teamId": "123456",
        "teamType": 1,
        "operatorAccountId": "accountId1",
        "actionType": 2
      },
      "test postscript"
    )
    
    Harmony
    typescripttry{
      const invitationInfo: V2NIMTeamJoinActionInfo = {
        actionType: V2NIMTeamJoinActionType.V2NIM_TEAM_JOIN_ACTION_TYPE_INVITATION,
        teamId: "123456",
        teamType: V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL,
        operatorAccountId: "account1",
      }
      
      await nim.teamService.rejectInvitation(invitationInfo)
      // success
    }
    catch (err) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<void>

    相关回调

    Android/iOS/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    kickMember

    接口描述

    批量将群组成员踢出群组。

    本地端或多端同步踢出群组成员成功后:

    仅允许群主调用该接口,否则返回错误码 109427。

    参数说明

    Android
    javavoid kickMember(String teamId, V2NIMTeamType teamType, List<String> memberAccountIds, V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    teamId String - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    memberAccountIds List - 踢出群组的成员账号(accountId)列表,不可为空,否则返回 191004 参数错误。
    success V2NIMSuccessCallback - 踢出成功回调
    failure V2NIMFailureCallback - 踢出失败回调,返回错误码
    iOS
    objective-c- (void)kickMember:(NSString *)teamId
              teamType:(V2NIMTeamType)teamType
      memberAccountIds:(nullable NSArray<NSString *> *)memberAccountIds
               success:(nullable V2NIMSuccessCallback)success
               failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    teamId NSString * - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    memberAccountIds NSArray<NSString *> * - 踢出群组的成员账号(accountId)列表,不可为空,否则返回 191004 参数错误。
    success V2NIMSuccessCallback - 踢出成功回调
    failure V2NIMFailureCallback - 踢出失败回调,返回错误码
    macOS/Windows
    cppvirtual void kickMember(nstd::string teamId,
                            V2NIMTeamType teamType,
                            nstd::vector<nstd::string> memberAccountIds,
                            V2NIMSuccessCallback<void> success,
                            V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    teamId nstd::string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    memberAccountIds nstd::vectornstd::string - 踢出群组的成员账号(accountId)列表,不可为空,否则返回 191004 参数错误。
    success V2NIMSuccessCallback - 踢出成功回调
    failure V2NIMFailureCallback - 踢出失败回调,返回错误码
    Web/uni-app/小程序
    typescriptkickMember(teamId: string, teamType: V2NIMTeamType, memberAccountIds: string[]): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    memberAccountIds string[] - 踢出群组的成员账号(accountId)列表,不可为空,否则返回 191004 参数错误。
    Harmony
    typescriptkickMember(teamId: string, teamType: V2NIMTeamType, memberAccountIds: string[]): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    memberAccountIds string[] - 踢出群组的成员账号(accountId)列表,不可为空,否则返回 191004 参数错误。

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    String teamId = "123456";
    V2NIMTeamType teamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL;
    List<String> memberAccountIds = new ArrayList<>();
    memberAccountIds.add("test1");
    memberAccountIds.add("test2");
    v2TeamService.kickMember(teamId,teamType, memberAccountIds, result -> {
        // 踢出群组成员成功
    }, error -> {
        // 踢出群组成员失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] kickMember:@"teamId" teamType:V2NIM_TEAM_TYPE_NORMAL memberAccountIds:@[@"accountId1"] success:^{
        // 踢出群组成员成功
    } failure:^(V2NIMError * _Nonnull error) {
        // 踢出群组成员失败
    }];
    
    macOS/Windows
    cppnstd::vector<nstd::string> memberAccountIds;
    memberAccountIds.push_back("account1");
    teamService.kickMember(
        "teamId",
        V2NIM_TEAM_TYPE_NORMAL,
        memberAccountIds,
        []() {
            // kick member success
        },
        [](V2NIMError error) {
            // kick member failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.kickMember("123456", 1, ["accountId1"])
    
    Harmony
    typescripttry{
      const teamId = "123456",
      const teamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL,
      const accounts = ["aaa", "bbb"]
      
      await nim.teamService.kickMember(teamId, teamType, accounts)
      // success
    }
    catch (err) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<void>

    相关回调

    Android/iOS/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调;踢出群组成功,返回 onTeamMemberKicked 回调。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    踢出群组成功,返回 onTeamMemberKicked 回调。

    applyJoinTeam

    接口描述

    申请加入群组。

    本地端或多端同步申请加入群组成功后,根据创建群组时设置的入群验证模式,有以下回调场景:

    参数说明

    Android
    javavoid applyJoinTeam(String teamId, V2NIMTeamType teamType, String postscript,V2NIMSuccessCallback<V2NIMTeam> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    teamId String - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    postscript String null 申请入群附言。
    success V2NIMSuccessCallback - 申请入群成功回调,包含 V2NIMTeam
    failure V2NIMFailureCallback - 申请入群失败回调,返回错误码
    iOS
    objective-c- (void)applyJoinTeam:(NSString *)teamId
                 teamType:(V2NIMTeamType)teamType
               postscript:(nullable NSString *)postscript
                  success:(nullable V2NIMTeamInfoCallback)success
                  failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    teamId NSString * - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    postscript NSString * null 申请入群附言。
    success V2NIMTeamInfoCallback - 申请入群成功回调,包含 V2NIMTeam,可自定义设置。
    failure V2NIMFailureCallback - 申请入群失败回调,返回错误码
    macOS/Windows
    cppvirtual void applyJoinTeam(nstd::string teamId,
                               V2NIMTeamType teamType,
                               nstd::string postscript,
                               V2NIMSuccessCallback<V2NIMTeam> success,
                               V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    teamId nstd::string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    postscript nstd::string null 申请入群附言。
    success V2NIMSuccessCallback - 申请入群成功回调,包含 V2NIMTeam
    failure V2NIMFailureCallback - 申请入群失败回调,返回错误码
    Web/uni-app/小程序
    typescriptapplyJoinTeam(teamId: string, teamType: V2NIMTeamType, postscript?: string): Promise<V2NIMTeam>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    postscript string null 申请入群附言。
    Harmony
    typescriptapplyJoinTeam(teamId: string, teamType: V2NIMTeamType, postscript?: string): Promise<V2NIMTeam>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    postscript string null 申请入群附言。

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    String teamId = "123456";
    V2NIMTeamType teamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL;
    String postscript = "test";
    v2TeamService.applyJoinTeam(teamId, teamType, postscript, result -> {
        // 申请加入群组成功
    }, error -> {
        // 申请加入群组失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] applyJoinTeam:@"teamId" teamType:V2NIM_TEAM_TYPE_NORMAL postscript:@"test" success:^(V2NIMTeam * _Nonnull team) {
        // 申请加入群组成功
    } failure:^(V2NIMError * _Nonnull error) {
        // 申请加入群组失败
    }];
    
    macOS/Windows
    cppteamService.applyJoinTeam(
        "teamId",
        V2NIM_TEAM_TYPE_NORMAL,
        "postscript",
        [](V2NIMTeam team) {
            // apply join team success
        },
        [](V2NIMError error) {
            // apply join team failed, handle error
        }
    );
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.applyJoinTeam("123456", 1, "test postscript")
    
    Harmony
    typescripttry{
      const teamId = "123456",
      const teamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL,
      const postscript = "postscript"
      
      await nim.teamService.applyJoinTeam(teamId, teamType, postscript)
      // success
    }
    catch (err) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<V2NIMTeam>

    相关回调

    Android/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调,包含 V2NIMTeam。加入群组成功,返回 onTeamJoined
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    iOS
    • 请求成功,返回 V2NIMTeamInfoCallback 回调,可自定义设置。加入群组成功,返回 onTeamJoined
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    acceptJoinApplication

    接口描述

    同意入群申请。

    本地端或多端同步同意入群申请成功后:

    仅允许群主或管理员调用该接口,否则返回错误码 109432。

    参数说明

    Android
    javavoid acceptJoinApplication(V2NIMTeamJoinActionInfo applicationInfo,V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    applicationInfo V2NIMTeamJoinActionInfo - 申请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_APPLICATION,否则返回 191004 参数错误。
    success V2NIMSuccessCallback - 同意入群申请成功回调
    failure V2NIMFailureCallback - 同意入群申请失败回调,返回错误码
    iOS
    objective-c- (void)acceptJoinApplication:(V2NIMTeamJoinActionInfo *)applicationInfo
                          success:(nullable V2NIMSuccessCallback)success
                          failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    applicationInfo V2NIMTeamJoinActionInfo - 申请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_APPLICATION,否则返回 191004 参数错误。
    success V2NIMSuccessCallback - 同意入群申请成功回调
    failure V2NIMFailureCallback - 同意入群申请失败回调,返回错误码
    macOS/Windows
    cppvirtual void acceptJoinApplication(V2NIMTeamJoinActionInfo applicationInfo, V2NIMSuccessCallback<void> success, V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    applicationInfo V2NIMTeamJoinActionInfo - 申请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_APPLICATION,否则返回 191004 参数错误。
    success V2NIMSuccessCallback - 同意入群申请成功回调
    failure V2NIMFailureCallback - 同意入群申请失败回调,返回错误码
    Web/uni-app/小程序
    typescriptacceptJoinApplication(applicationInfo: V2NIMTeamJoinActionInfo): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    applicationInfo V2NIMTeamJoinActionInfo - 申请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_APPLICATION,否则返回 191004 参数错误。
    Harmony
    typescriptacceptJoinApplication(applicationInfo: V2NIMTeamJoinActionInfo): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    applicationInfo V2NIMTeamJoinActionInfo - 申请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_APPLICATION,否则返回 191004 参数错误。

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    // 收到的入群申请信息
    V2NIMTeamJoinActionInfo applicationInfo = getApplicationInfo();
    v2TeamService.acceptJoinApplication(applicationInfo, result -> {
        // 接受入群申请成功
    }, error -> {
        // 接受入群申请失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] acceptJoinApplication:info success:^{
        // 接受入群申请成功
    } failure:^(V2NIMError * _Nonnull error) {
        // 接受入群申请失败
    }];
    
    macOS/Windows
    cppV2NIMTeamJoinActionInfo applicationInfo;
    // get applicationInfo from notification or query
    // ...
    teamService.acceptJoinApplication(
        applicationInfo,
        []() {
            // accept join application success
        },
        [](V2NIMError error) {
            // accept join application failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.acceptJoinApplication(
      {
        "teamId": "123456",
        "teamType": 1,
        "operatorAccountId": "accountId1",
        "actionType": 0
      }
    )
    
    Harmony
    typescripttry{
      const applicationInfo: V2NIMTeamJoinActionInfo = {
        actionType: V2NIMTeamJoinActionType.V2NIM_TEAM_JOIN_ACTION_TYPE_APPLICATION,
        teamId: "123456",
        teamType: V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL,
        operatorAccountId: "account1",
      }
      
      await nim.teamService.acceptJoinApplication(applicationInfo)
      // success
    }
    catch (err) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<void>

    相关回调

    Android/iOS/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    rejectJoinApplication

    接口描述

    拒绝入群申请。

    本地端或多端同步拒绝入群申请成功后:

    入群申请方收到 onReceiveTeamJoinActionInfo 回调,V2NIMTeamJoinActionTypeV2NIM_TEAM_JOIN_ACTION_TYPE_REJECT_APPLICATION(1)

    仅允许群主或管理员调用该接口,否则返回错误码 109432。

    参数说明

    Android
    javavoid rejectJoinApplication(V2NIMTeamJoinActionInfo applicationInfo, String postscript,V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    applicationInfo V2NIMTeamJoinActionInfo - 申请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_APPLICATION,否则返回 191004 参数错误。
    postscript String null 拒绝入群申请附言
    success V2NIMSuccessCallback - 拒绝入群申请成功回调
    failure V2NIMFailureCallback - 拒绝入群申请失败回调,返回错误码
    iOS
    objective-c- (void)rejectJoinApplication:(NSString *)teamId
                         teamType:(V2NIMTeamType)teamType
                   applyAccountId:(NSString *)applyAccountId
                       postscript:(nullable NSString *)postscript
                          success:(nullable V2NIMSuccessCallback)success
                          failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    applicationInfo V2NIMTeamJoinActionInfo - 申请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_APPLICATION,否则返回 191004 参数错误。
    postscript String null 拒绝入群申请附言
    success V2NIMSuccessCallback - 拒绝入群申请成功回调
    failure V2NIMFailureCallback - 拒绝入群申请失败回调,返回错误码
    macOS/Windows
    cppvirtual void rejectJoinApplication(V2NIMTeamJoinActionInfo applicationInfo,
                                      std::string postscript,
                                      V2NIMSuccessCallback<void> success,
                                      V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    applicationInfo V2NIMTeamJoinActionInfo - 申请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_APPLICATION,否则返回 191004 参数错误。
    postscript std::string null 拒绝入群申请附言
    success V2NIMSuccessCallback - 拒绝入群申请成功回调
    failure V2NIMFailureCallback - 拒绝入群申请失败回调,返回错误码
    Web/uni-app/小程序
    typescriptrejectJoinApplication(applicationInfo: V2NIMTeamJoinActionInfo, postscript?: string): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    applicationInfo V2NIMTeamJoinActionInfo - 申请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_APPLICATION,否则返回 191004 参数错误。
    postscript string null 拒绝入群申请附言
    Harmony
    typescriptrejectJoinApplication(applicationInfo: V2NIMTeamJoinActionInfo, postscript?: string): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    applicationInfo V2NIMTeamJoinActionInfo - 申请入群信息。其中 actionType 必须为 V2NIM_TEAM_JOIN_ACTION_TYPE_APPLICATION,否则返回 191004 参数错误。
    postscript string null 拒绝入群申请附言

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    // 收到的入群申请信息
    V2NIMTeamJoinActionInfo applicationInfo = getApplicationInfo();
    String postscript = "test";
    v2TeamService.rejectInvitation(applicationInfo, postscript, result -> {
        // 拒绝入群申请成功
    }, error -> {
        // 拒绝入群申请失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] rejectJoinApplication:@"teamId"
                                                    teamType:V2NIM_TEAM_TYPE_NORMAL
                                             applyAccountId:@"accountId"
                                                 postscript:@"test"
                                                     success:^{
                                                         // 拒绝入群申请成功
                                                     }
                                                     failure:^(V2NIMError * _Nonnull error) {
                                                         // 拒绝入群申请失败
                                                     }];
    
    macOS/Windows
    cppV2NIMTeamJoinActionInfo applicationInfo;
    // get applicationInfo from notification or query
    // ...
    teamService.rejectJoinApplication(
        applicationInfo,
        "postscript",
        []() {
            // reject join application success
        },
        [](V2NIMError error) {
            // reject join application failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.rejectJoinApplication(
      {
        "teamId": "123456",
        "teamType": 1,
        "operatorAccountId": "accountId1",
        "actionType": 0
      },
      "test postscript"
    )
    
    Harmony
    typescripttry{
      const applicationInfo: V2NIMTeamJoinActionInfo = {
        actionType: V2NIMTeamJoinActionType.V2NIM_TEAM_JOIN_ACTION_TYPE_APPLICATION,
        teamId: "123456",
        teamType: V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL,
        operatorAccountId: "account1",
      }
      const postscript = "postscript"
      
      await nim.teamService.rejectJoinApplication(applicationInfo, postscript)
      // success
    }
    catch (err) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<void>

    相关回调

    Android/iOS/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    updateTeamMemberRole

    接口描述

    批量更新群成员角色类型。

    本地端或多端同步更新群成员角色类型成功后:

    仅允许群主调用该接口,否则返回错误码 109427。

    参数说明

    Android
    javavoid updateTeamMemberRole(String teamId, V2NIMTeamType teamType, List<String> memberAccountIds, V2NIMTeamMemberRole memberRole,V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    teamId String - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    memberAccountIds List - 群成员账号(accountId)列表,不可为空,否则返回 191004 参数错误。
    memberRole V2NIMTeamMemberRole - 群成员角色类型。仅支持设置为群普通成员或群管理员,否则返回 191004 参数错误。
    success V2NIMSuccessCallback - 更新成功回调
    failure V2NIMFailureCallback - 更新失败回调,返回错误码
    iOS
    objective-c- (void)updateTeamMemberRole:(NSString *)teamId
                        teamType:(V2NIMTeamType)teamType
                memberAccountIds:(NSArray<NSString *> *)memberAccountIds
                      memberRole:(V2NIMTeamMemberRole)memberRole
                         success:(nullable V2NIMSuccessCallback)success
                         failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    teamId NSString * - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    memberAccountIds NSArray<NSString *> * - 群成员账号(accountId)列表,不可为空,否则返回 191004 参数错误。
    memberRole V2NIMTeamMemberRole - 群成员角色类型。仅支持设置为群普通成员或群管理员,否则返回 191004 参数错误。
    success V2NIMSuccessCallback - 更新成功回调
    failure V2NIMFailureCallback - 更新失败回调,返回错误码
    macOS/Windows
    cppvirtual void updateTeamMemberRole(nstd::string teamId,
                                     V2NIMTeamType teamType,
                                     nstd::vector<nstd::string> memberAccountId,
                                     V2NIMTeamMemberRole memberRole,
                                     V2NIMSuccessCallback<void> success,
                                     V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    teamId nstd::string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    memberAccountIds nstd::vector<\nstd::string> - 群成员账号(accountId)列表,不可为空,否则返回 191004 参数错误。
    memberRole V2NIMTeamMemberRole - 群成员角色类型。仅支持设置为群普通成员或群管理员,否则返回 191004 参数错误。
    success V2NIMSuccessCallback - 更新成功回调
    failure V2NIMFailureCallback - 更新失败回调,返回错误码
    Web/uni-app/小程序
    typescriptupdateTeamMemberRole(teamId: string, teamType: V2NIMTeamType, memberAccountIds: string[], memberRole: V2NIMTeamMemberRole): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    memberAccountIds string[] - 群成员账号(accountId)列表,不可为空,否则返回 191004 参数错误。
    memberRole V2NIMTeamMemberRole - 群成员角色类型。仅支持设置为群普通成员或群管理员,否则返回 191004 参数错误。
    Harmony
    typescriptupdateTeamMemberRole(teamId: string, teamType: V2NIMTeamType, memberAccountIds: string[], memberRole: V2NIMTeamMemberRole): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    memberAccountIds string[] - 群成员账号(accountId)列表,不可为空,否则返回 191004 参数错误。
    memberRole V2NIMTeamMemberRole - 群成员角色类型。仅支持设置为群普通成员或群管理员,否则返回 191004 参数错误。

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    String teamId = "123456";
    V2NIMTeamType teamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL;
    List<String> memberAccountIds = new ArrayList<>();
    memberAccountIds.add("test1");
    V2NIMTeamMemberRole memberRole = V2NIMTeamMemberRole.V2NIM_TEAM_MEMBER_ROLE_MANAGER;
    v2TeamService.updateTeamMemberRole(teamId, teamType, memberAccountIds, memberRole, result -> {
        // 更新群组成员角色成功
    }, error -> {
        // 更新群组成员角色失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] updateTeamMemberRole:@"teamId" teamType:V2NIM_TEAM_TYPE_NORMAL memberAccountIds:@[@"accountId"] memberRole:V2NIM_TEAM_MEMBER_ROLE_NORMAL success:^{
        // 更新群组成员角色成功
    } failure:^(V2NIMError * _Nonnull error) {
        // 更新群组成员角色失败
    }];
    
    macOS/Windows
    cppstd::vector<std::string> memberAccountIds;
    memberAccountIds.push_back("account1");
    teamService.updateTeamMemberRole(
        "teamId",
        V2NIM_TEAM_TYPE_NORMAL,
        memberAccountIds,
        V2NIM_TEAM_MEMBER_ROLE_MANAGER,
        []() {
            // update team member role success
        },
        [](V2NIMError error) {
            // update team member role failed, handle error
        }
    );
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.updateTeamMemberRole("123456", 1, ["accountId1"], 0)
    
    Harmony
    typescripttry {
      const teamId: string = "123456"
      const teamType: V2NIMTeamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL
      const memberAccountIds: string[] = ["aaa", "bbb"]
      const memberRole: V2NIMTeamMemberRole = V2NIMTeamMemberRole.V2NIM_TEAM_MEMBER_ROLE_MANAGER
    
      await nim.teamService.updateTeamMemberRole(teamId, teamType, memberAccountIds, memberRole)
      // success
    }
    catch (err) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<void>

    相关回调

    Android/iOS/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调;更新成功,返回 onTeamMemberInfoUpdated 回调。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    更新成功,返回 onTeamMemberInfoUpdated 回调。

    transferTeamOwner

    接口描述

    转让群主身份。

    本地端或多端同步转让群主身份成功后:

    • 群组内所有成员收到群组通知消息,通知消息类型为 V2NIMMessageNotificationType.V2NIM_MESSAGE_NOTIFICATION_TYPE_TEAM_OWNER_TRANSFER(6);以及群信息更新回调 onTeamInfoUpdated 和群成员信息变更回调 onTeamMemberInfoUpdated
    • 若调用该方法时设置 leave 参数为 true,即转让群主身份后同时退出该群:
      • 操作方:退出群组,收到退出群组回调 onTeamLeft
      • 群组内所有成员:
        • 收到成员退出群组回调 onTeamMemberLeft
        • 收到群组通知消息,通知消息类型为 V2NIMMessageNotificationType.V2NIM_MESSAGE_NOTIFICATION_TYPE_TEAM_LAVE(2)
    • 仅允许群主调用该接口,否则返回错误码 109427。
    • 不允许转让给自己。

    参数说明

    Android
    javavoid transferTeamOwner(String teamId, V2NIMTeamType teamType, String accountId, boolean leave, V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    teamId String - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountId String - 新群主账号,如果为空、不合法、不存在,或与操作者账号相同,则返回 191004 参数错误。
    leave boolean false 转让群主身份后,是否同时退出该群:
  • true:转让群主身份后,同时退出该群。
  • false:转让群主身份后留在群中,成员角色从群主转变为普通成员。
  • success V2NIMSuccessCallback - 转让成功回调
    failure V2NIMFailureCallback - 转让失败回调,返回错误码
    iOS
    objective-c- (void)transferTeamOwner:(NSString *)teamId
                     teamType:(V2NIMTeamType)teamType
                    accountId:(NSString *)accountId
                        leave:(BOOL)leave
                      success:(nullable V2NIMSuccessCallback)success
                      failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    teamId NSString * - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountId NSString * - 新群主账号,如果为空、不合法、不存在,或与操作者账号相同,则返回 191004 参数错误。
    leave BOOL false 转让群主身份后,是否同时退出该群:
  • true:转让群主身份后,同时退出该群。
  • false:转让群主身份后留在群中,成员角色从群主转变为普通成员。
  • success V2NIMSuccessCallback - 转让成功回调
    failure V2NIMFailureCallback - 转让失败回调,返回错误码
    macOS/Windows
    cppvirtual void transferTeamOwner(nstd::string teamId,
                                   V2NIMTeamType teamType,
                                   nstd::string accountId,
                                   bool leave,
                                   V2NIMSuccessCallback<void> success,
                                   V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    teamId nstd::string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountId nstd::string - 新群主账号,如果为空、不合法、不存在,或与操作者账号相同,则返回 191004 参数错误。
    leave bool false 转让群主身份后,是否同时退出该群:
  • true:转让群主身份后,同时退出该群。
  • false:转让群主身份后留在群中,成员角色从群主转变为普通成员。
  • success V2NIMSuccessCallback - 转让成功回调
    failure V2NIMFailureCallback - 转让失败回调,返回错误码
    Web/uni-app/小程序
    typescripttransferTeamOwner(teamId: string, teamType: V2NIMTeamType, accountId: string, leave?: boolean): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountId string - 新群主账号,如果为空、不合法、不存在,或与操作者账号相同,则返回 191004 参数错误。
    leave boolean false 转让群主身份后,是否同时退出该群:
  • true:转让群主身份后,同时退出该群。
  • false:转让群主身份后留在群中,成员角色从群主转变为普通成员。
  • Harmony
    typescripttransferTeamOwner(teamId: string, teamType: V2NIMTeamType, accountId: string, leave?: boolean): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountId string - 新群主账号,如果为空、不合法、不存在,或与操作者账号相同,则返回 191004 参数错误。
    leave boolean false 转让群主身份后,是否同时退出该群:
  • true:转让群主身份后,同时退出该群。
  • false:转让群主身份后留在群中,成员角色从群主转变为普通成员。
  • 示例代码

    Android
    javaV2TeamService v2TeamService = NIMClient.getService(V2TeamService.class);
    String teamId = "123456";
    V2TeamType teamType = V2TeamType.NORMAL;
    String account = "test";
    boolean leave = false;
    v2TeamService.transferTeamOwner(teamId, teamType, account, leave, result -> {
        // 转移群组群主成功
    }, error -> {
        // 转移群组群主失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] transferTeamOwner:@"teamId" teamType:V2NIM_TEAM_TYPE_NORMAL accountId:@"accountId" leave:YES success:^{
        // 转移群组群主成功
    } failure:^(V2NIMError * _Nonnull error) {
        // 转移群组群主失败
    }];
    
    macOS/Windows
    cppteamService.transferTeamOwner(
        "teamId",
        V2NIM_TEAM_TYPE_NORMAL,
        "accountId",
        false,
        []() {
            // transfer team owner success
        },
        [](V2NIMError error) {
            // transfer team owner failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.transferTeamOwner("123456", 1, "accountId1", true)
    
    Harmony
    typescripttry {
      const teamId: string = "123456"
      const teamType: V2NIMTeamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL
      const newAccountId: string = "aaa"
      const isLeave: boolean = true
    
      await nim.teamService.transferTeamOwner(teamId, teamType, newAccountId, isLeave)
      // success
    } catch (error) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<void>

    相关回调

    Android/iOS/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调;转让成功,返回群信息更新回调 onTeamInfoUpdated 和群成员信息变更回调 onTeamMemberInfoUpdated
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    转让成功,返回群信息更新回调 onTeamInfoUpdated 和群成员信息变更回调 onTeamMemberInfoUpdated

    updateSelfTeamMemberInfo

    接口描述

    更新本人群成员信息。

    本地端或多端同步更新本人群成员信息成功后,群组内所有成员收到群成员信息变更回调 onTeamMemberInfoUpdated

    参数说明

    Android
    javavoid updateSelfTeamMemberInfo(String teamId, V2NIMTeamType teamType, V2NIMUpdateSelfMemberInfoParams memberInfoParams,V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    teamId String - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    memberInfoParams V2NIMUpdateSelfMemberInfoParams - 本人群成员信息配置,包含群成员昵称及服务端扩展字段。
    success V2NIMSuccessCallback - 更新成功回调
    failure V2NIMFailureCallback - 更新失败回调,返回错误码
    iOS
    objective-c- (void)updateSelfTeamMemberInfo:(NSString *)teamId
                            teamType:(V2NIMTeamType)teamType
                    memberInfoParams:(V2NIMUpdateSelfMemberInfoParams *)memberInfoParams
                             success:(nullable V2NIMSuccessCallback)success
                             failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    teamId NSString * - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    memberInfoParams V2NIMUpdateSelfMemberInfoParams - 本人群成员信息配置,包含群成员昵称及服务端扩展字段。
    success V2NIMSuccessCallback - 更新成功回调
    failure V2NIMFailureCallback - 更新失败回调,返回错误码
    macOS/Windows
    cppvirtual void updateSelfTeamMemberInfo(std::string teamId,
                                          V2NIMTeamType teamType,
                                          V2NIMUpdateSelfMemberInfoParams memberInfoParams,
                                          V2NIMSuccessCallback<void> success,
                                          V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    teamId std::string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    memberInfoParams V2NIMUpdateSelfMemberInfoParams - 本人群成员信息配置,包含群成员昵称及服务端扩展字段。
    success V2NIMSuccessCallback - 更新成功回调
    failure V2NIMFailureCallback - 更新失败回调,返回错误码
    Web/uni-app/小程序
    typescriptupdateSelfTeamMemberInfo(teamId: string, teamType: V2NIMTeamType, memberInfoParams: V2NIMUpdateSelfMemberInfoParams): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    memberInfoParams V2NIMUpdateSelfMemberInfoParams - 本人群成员信息配置,包含群成员昵称及服务端扩展字段。
    Harmony
    typescriptupdateSelfTeamMemberInfo(teamId: string, teamType: V2NIMTeamType, memberInfoParams: V2NIMUpdateSelfMemberInfoParams): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    memberInfoParams V2NIMUpdateSelfMemberInfoParams - 本人群成员信息配置,包含群成员昵称及服务端扩展字段。

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    String teamId = "123456";
    V2NIMTeamType teamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL;
    V2NIMUpdateSelfMemberInfoParams memberInfoParams = new V2NIMUpdateSelfMemberInfoParams();
    memberInfoParams.setTeamNick("test nick");
    memberInfoParams.setServerExtension("test");
    v2TeamService.updateSelfTeamMemberInfo(teamId,teamType, memberInfoParams, result -> {
        // 修改自己的群成员信息成功
    }, error -> {
        // 修改自己的群成员信息失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] updateSelfTeamMemberInfo:@"teamId" teamType:V2NIM_TEAM_TYPE_NORMAL memberInfoParams:infoParams success:^{
        // 修改自己的群成员信息成功
    } failure:^(V2NIMError * _Nonnull error) {
        // 修改自己的群成员信息失败
    }];
    
    macOS/Windows
    cppV2NIMUpdateSelfMemberInfoParams memberInfoParams;
    memberInfoParams.teamNick = "new nick";
    teamService.updateSelfTeamMemberInfo(
        "teamId",
        V2NIM_TEAM_TYPE_NORMAL,
        memberInfoParams,
        []() {
            // update self team member info success
        },
        [](V2NIMError error) {
            // update self team member info failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.updateSelfTeamMemberInfo("123456", 1, {
      "teamNick": "test nick"
    })
    
    Harmony
    typescripttry {
      const teamId: string = "123456"
      const teamType: V2NIMTeamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL
      const memberInfoParams: V2NIMUpdateSelfMemberInfoParams = {
        teamNick: "nick",
        serverExtension: "ext"
      }
      
      await teamService.updateSelfTeamMemberInfo(teamId, teamType, memberInfoParams)
      // success
    } catch (err) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<void>

    相关回调

    Android/iOS/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调;更新成功,返回 onTeamMemberInfoUpdated 回调。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    更新成功,返回 onTeamMemberInfoUpdated 回调。

    updateTeamMemberNick

    接口描述

    更新群成员昵称。

    本地端或多端同步更新成功后,群组内所有成员会收到群成员信息变更回调 onTeamMemberInfoUpdated

    仅允许群主和管理员调用该接口,否则返回错误码 109432。

    参数说明

    Android
    javavoid updateTeamMemberNick(String teamId, V2NIMTeamType teamType, String accountId, String teamNick,V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    teamId String - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountId String - 群成员账号,如果为空、不合法、不存在,则返回 191004 参数错误。
    teamNick String - 群成员新昵称,可以设置为 "",但不可设置 null,否则返回 191004 参数错误。
    success V2NIMSuccessCallback - 更新成功回调
    failure V2NIMFailureCallback - 更新失败回调,返回错误码
    iOS
    objective-c- (void)updateTeamMemberNick:(NSString *)teamId
                        teamType:(V2NIMTeamType)teamType
                       accountId:(NSString *)accountId
                        teamNick:(NSString *)teamNick
                         success:(nullable V2NIMSuccessCallback)success
                         failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    teamId NSString * - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountId NSString * - 群成员账号,如果为空、不合法、不存在,则返回 191004 参数错误。
    teamNick NSString * - 群成员新昵称,可以设置为 "",但不可设置 null,否则返回 191004 参数错误。
    success V2NIMSuccessCallback - 更新成功回调
    failure V2NIMFailureCallback - 更新失败回调,返回错误码
    macOS/Windows
    cppvirtual void updateTeamMemberNick(nstd::string teamId,
                                     V2NIMTeamType teamType,
                                     nstd::string accountId,
                                     nstd::string teamNick,
                                     V2NIMSuccessCallback<void> success,
                                     V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    teamId nstd::string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountId nstd::string - 群成员账号,如果为空、不合法、不存在,则返回 191004 参数错误。
    teamNick nstd::string - 群成员新昵称,可以设置为 "",但不可设置 null,否则返回 191004 参数错误。
    success V2NIMSuccessCallback - 更新成功回调
    failure V2NIMFailureCallback - 更新失败回调,返回错误码
    Web/uni-app/小程序
    typescriptupdateTeamMemberNick(teamId: string, teamType: V2NIMTeamType, accountId: string, nick: string): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountId string - 群成员账号,如果为空、不合法、不存在,则返回 191004 参数错误。
    nick string - 群成员新昵称,可以设置为 "",但不可设置 null,否则返回 191004 参数错误。
    Harmony
    typescriptupdateTeamMemberNick(teamId: string, teamType: V2NIMTeamType, accountId: string, nick: string): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountId string - 群成员账号,如果为空、不合法、不存在,则返回 191004 参数错误。
    nick string - 群成员新昵称,可以设置为 "",但不可设置 null,否则返回 191004 参数错误。

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    String teamId = "123456";
    V2NIMTeamType teamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL;
    String account = "test";
    String teamNick = "test nick";
    v2TeamService.updateTeamMemberNick(teamId, teamType, account, teamNick, result -> {
        // 修改群成员昵称成功
    }, error -> {
        // 修改群成员昵称失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] updateTeamMemberNick:@"teamId" teamType:V2NIM_TEAM_TYPE_NORMAL accountId:@"accountId" teamNick:@"test" success:^{
        // 修改群成员昵称成功
    } failure:^(V2NIMError * _Nonnull error) {
        // 修改群成员昵称失败
    }];
    
    macOS/Windows
    cppteamService.updateTeamMemberNick(
        "teamId",
        V2NIM_TEAM_TYPE_NORMAL,
        "accountId",
        "new nick",
        []() {
            // update team member nick success
        },
        [](V2NIMError error) {
            // update team member nick failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.updateTeamMemberNick("123456", 1, "accountId1", "test nick")
    
    Harmony
    typescripttry {
      const teamId: string = "123456"
      const teamType: V2NIMTeamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL
      const account: string = "aaa"
      const nick: string = "new nick"
      
      await teamService.updateTeamMemberNick(teamId, teamType, account, nick)
      // success
    } catch (err) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<void>

    相关回调

    Android/iOS/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调;更新成功,返回 onTeamMemberInfoUpdated 回调。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    更新成功,返回 onTeamMemberInfoUpdated 回调。

    setTeamChatBannedMode

    接口描述

    设置群组禁言模式。

    本地端或多端同步设置成功后,群组内所有成员会收到群组信息变更回调 onTeamInfoUpdate 以及群信息变更的通知类消息,消息类型为 V2NIMMessageNotificationType.V2NIM_MESSAGE_NOTIFICATION_TYPE_TEAM_UPDATE_TINFO(3)

    仅允许群主和管理员调用该接口,否则返回错误码 109432。

    参数说明

    Android
    javavoid setTeamChatBannedMode(String teamId, V2NIMTeamType teamType, V2NIMTeamChatBannedMode chatBannedMode,V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    teamId String - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    chatBannedMode V2NIMTeamChatBannedMode - 群组禁言模式。
  • 仅允许设置为不禁言和普通成员全员禁言,否则返回 191004 参数错误。
  • 如需全员禁言(包含群主和群管理员),请调用服务端 API 更新群组信息
  • success V2NIMSuccessCallback - 设置成功回调
    failure V2NIMFailureCallback - 设置失败回调,返回错误码
    iOS
    objective-c- (void)setTeamChatBannedMode:(NSString *)teamId
                         teamType:(V2NIMTeamType)teamType
                   chatBannedMode:(V2NIMTeamChatBannedMode)chatBannedMode
                          success:(nullable V2NIMSuccessCallback)success
                          failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    teamId NSString * - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    chatBannedMode V2NIMTeamChatBannedMode - 群组禁言模式。
  • 仅允许设置为不禁言和普通成员全员禁言,否则返回 191004 参数错误。
  • 如需全员禁言(包含群主和群管理员),请调用服务端 API 更新群组信息
  • success V2NIMSuccessCallback - 设置成功回调
    failure V2NIMFailureCallback - 设置失败回调,返回错误码
    macOS/Windows
    cppvirtual void setTeamChatBannedMode(std::string teamId,
                                      V2NIMTeamType teamType,
                                      V2NIMTeamChatBannedMode chatBannedMode,
                                      V2NIMSuccessCallback<void> success,
                                      V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    teamId std::string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    chatBannedMode V2NIMTeamChatBannedMode - 群组禁言模式。
  • 仅允许设置为不禁言和普通成员全员禁言,否则返回 191004 参数错误。
  • 如需全员禁言(包含群主和群管理员),请调用服务端 API 更新群组信息
  • success V2NIMSuccessCallback - 设置成功回调
    failure V2NIMFailureCallback - 设置失败回调,返回错误码
    Web/uni-app/小程序
    typescriptsetTeamChatBannedMode(teamId: string, teamType: V2NIMTeamType, chatBannedMode: V2NIMTeamChatBannedMode): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    chatBannedMode V2NIMTeamChatBannedMode - 群组禁言模式。
  • 仅允许设置为不禁言和普通成员全员禁言,否则返回 191004 参数错误。
  • 如需全员禁言(包含群主和群管理员),请调用服务端 API 更新群组信息
  • Harmony
    typescriptsetTeamChatBannedMode(teamId: string, teamType: V2NIMTeamType, chatBannedMode: V2NIMTeamChatBannedMode): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    chatBannedMode V2NIMTeamChatBannedMode - 群组禁言模式。
  • 仅允许设置为不禁言和普通成员全员禁言,否则返回 191004 参数错误。
  • 如需全员禁言(包含群主和群管理员),请调用服务端 API 更新群组信息
  • 示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    String teamId = "123456";
    V2NIMTeamType teamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL;
    V2NIMTeamChatBannedMode chatBannedMode = V2NIMTeamChatBannedMode.V2NIM_TEAM_CHAT_BANNED_MODE_BANNED_NORMAL;
    v2TeamService.setTeamChatBannedMode(teamId,teamType, chatBannedMode, result -> {
        // 设置群组禁言模式成功
    }, error -> {
        // 设置群组禁言模式失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] setTeamChatBannedMode:@"teamId" teamType:V2NIM_TEAM_TYPE_NORMAL chatBannedMode:V2NIM_TEAM_CHAT_BANNED_MODE_BANNED_NORMAL success:^{
        // 设置群组禁言模式成功
    } failure:^(V2NIMError * _Nonnull error) {
        // 设置群组禁言模式失败
    }];
    
    macOS/Windows
    cppteamService.setTeamChatBannedMode(
        "teamId",
        V2NIM_TEAM_TYPE_NORMAL,
        V2NIM_TEAM_CHAT_BANNED_MODE_BANNED_NORMAL,
        []() {
            // set team chat banned mode success
        },
        [](V2NIMError error) {
            // set team chat banned mode failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.setTeamChatBannedMode("123456", 1, 1)
    
    Harmony
    typescripttry {
      const teamId: string = "123456"
      const teamType: V2NIMTeamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL
      const chatBannedMode: V2NIMTeamChatBannedMode = V2NIMTeamChatBannedMode.V2NIM_TEAM_CHAT_BANNED_MODE_BANNED_NORMAL
      
      await teamService.setTeamChatBannedMode(this.teamId, this.teamType, this.chatBannedMode)
      // success
    } catch (err) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<void>

    相关回调

    Android/iOS/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调;设置成功,返回 onTeamInfoUpdate 回调。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    更新成功,返回 onTeamInfoUpdate 回调。

    setTeamMemberChatBannedStatus

    接口描述

    设置群组成员禁言状态。

    本地端或多端同步设置成功后,群组内所有成员会收到群成员信息变更回调 onTeamMemberInfoUpdated 以及群成员禁言的通知类消息,消息类型为 V2NIMMessageNotificationType.V2NIM_MESSAGE_NOTIFICATION_TYPE_TEAM_BANNED_TEAM_MEMBER(10)

    仅允许群主和管理员调用该接口,否则返回错误码 109432。

    参数说明

    Android
    javavoid setTeamMemberChatBannedStatus(String teamId, V2NIMTeamType teamType, String accountId, boolean chatBanned,V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    teamId String - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountId String - 群组成员账号,如果为空、不合法、不存在,则返回 191004 参数错误。
    chatBanned boolean - 群组成员是否被禁言。
  • true:被禁言
  • false:取消禁言
  • success V2NIMSuccessCallback - 设置成功回调
    failure V2NIMFailureCallback - 设置失败回调,返回错误码
    iOS
    objective-c- (void)setTeamMemberChatBannedStatus:(NSString *)teamId
                                 teamType:(V2NIMTeamType)teamType
                                accountId:(NSString *)accountId
                               chatBanned:(BOOL)chatBanned
                                  success:(nullable V2NIMSuccessCallback)success
                                  failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    teamId NSString * - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountId NSString * - 群组成员账号,如果为空、不合法、不存在,则返回 191004 参数错误。
    chatBanned BOOL - 群组成员是否被禁言。
  • true:被禁言
  • false:取消禁言
  • success V2NIMSuccessCallback - 设置成功回调
    failure V2NIMFailureCallback - 设置失败回调,返回错误码
    macOS/Windows
    cppvirtual void setTeamMemberChatBannedStatus(nstd::string teamId,
                                               V2NIMTeamType teamType,
                                               nstd::string accountId,
                                               bool chatBanned,
                                               V2NIMSuccessCallback<void> success,
                                               V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    teamId nstd::string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountId nstd::string - 群组成员账号,如果为空、不合法、不存在,则返回 191004 参数错误。
    chatBanned bool - 群组成员是否被禁言。
  • true:被禁言
  • false:取消禁言
  • success V2NIMSuccessCallback - 设置成功回调
    failure V2NIMFailureCallback - 设置失败回调,返回错误码
    Web/uni-app/小程序
    typescriptsetTeamMemberChatBannedStatus(teamId: string, teamType: V2NIMTeamType, accountId: string, chatBanned: boolean): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountId string - 群组成员账号,如果为空、不合法、不存在,则返回 191004 参数错误。
    chatBanned boolean - 群组成员是否被禁言。
  • true:被禁言
  • false:取消禁言
  • Harmony
    typescriptsetTeamMemberChatBannedStatus(teamId: string, teamType: V2NIMTeamType, accountId: string, chatBanned: boolean): Promise<void>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountId string - 群组成员账号,如果为空、不合法、不存在,则返回 191004 参数错误。
    chatBanned boolean - 群组成员是否被禁言。
  • true:被禁言
  • false:取消禁言
  • 示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    String teamId = "123456";
    V2NIMTeamType teamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL;
    String accountId = "test";
    boolean chatBanned = true;
    v2TeamService.setTeamMemberChatBannedStatus(teamId,teamType, accountId, chatBanned, result -> {
        // 设置群组成员聊天禁言状态成功
    }, error -> {
        // 设置群组成员聊天禁言状态失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] setTeamMemberChatBannedStatus:@"teamId" teamType:V2NIM_TEAM_TYPE_NORMAL accountId:@"accountId" chatBanned:YES success:^{
        // 设置群组成员聊天禁言状态成功
    } failure:^(V2NIMError * _Nonnull error) {
        // 设置群组成员聊天禁言状态失败
    }];
    
    macOS/Windows
    cppteamService.setTeamMemberChatBannedStatus(
        "teamId",
        V2NIM_TEAM_TYPE_NORMAL,
        "accountId",
        true,
        []() {
            // set team member chat banned status success
        },
        [](V2NIMError error) {
            // set team member chat banned status failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.setTeamMemberChatBannedStatus("123456", 1, "accountId1", true)
    
    Harmony
    typescripttry {
      const teamId: string = "123456"
      const teamType: V2NIMTeamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL
      const account: string = "aaaa"
      const chatBanned: boolean = true
      
      await teamService.setTeamMemberChatBannedStatus(teamId, teamType, accountId, chatBanned)
      // success
    } catch (err) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<void>

    相关回调

    Android/iOS/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调;设置成功,返回 onTeamMemberInfoUpdated 回调。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    更新成功,返回 onTeamMemberInfoUpdated 回调。

    getJoinedTeamList

    接口描述

    按照群组类型获取已经加入的群组列表。返回群组列表按照创建时间的升序排序。

    参数说明

    Android
    javavoid getJoinedTeamList(List<V2NIMTeamType> teamTypes, V2NIMSuccessCallback<List<V2NIMTeam>> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    teamTypes List<V2NIMTeamType> null 群组类型列表。设置为 null 或空则表示获取所有类型的群组。
    success V2NIMSuccessCallback - 获取成功回调,返回 V2NIMTeam 列表。
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    iOS
    objective-c- (void)getJoinedTeamList:(NSArray<NSNumber *> *)teamTypes
                      success:(nullable V2NIMTeamInfoListCallback)success
                      failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    teamTypes NSArray<NSNumber *> * null 群组类型列表。设置为 null 或空则表示获取所有类型的群组。
    success V2NIMTeamInfoListCallback - 获取成功回调,返回 V2NIMTeam 列表,可自定义设置。
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    macOS/Windows
    cppvirtual void getJoinedTeamList(nstd::vector<V2NIMTeamType> teamTypes,
        V2NIMSuccessCallback<nstd::vector<V2NIMTeam>> success,
        V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    teamTypes nstd::vector<V2NIMTeamType> null 群组类型列表。设置为 null 或空则表示获取所有类型的群组。
    success V2NIMSuccessCallback - 获取成功回调,返回 V2NIMTeam 列表。
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    Web/uni-app/小程序
    typescriptgetJoinedTeamList(teamTypes?: V2NIMTeamType[]): Promise<V2NIMTeam[]>
    
    参数名称 类型 是否必填 默认值 描述
    teamTypes V2NIMTeamType[] - 群组类型列表。不可设置为 null,设置为空则表示获取所有类型的群组。
    Harmony
    typescriptgetJoinedTeamList(teamTypes?: V2NIMTeamType[]): Promise<V2NIMTeam[]>
    
    参数名称 类型 是否必填 默认值 描述
    teamTypes V2NIMTeamType[] - 群组类型列表。不可设置为 null,设置为空则表示获取所有类型的群组。

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    List<V2NIMTeamType> teamTypes = new ArrayList<>();
    teamTypes.add(V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL);
    teamTypes.add(V2NIMTeamType.V2NIM_TEAM_TYPE_SUPER);
    v2TeamService.getJoinedTeamList(teamTypes, result -> {
        // 获取当前已经加入的群组列表成功
    }, error -> {
        // 获取当前已经加入的群组列表失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] getJoinedTeamList:nil success:^(NSArray<V2NIMTeam *> * _Nonnull teamList) {
        // 获取当前已经加入的群组列表成功
    } failure:^(V2NIMError * _Nonnull error) {
        // 获取当前已经加入的群组列表失败
    }];
    
    macOS/Windows
    cppnstd::vector<V2NIMTeamType> teamTypes;
    teamTypes.push_back(V2NIM_TEAM_TYPE_NORMAL);
    teamService.getJoinedTeamList(
        teamTypes,
        [](nstd::vector<V2NIMTeam> teamList) {
            // get joined team list success
        },
        [](V2NIMError error) {
            // get joined team list failed, handle error
        }
    );
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.getJoinedTeamList([1])
    
    Harmony
    typescripttry {
        const teamTypes: V2NIMTeamType[] = [V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL, V2NIMTeamType.V2NIM_TEAM_TYPE_SUPER]
        const teams: V2NIMTeam[] = await nim.teamService.getJoinedTeamList(this.teamType)
        // success
    } catch (e) {
        // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<V2NIMTeam[]> 群组列表

    相关回调

    Android/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调,包含 V2NIMTeam 列表。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    iOS
    • 请求成功,返回 V2NIMTeamInfoListCallback 回调,可自定义设置。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    getJoinedTeamCount

    接口描述

    按照群组类型获取已经加入的群组数量。

    参数说明

    Android
    javaint getJoinedTeamCount(List<V2NIMTeamType> teamTypes);
    
    参数名称 类型 是否必填 默认值 描述
    teamTypes List<V2NIMTeamType> null 群组类型列表。设置为 null 或空则表示获取所有类型的群组数量。
    iOS
    objective-c- (NSInteger)getJoinedTeamCount:(NSArray<NSNumber *> *)teamTypes;
    
    参数名称 类型 是否必填 默认值 描述
    teamTypes NSArray<NSNumber *> * null 群组类型列表。设置为 null 或空则表示获取所有类型的群组数量。
    macOS/Windows
    cppvirtual uint32_t getJoinedTeamCount(nstd::vector<V2NIMTeamType> teamTypes) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    teamTypes nstd::vector<V2NIMTeamType> null 群组类型列表。设置为 null 或空则表示获取所有类型的群组数量。
    Web/uni-app/小程序
    typescriptgetJoinedTeamCount(teamTypes?: V2NIMTeamType[]): number
    
    参数名称 类型 是否必填 默认值 描述
    teamTypes V2NIMTeamType[] - 群组类型列表。不可设置为 null,设置为空则表示获取所有类型的群组数量。
    Harmony
    typescriptgetJoinedTeamCount(teamTypes?: V2NIMTeamType[]): Promise<number>
    
    参数名称 类型 是否必填 默认值 描述
    teamTypes V2NIMTeamType[] - 群组类型列表。不可设置为 null,设置为空则表示获取所有类型的群组数量。

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    List<V2NIMTeamType> teamTypes = new ArrayList<>();
    teamTypes.add(V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL);
    teamTypes.add(V2NIMTeamType.V2NIM_TEAM_TYPE_SUPER);
    int joinedTeamCount = v2TeamService.getJoinedTeamCount(teamTypes);
    
    iOS
    objective-cNSInteger allJoinedTeamCount = [[[NIMSDK sharedSDK] v2TeamService] getJoinedTeamCount:nil];
    
    macOS/Windows
    cppnstd::vector<V2NIMTeamType> teamTypes;
    teamTypes.push_back(V2NIM_TEAM_TYPE_NORMAL);
    auto count = teamService.getJoinedTeamCount(teamTypes);
    
    Web/uni-app/小程序
    typescriptnim.V2NIMTeamService.getJoinedTeamCount([1])
    
    Harmony
    typescripttry {
        const teamTypes: V2NIMTeamType[] = [V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL, V2NIMTeamType.V2NIM_TEAM_TYPE_SUPER]
        const count: number = await nim.teamService.getJoinedTeamCount(this.teamType)
        // success
    } catch (e) {
        // fail
    }
    

    返回值

    群组数量

    相关回调

    getTeamMemberList

    接口描述

    分页获取群组成员列表。返回成员列表按照加入群组的时间戳(V2NIMTeamMember.joinTime)排序。

    参数说明

    Android
    javavoid getTeamMemberList(String teamId, V2NIMTeamType teamType, V2NIMTeamMemberQueryOption queryOption, V2NIMSuccessCallback<V2NIMTeamMemberListResult> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    teamId String - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    queryOption V2NIMTeamMemberQueryOption - 群组成员分页查询选项
    success V2NIMSuccessCallback - 获取成功回调,返回 V2NIMTeamMemberListResult
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    iOS
    objective-c- (void)getTeamMemberList:(NSString *)teamId
                     teamType:(V2NIMTeamType)teamType
                  queryOption:(V2NIMTeamMemberQueryOption *)queryOption
                      success:(nullable V2NIMTeamMemberListResultCallback)success
                      failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    teamId NSString * - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    queryOption V2NIMTeamMemberQueryOption * - 群组成员分页查询选项
    success V2NIMTeamMemberListResultCallback - 获取成功回调,可自定义设置。
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    macOS/Windows
    cppvirtual void getTeamMemberList(std::string teamId,
                                  V2NIMTeamType teamType,
                                  V2NIMTeamMemberQueryOption queryOption,
                                  V2NIMSuccessCallback<V2NIMTeamMemberListResult> success,
                                  V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    teamId std::string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    queryOption V2NIMTeamMemberQueryOption - 群组成员分页查询选项
    success V2NIMSuccessCallback - 获取成功回调,返回 V2NIMTeamMemberListResult
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    Web/uni-app/小程序
    typescriptgetTeamMemberList(teamId: string, teamType: V2NIMTeamType, queryOption: V2NIMTeamMemberQueryOption): Promise<V2NIMTeamMemberListResult>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    queryOption V2NIMTeamMemberQueryOption - 群组成员分页查询选项
    Harmony
    typescriptgetTeamMemberList(teamId: string, teamType: V2NIMTeamType, queryOption: V2NIMTeamMemberQueryOption): Promise<V2NIMTeamMemberListResult>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID。如果为空、不合法、不存在则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    queryOption V2NIMTeamMemberQueryOption - 群组成员分页查询选项

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    String teamId = "123456";
    V2NIMTeamType teamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL;
    V2NIMTeamMemberQueryOption queryOption = new V2NIMTeamMemberQueryOption();
    queryOption.setRoleQueryType(V2NIMTeamMemberRoleQueryType.V2NIM_TEAM_MEMBER_ROLE_QUERY_TYPE_ALL);
    // 设置分页偏移,首次传"",后续拉取采用上一次返回的 nextToken
    queryOption.setNextToken("");
    queryOption.setDirection(V2NIMQueryDirection.V2NIM_QUERY_DIRECTION_DESC);
    queryOption.setLimit(100);
    queryOption.setOnlyChatBanned(false);
    v2TeamService.getTeamMemberList(teamId, teamType, queryOption, result -> {
        // 获取群组成员列表成功
    }, error -> {
        // 获取群组成员列表失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] getTeamMemberList:@"teamId" teamType:V2NIM_TEAM_TYPE_NORMAL queryOption:queryOption success:^(V2NIMTeamMemberListResult * _Nonnull result) {
        // 获取群组成员列表成功
    } failure:^(V2NIMError * _Nonnull error) {
        // 获取群组成员列表失败
    }];
    
    macOS/Windows
    cppV2NIMTeamMemberQueryOption queryOption;
    queryOption.nextToken = ""; // first page
    queryOption.limit = 10;
    queryOption.direction = V2NIM_QUERY_DIRECTION_DESC;
    teamService.getTeamMemberList(
        "teamId",
        V2NIM_TEAM_TYPE_NORMAL,
        queryOption,
        [](V2NIMTeamMemberListResult result) {
            // get team members success
        },
        [](V2NIMError error) {
            // get team members failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.getTeamMemberList(
      "123456",
      1,
      {
        "roleQueryType": 0,
        "onlyChatBanned": false,
        "direction": 0,
        "limit": 100,
        "nextToken": ""
      }
    )
    
    Harmony
    typescripttry {
      const teamId: string = "123456"
      const teamType: V2NIMTeamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL
      const queryOption: V2NIMTeamMemberQueryOption = {
        roleQueryType: V2NIMTeamMemberRoleQueryType.V2NIM_TEAM_MEMBER_ROLE_QUERY_TYPE_NORMAL,
        onlyChatBanned: false,
        direction: V2NIMQueryDirection.V2NIM_QUERY_DIRECTION_DESC
        limit: 50
        nextToken: undefined
      }
    
      const memberListResult: V2NIMTeamMemberListResult = await nim.teamService.getTeamMemberList(teamId, teamType, queryOption)
      // success
    } catch (err) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<V2NIMTeamMemberListResult> 群组成员查询结果

    相关回调

    Android/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调,包含 V2NIMTeamMemberListResult
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    iOS
    • 请求成功,返回 V2NIMTeamMemberListResultCallback 回调,可自定义设置。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    getTeamMemberListByIds

    接口描述

    根据群成员账号批量获取群组成员列表。返回成员列表按照加入群组的时间戳(V2NIMTeamMember.joinTime)排序。

    SDK 获取策略如下:

    查询引用消息.drawio.png

    群组数据同步(V2NIMTeamListener.onSyncFinished)完成前,可能获取不到完整数据。

    参数说明

    Android
    javavoid getTeamMemberListByIds(String teamId, V2NIMTeamType teamType, List<String> accountIds, V2NIMSuccessCallback<List<V2NIMTeamMember>> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    teamId String - 群组 ID 列表,不可为空,否则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountIds List - 群成员账号列表,不可为 null 或空,否则返回 191004 参数错误。
    success V2NIMSuccessCallback - 获取成功回调,返回 V2NIMTeamMember 列表。
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    iOS
    objective-c- (void)getTeamMemberListByIds:(NSString *)teamId
                          teamType:(V2NIMTeamType)teamType
                        accountIds:(NSArray<NSString *> *)accountIds
                           success:(nullable V2NIMTeamMemberListCallback)success
                           failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    teamId NSString * - 群组 ID 列表,不可为空,否则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountIds NSArray<NSString *> * - 群成员账号列表,不可为 null 或空,否则返回 191004 参数错误。
    success V2NIMTeamMemberListCallback - 获取成功回调,返回 V2NIMTeamMember 列表,可自定义设置。
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    macOS/Windows
    cppvirtual void getTeamMemberListByIds(nstd::string teamId,
                                        V2NIMTeamType teamType,
                                        nstd::vector<nstd::string> accountIds,
                                        V2NIMSuccessCallback<nstd::vector<V2NIMTeamMember>> success,
                                        V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    teamId nstd::string - 群组 ID 列表,不可为空,否则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountIds nstd::vector<nstd::string> - 群成员账号列表,不可为 null 或空,否则返回 191004 参数错误。
    success V2NIMSuccessCallback - 获取成功回调,返回 V2NIMTeamMember 列表。
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    Web/uni-app/小程序
    typescriptgetTeamMemberListByIds(teamId: string, teamType: V2NIMTeamType, accountIds: string[]): Promise<V2NIMTeamMember[]>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID 列表,不可为空,否则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountIds string[] - 群成员账号列表,不可为 null 或空,否则返回 191004 参数错误。
    Harmony
    typescriptgetTeamMemberListByIds(teamId: string, teamType: V2NIMTeamType, accountIds: string[]): Promise<V2NIMTeamMember[]>
    
    参数名称 类型 是否必填 默认值 描述
    teamId string - 群组 ID 列表,不可为空,否则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountIds string[] - 群成员账号列表,不可为 null 或空,否则返回 191004 参数错误。

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    String teamId = "123456";
    V2NIMTeamType teamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL;
    List<String> accountIds = new ArrayList<>();
    accountIds.add("test1");
    accountIds.add("test2");
    v2TeamService.getTeamMemberListByIds(teamId,teamType, accountIds, result -> {
        // 获取群组成员列表成功
    }, error -> {
        // 获取群组成员列表失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] getTeamMemberListByIds:@"teamId" teamType:V2NIM_TEAM_TYPE_NORMAL accountIds:@[@"accountId"] success:^(NSArray<V2NIMTeamMember *> * _Nonnull memberList) {
        // 获取群组成员列表成功
    } failure:^(V2NIMError * _Nonnull error) {
        // 获取群组成员列表失败
    }];
    
    macOS/Windows
    cppnstd::vector<nstd::string> accountIds;
    accountIds.push_back("account1");
    accountIds.push_back("account2");
    teamService.getTeamMemberListByIds(
        "teamId",
        V2NIM_TEAM_TYPE_NORMAL,
        accountIds,
        [](nstd::vector<V2NIMTeamMember> memberList) {
            // get team members by account ids success
        },
        [](V2NIMError error) {
            // get team members by account ids failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.getTeamMemberListByIds("123456", 1, ["accountId1"])
    
    Harmony
    typescripttry {
      const teamId: string = "123456"
      const teamType: V2NIMTeamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL
      const accounts = ["aaa", "bbb"]
    
      const members: V2NIMTeamMember[] = await nim.teamService.getTeamMemberListByIds(teamId, teamType, accountIds)
      // success
    } catch (err) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<V2NIMTeamMember[]> 群成员列表

    相关回调

    Android/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调,包含 V2NIMTeamMember 列表。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    iOS
    • 请求成功,返回 V2NIMConversationListCallback 回调,可自定义设置。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    getTeamMemberInvitor

    接口描述

    根据群成员账号获取群成员邀请人。

    SDK 获取策略如下:

    查询引用消息.drawio.png

    群组数据同步(V2NIMTeamListener.onSyncFinished)完成前,可能获取不到完整数据。

    参数说明

    Android
    javavoid getTeamMemberInvitor(String teamId, V2NIMTeamType teamType, List<String> accountIds, V2NIMSuccessCallback<Map<String, String>> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    teamId String - 群组 ID 列表,不可为空,否则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountIds List - 群成员账号列表,不可为 null 或空,否则返回 191004 参数错误。
    success V2NIMSuccessCallback - 获取成功回调,返回格式如下:
    Map<String, String>(key: accountId, value: invitorAccountId)
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    iOS
    objective-c- (void)getTeamMemberInvitor:(NSString *)teamId
                        teamType:(V2NIMTeamType)teamType
                      accountIds:(NSArray<NSString *> *)accountIds
                         success:(nullable V2NIMTeamMemberInvitorResultCallback)success
                         failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    teamId NSString * - 群组 ID 列表,不可为空,否则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountIds NSArray<NSString *> * - 群成员账号列表,不可为 null 或空,否则返回 191004 参数错误。
    success V2NIMTeamMemberInvitorResultCallback - 获取成功回调,可自定义设置。
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    macOS/Windows
    cppvirtual void getTeamMemberInvitor(nstd::string teamId,
                                     V2NIMTeamType teamType,
                                     nstd::vector<nstd::string> accountIds,
                                     V2NIMSuccessCallback<nstd::map<nstd::string, nstd::string>> success,
                                     V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    teamId nstd::string - 群组 ID 列表,不可为空,否则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountIds nstd::vector<nstd::string> - 群成员账号列表,不可为 null 或空,否则返回 191004 参数错误。
    success V2NIMSuccessCallback - 获取成功回调,返回格式如下:
    nstd::map<nstd::string, nstd::string>(key: accountId, value: invitorAccountId)
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    Web/uni-app/小程序
    typescriptgetTeamMemberInvitor(teamId: string, teamType: V2NIMTeamType, accountIds: string[]): Promise<{ [accountId: string]: string }>
    
    参数名称 类型 是否必填 默认值 描述
    teamIds string - 群组 ID 列表,不可为空,否则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountIds string[] - 群成员账号列表,不可为 null 或空,否则返回 191004 参数错误。
    Harmony
    typescriptgetTeamMemberInvitor(teamId: string, teamType: V2NIMTeamType, accountIds: string[]): Promise<{ [accountId: string]: string }>
    
    参数名称 类型 是否必填 默认值 描述
    teamIds string - 群组 ID 列表,不可为空,否则返回 191004 参数错误。
    teamType V2NIMTeamType - 群组类型,包括高级群和超大群。
    accountIds string[] - 群成员账号列表,不可为 null 或空,否则返回 191004 参数错误。

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    String teamId = "123456";
    V2NIMTeamType teamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL;
    List<String> accountIds = new ArrayList<>();
    accountIds.add("test1");
    accountIds.add("test2");
    v2TeamService.getTeamMemberInvitor(teamId,teamType, accountIds, result -> {
        // 获取群组成员邀请人成功
    }, error -> {
        // 获取群组成员邀请人失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] getTeamMemberInvitor:@"teamId" teamType:V2NIM_TEAM_TYPE_NORMAL accountIds:@[@"accountId"] success:^(NSDictionary<NSString *,NSString *> * _Nonnull result) {
            // 获取群组成员邀请人成功
        } failure:^(V2NIMError * _Nonnull error) {
            // 获取群组成员邀请人失败
    }];
    
    macOS/Windows
    cppnstd::vector<nstd::string> accountIds;
    accountIds.push_back("account1");
    accountIds.push_back("account2");
    teamService.getTeamMemberInvitor(
        "teamId",
        V2NIM_TEAM_TYPE_NORMAL,
        accountIds,
        [](nstd::map<nstd::string, nstd::string> invitors) {
            // get team member invitor success
        },
        [](V2NIMError error) {
            // get team member invitor failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.getTeamMemberInvitor("123456", 1, ["accountId1"])
    
    Harmony
    typescripttry {
      const teamId: string = "123456"
      const teamType: V2NIMTeamType = V2NIMTeamType.V2NIM_TEAM_TYPE_NORMAL
      const accounts = ["aaa", "bbb"]
    
      const keyValue = await nim.teamService.getTeamMemberInvitor(teamId, teamType, accountIds)
      // success
    } catch (err) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    Promise<{ [accountId: string]: string }>
    注:key: accountId, value: invitorAccountId

    相关回调

    Android/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    iOS
    • 请求成功,返回 V2NIMTeamMemberInvitorResultCallback 回调,可自定义设置。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    getTeamJoinActionInfoList

    接口描述

    分页获取入群操作相关信息列表。返回列表按照入群请求时间戳(V2NIMTeamJoinActionInfo.timestamp)逆序排序。

    仅查询本地数据。

    参数说明

    Android
    javavoid getTeamJoinActionInfoList(V2NIMTeamJoinActionInfoQueryOption option, V2NIMSuccessCallback<V2NIMTeamJoinActionInfoResult> success, V2NIMFailureCallback failure);
    
    参数名称 类型 是否必填 默认值 描述
    option V2NIMTeamJoinActionInfoQueryOption - 入群操作信息查询选项
    success V2NIMSuccessCallback - 获取成功回调,返回 V2NIMTeamJoinActionInfoResult
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    iOS
    objective-c- (void)getTeamJoinActionInfoList:(V2NIMTeamJoinActionInfoQueryOption *)option
                              success:(nullable V2NIMTeamJoinActionInfoResultCallback)success
                              failure:(nullable V2NIMFailureCallback)failure;
    
    参数名称 类型 是否必填 默认值 描述
    option V2NIMTeamJoinActionInfoQueryOption * - 入群操作信息查询选项
    success V2NIMTeamJoinActionInfoResultCallback - 获取成功回调,可自定义设置。
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    macOS/Windows
    cppvirtual void getTeamJoinActionInfoList(V2NIMTeamJoinActionInfoQueryOption option,
        V2NIMSuccessCallback<V2NIMTeamJoinActionInfoResult> success,
        V2NIMFailureCallback failure) = 0;
    
    参数名称 类型 是否必填 默认值 描述
    option V2NIMTeamJoinActionInfoQueryOption - 入群操作信息查询选项
    success V2NIMSuccessCallback - 获取成功回调,返回 V2NIMTeamJoinActionInfoResult
    failure V2NIMFailureCallback - 获取失败回调,返回错误码
    Web/uni-app/小程序
    typescriptgetTeamJoinActionInfoList(option: V2NIMTeamJoinActionInfoQueryOption): Promise<V2NIMTeamJoinActionInfoResult>
    
    参数名称 类型 是否必填 默认值 描述
    option V2NIMTeamJoinActionInfoQueryOption - 入群操作信息查询选项
    Harmony
    typescriptgetTeamJoinActionInfoList(option: V2NIMTeamJoinActionInfoQueryOption): Promise<V2NIMTeamJoinActionInfoResult>
    
    参数名称 类型 是否必填 默认值 描述
    option V2NIMTeamJoinActionInfoQueryOption - 入群操作信息查询选项

    示例代码

    Android
    javaV2NIMTeamService v2TeamService = NIMClient.getService(V2NIMTeamService.class);
    V2NIMTeamJoinActionInfoQueryOption option = new V2NIMTeamJoinActionInfoQueryOption();
    option.setOffset(0L);
    option.setLimit(50);
    List<V2NIMTeamJoinActionType> types = new ArrayList<>();
    types.add(V2NIMTeamJoinActionType.V2NIM_TEAM_JOIN_ACTION_TYPE_APPLICATION);
    types.add(V2NIMTeamJoinActionType.V2NIM_TEAM_JOIN_ACTION_TYPE_INVITATION);
    option.setTypes(types);
    List<V2NIMTeamJoinActionStatus> status = new ArrayList<>();
    status.add(V2NIMTeamJoinActionStatus.V2NIM_TEAM_JOIN_ACTION_STATUS_INIT);
    option.setStatus(status);
    v2TeamService.getTeamJoinActionInfoList(option, result -> {
        // 获取群加入相关信息成功
    }, error -> {
        // 获取群加入相关信息失败
    });
    
    iOS
    objective-c[[[NIMSDK sharedSDK] v2TeamService] getTeamJoinActionInfoList:queryParam success:^(V2NIMTeamJoinActionInfoResult * _Nonnull result) {
            // 获取群加入相关信息成功
        } failure:^(V2NIMError * _Nonnull error) {
            // 获取群加入相关信息失败
        }];
    
    macOS/Windows
    cppV2NIMTeamJoinActionInfoQueryOption option;
    option.offset = 0;
    option.limit = 10;
    teamService.getTeamJoinActionInfoList(
        option,
        [](V2NIMTeamJoinActionInfoResult result) {
            // get team join action info list success
        },
        [](V2NIMError error) {
            // get team join action info list failed, handle error
        });
    
    Web/uni-app/小程序
    typescriptawait nim.V2NIMTeamService.getTeamJoinActionInfoList(
      {
        "offset": 0,
        "limit": 50
      }
    )
    
    Harmony
    typescripttry {
      const params = {
        types: [V2NIMTeamJoinActionType.V2NIM_TEAM_JOIN_ACTION_TYPE_APPLICATION],
        status: [V2NIMTeamJoinActionStatus.V2NIM_TEAM_JOIN_ACTION_STATUS_INIT],
        offset: 0,
        limit: 50
      } as V2NIMTeamJoinActionInfoQueryOption
    
      const actionList: V2NIMTeamJoinActionInfoResult = await nim.teamService.getTeamJoinActionInfoList(params)
      // success
    } catch (error) {
      // fail
    }
    

    返回值

    Android/iOS/macOS/Windows

    无返回值

    Web/uni-app/小程序/Harmony

    相关回调

    Android/macOS/Windows
    • 请求成功,返回 V2NIMSuccessCallback 回调,包含 V2NIMTeamJoinActionInfoResult
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    iOS
    • 请求成功,返回 V2NIMTeamJoinActionInfoResultCallback 回调,可自定义设置。
    • 请求失败,返回 V2NIMFailureCallback 回调,包含群组相关错误码。
    Web/uni-app/小程序/Harmony

    此文档是否对你有帮助?
    有帮助
    去反馈
    • 支持平台
    • API 概览
    • 群组监听
    • 群组操作
    • 接口类
    • addTeamListener
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • removeTeamListener
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • on("EventName")
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • off("EventName")
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • createTeam
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • leaveTeam
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • updateTeamInfo
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • getTeamInfo
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • getTeamInfoByIds
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • dismissTeam
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • inviteMember
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • acceptInvitation
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • rejectInvitation
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • kickMember
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • applyJoinTeam
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • acceptJoinApplication
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • rejectJoinApplication
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • updateTeamMemberRole
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • transferTeamOwner
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • updateSelfTeamMemberInfo
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • updateTeamMemberNick
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • setTeamChatBannedMode
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • setTeamMemberChatBannedStatus
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • getJoinedTeamList
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • getJoinedTeamCount
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • getTeamMemberList
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • getTeamMemberListByIds
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • getTeamMemberInvitor
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调
    • getTeamJoinActionInfoList
    • 接口描述
    • 参数说明
    • 示例代码
    • 返回值
    • 相关回调