IMSDK
即时通信 IM 提供全球接入、单聊、群聊、消息推送、资料关系链托管、账号鉴权等全方位解决方案，并提供完备的 App 接入、后台管理接口。
构造函数 | Protected 类型
V2TIMManager(Group)

构造函数

(void) - createGroup:memberList:succ:fail:
 
(void) - getJoinedGroupList:fail:
 
(void) - getGroupsInfo:succ:fail:
 
(void) - searchGroups:succ:fail:
 
(void) - searchCloudGroups:succ:fail:
 
(void) - setGroupInfo:succ:fail:
 
(void) - initGroupAttributes:attributes:succ:fail:
 
(void) - setGroupAttributes:attributes:succ:fail:
 
(void) - deleteGroupAttributes:keys:succ:fail:
 
(void) - getGroupAttributes:keys:succ:fail:
 
(void) - getGroupOnlineMemberCount:succ:fail:
 
(void) - setGroupCounters:counters:succ:fail:
 
(void) - getGroupCounters:keys:succ:fail:
 
(void) - increaseGroupCounter:key:value:succ:fail:
 
(void) - decreaseGroupCounter:key:value:succ:fail:
 
(void) - getGroupMemberList:filter:nextSeq:succ:fail:
 
(void) - getGroupMembersInfo:memberList:succ:fail:
 
(void) - searchGroupMembers:succ:fail:
 
(void) - searchCloudGroupMembers:succ:fail:
 
(void) - setGroupMemberInfo:info:succ:fail:
 
(void) - muteGroupMember:member:muteTime:succ:fail:
 
(void) - muteAllGroupMembers:isMute:succ:fail:
 
(void) - inviteUserToGroup:userList:succ:fail:
 
(void) - kickGroupMember:memberList:reason:duration:succ:fail:
 
(void) - setGroupMemberRole:member:newRole:succ:fail:
 
(void) - markGroupMemberList:memberList:markType:enableMark:succ:fail:
 
(void) - transferGroupOwner:member:succ:fail:
 
(void) - kickGroupMember:memberList:reason:succ:fail:
 
(void) - getGroupApplicationList:fail:
 
(void) - acceptGroupApplication:reason:succ:fail:
 
(void) - refuseGroupApplication:reason:succ:fail:
 
(void) - setGroupApplicationRead:fail:
 

Protected 类型

enum  V2TIMGroupAddOpt : NSInteger
 
enum  V2TIMGroupMemberResult : NSInteger
 
enum  V2TIMGroupMemberFilter : NSInteger
 
enum  V2TIMGroupApplicationType : NSInteger
 
enum  V2TIMGroupApplicationHandleStatus : NSInteger
 
enum  V2TIMGroupApplicationHandleResult : NSInteger
 
typedef void(^ V2TIMGroupInfoListSucc) (NSArray< V2TIMGroupInfo * > *groupList)
 
typedef void(^ V2TIMGroupInfoResultListSucc) (NSArray< V2TIMGroupInfoResult * > *groupResultList)
 
typedef void(^ V2TIMGroupSearchResultSucc) (V2TIMGroupSearchResult *searchResult)
 
typedef void(^ V2TIMGroupAttributeListSucc) (NSMutableDictionary< NSString *, NSString * > *groupAttributeList)
 
typedef void(^ V2TIMGroupMemberInfoListSucc) (NSArray< V2TIMGroupMemberFullInfo * > *memberList)
 
typedef void(^ V2TIMGroupMemberInfoResultSucc) (uint64_t nextSeq, NSArray< V2TIMGroupMemberFullInfo * > *memberList)
 
typedef void(^ V2TIMGroupMemberInfoListSearchSucc) (NSDictionary< NSString *, NSArray< V2TIMGroupMemberFullInfo * > * > *memberList)
 
typedef void(^ V2TIMGroupMemberSearchResultSucc) (V2TIMGroupMemberSearchResult *searchResult)
 
typedef void(^ V2TIMGroupMemberOperationResultListSucc) (NSArray< V2TIMGroupMemberOperationResult * > *resultList)
 
typedef void(^ V2TIMGroupApplicationResultSucc) (V2TIMGroupApplicationResult *result)
 
typedef void(^ V2TIMGroupOnlineMemberCountSucc) (NSInteger count)
 
typedef void(^ V2TIMGroupCounterResultSucc) (NSDictionary< NSString *, NSNumber * > *groupCounters)
 

成员类型定义说明

◆ V2TIMGroupInfoListSucc

- (typedef void(^ V2TIMGroupInfoListSucc) (NSArray< V2TIMGroupInfo * > *groupList))
protected

获取已加入群列表成功回调

◆ V2TIMGroupInfoResultListSucc

- (typedef void(^ V2TIMGroupInfoResultListSucc) (NSArray< V2TIMGroupInfoResult * > *groupResultList))
protected

获取指定群列表成功回调

◆ V2TIMGroupSearchResultSucc

- (typedef void(^ V2TIMGroupSearchResultSucc) (V2TIMGroupSearchResult *searchResult))
protected

云端搜索群组的结果回调

◆ V2TIMGroupAttributeListSucc

- (typedef void(^ V2TIMGroupAttributeListSucc) (NSMutableDictionary< NSString *, NSString * > *groupAttributeList))
protected

获取群属性列表成功回调

◆ V2TIMGroupMemberInfoListSucc

- (typedef void(^ V2TIMGroupMemberInfoListSucc) (NSArray< V2TIMGroupMemberFullInfo * > *memberList))
protected

获取群成员列表成功回调

◆ V2TIMGroupMemberInfoResultSucc

- (typedef void(^ V2TIMGroupMemberInfoResultSucc) (uint64_t nextSeq, NSArray< V2TIMGroupMemberFullInfo * > *memberList))
protected

获取指定群成员列表成功回调

◆ V2TIMGroupMemberInfoListSearchSucc

- (typedef void(^ V2TIMGroupMemberInfoListSearchSucc) (NSDictionary< NSString *, NSArray< V2TIMGroupMemberFullInfo * > * > *memberList))
protected

搜索本地群成员列表成功回调

◆ V2TIMGroupMemberSearchResultSucc

- (typedef void(^ V2TIMGroupMemberSearchResultSucc) (V2TIMGroupMemberSearchResult *searchResult))
protected

搜索云端群成员列表成功回调

◆ V2TIMGroupMemberOperationResultListSucc

- (typedef void(^ V2TIMGroupMemberOperationResultListSucc) (NSArray< V2TIMGroupMemberOperationResult * > *resultList))
protected

群成员操作成功回调

◆ V2TIMGroupApplicationResultSucc

- (typedef void(^ V2TIMGroupApplicationResultSucc) (V2TIMGroupApplicationResult *result))
protected

获取好友申请列表成功回调

◆ V2TIMGroupOnlineMemberCountSucc

- (typedef void(^ V2TIMGroupOnlineMemberCountSucc) (NSInteger count))
protected

获取群在线人数成功回调

◆ V2TIMGroupCounterResultSucc

- (typedef void(^ V2TIMGroupCounterResultSucc) (NSDictionary< NSString *, NSNumber * > *groupCounters))
protected

群计数器操作成功的回调

成员枚举类型说明

◆ V2TIMGroupAddOpt

- (enum V2TIMGroupAddOpt) :
protected

加群选项

枚举值
V2TIM_GROUP_ADD_FORBID 

禁止加群

V2TIM_GROUP_ADD_AUTH 

需要管理员审批

V2TIM_GROUP_ADD_ANY 

任何人可以加入

◆ V2TIMGroupMemberResult

- (enum V2TIMGroupMemberResult) :
protected

群组操作结果

枚举值
V2TIM_GROUP_MEMBER_RESULT_FAIL 

操作失败

V2TIM_GROUP_MEMBER_RESULT_SUCC 

操作成功

V2TIM_GROUP_MEMBER_RESULT_INVALID 

无效操作，加群时已经是群成员，移除群组时不在群内

V2TIM_GROUP_MEMBER_RESULT_PENDING 

等待处理，邀请入群时等待审批

V2TIM_GROUP_MEMBER_RESULT_OVERLIMIT 

操作失败，创建群指定初始群成员列表或邀请入群时，被邀请者加入的群总数超限

◆ V2TIMGroupMemberFilter

- (enum V2TIMGroupMemberFilter) :
protected

群成员角色过滤方式

枚举值
V2TIM_GROUP_MEMBER_FILTER_ALL 

全部成员

V2TIM_GROUP_MEMBER_FILTER_OWNER 

群主

V2TIM_GROUP_MEMBER_FILTER_ADMIN 

管理员

V2TIM_GROUP_MEMBER_FILTER_COMMON 

普通成员

◆ V2TIMGroupApplicationType

- (enum V2TIMGroupApplicationType) :
protected

群组未决请求类型

枚举值
V2TIM_GROUP_JOIN_APPLICATION_NEED_APPROVED_BY_ADMIN 

需要群主或管理员审批的申请加群请求

V2TIM_GROUP_INVITE_APPLICATION_NEED_APPROVED_BY_INVITEE 

需要被邀请者同意的邀请入群请求

V2TIM_GROUP_INVITE_APPLICATION_NEED_APPROVED_BY_ADMIN 

需要群主或管理员审批的邀请入群请求

◆ V2TIMGroupApplicationHandleStatus

- (enum V2TIMGroupApplicationHandleStatus) :
protected

群组已决标志

枚举值
V2TIM_GROUP_APPLICATION_HANDLE_STATUS_UNHANDLED 

未处理

V2TIM_GROUP_APPLICATION_HANDLE_STATUS_HANDLED_BY_OTHER 

被他人处理

V2TIM_GROUP_APPLICATION_HANDLE_STATUS_HANDLED_BY_SELF 

自己已处理

◆ V2TIMGroupApplicationHandleResult

- (enum V2TIMGroupApplicationHandleResult) :
protected

群组已决结果

枚举值
V2TIM_GROUP_APPLICATION_HANDLE_RESULT_REFUSE 

拒绝申请

V2TIM_GROUP_APPLICATION_HANDLE_RESULT_AGREE 

同意申请

函数文档

◆ createGroup:memberList:succ:fail:()

- (void) createGroup: (V2TIMGroupInfo *)  info
memberList: (NSArray< V2TIMCreateGroupMemberInfo * > *_Nullable)  memberList
succ: (V2TIMCreateGroupSucc)  succ
fail: (createGroup(info:memberList:succ:fail:))  NS_SWIFT_NAME 

1.1 创建自定义群组（高级版本：可以指定初始的群成员）

参数
info自定义群组信息，可以设置 groupID | groupType | groupName | notification | introduction | faceURL 字段
memberList指定初始的群成员（直播群 AVChatRoom 不支持指定初始群成员，memberList 请传 nil）
注意
  • 后台限制邀请的群成员个数不能超过 20
  • 其他限制请参考 V2TIMManager.h -> createGroup 注释

◆ getJoinedGroupList:fail:()

- (void) getJoinedGroupList: (V2TIMGroupInfoListSucc)  succ
fail: (getJoinedGroupList(succ:fail:))  NS_SWIFT_NAME 

1.2 获取当前用户已经加入的群列表

注意
  • 直播群（AVChatRoom）不支持该 API
  • 该接口有频限检测，SDK 限制调用频率为 1 秒 10 次，超过限制后会报 ERR_SDK_COMM_API_CALL_FREQUENCY_LIMIT （7008）错误

◆ getGroupsInfo:succ:fail:()

- (void) getGroupsInfo: (NSArray< NSString * > *)  groupIDList
succ: (V2TIMGroupInfoResultListSucc)  succ
fail: (V2TIMFail)  fail 

2.1 拉取群资料

参数
groupIDList群组 ID 列表

◆ searchGroups:succ:fail:()

- (void) searchGroups: (V2TIMGroupSearchParam *)  searchParam
succ: (V2TIMGroupInfoListSucc)  succ
fail: (searchGroups(searchParam:succ:fail:))  NS_SWIFT_NAME 

2.2 搜索本地群资料（5.4.666 及以上版本支持）

注意
该功能为 IM 旗舰版功能，购买旗舰版套餐包后可使用，详见价格说明

◆ searchCloudGroups:succ:fail:()

- (void) searchCloudGroups: (V2TIMGroupSearchParam *)  searchParam
succ: (V2TIMGroupSearchResultSucc)  succ
fail: (searchCloudGroups(searchParam:succ:fail:))  NS_SWIFT_NAME 

2.3 搜索云端群资料（8.4 及以上版本支持）

注意
该功能为 IM 增值功能，详见价格说明

◆ setGroupInfo:succ:fail:()

- (void) setGroupInfo: (V2TIMGroupInfo *)  info
succ: (_Nullable V2TIMSucc)  succ
fail: (setGroupInfo(info:succ:fail:))  NS_SWIFT_NAME 

2.4 修改群资料

◆ initGroupAttributes:attributes:succ:fail:()

- (void) initGroupAttributes: (NSString *)  groupID
attributes: (NSDictionary< NSString *, NSString * > *)  attributes
succ: (_Nullable V2TIMSucc)  succ
fail: (initGroupAttributes(groupID:attributes:succ:fail:))  NS_SWIFT_NAME 

2.5 初始化群属性，会清空原有的群属性列表

注意
attributes 的使用限制如下：
  • 6.7 及其以前版本，只支持 AVChatRoom 直播群；
  • 从 6.8 版本开始，同时支持 AVChatRoom、Public、Meeting、Work 四种群类型；
  • 从 7.0 版本开始，除了话题外，群属性支持所有的群类型；
  • key 最多支持 16 个，长度限制为 32 字节；
  • value 长度限制为 4k；
  • 总的 attributes（包括 key 和 value）限制为 16k；
  • initGroupAttributes、setGroupAttributes、deleteGroupAttributes 接口合并计算， SDK 限制为 5 秒 10 次，超过后回调 8511 错误码；后台限制 1 秒 5 次，超过后返回 10049 错误码；
  • getGroupAttributes 接口 SDK 限制 5 秒 20 次；
  • 从 5.6 版本开始，当每次APP启动后初次修改群属性时，请您先调用 getGroupAttributes 拉取到最新的群属性之后，再发起修改操作；
  • 从 5.6 版本开始，当多个用户同时修改同一个群属性时，只有第一个用户可以执行成功，其它用户会收到 10056 错误码；收到这个错误码之后，请您调用 getGroupAttributes 把本地保存的群属性更新到最新之后，再发起修改操作。

◆ setGroupAttributes:attributes:succ:fail:()

- (void) setGroupAttributes: (NSString *)  groupID
attributes: (NSDictionary< NSString *, NSString * > *)  attributes
succ: (_Nullable V2TIMSucc)  succ
fail: (setGroupAttributes(groupID:attributes:succ:fail:))  NS_SWIFT_NAME 

2.6 设置群属性，已有该群属性则更新其 value 值，没有该群属性则添加该群属性。

注意
  • 6.7 及其以前版本，只支持 AVChatRoom 直播群；
  • 从 6.8 版本开始，同时支持 AVChatRoom、Public、Meeting、Work 四种群类型；
  • 从 7.0 版本开始，除了话题外，群属性支持所有的群类型。

◆ deleteGroupAttributes:keys:succ:fail:()

- (void) deleteGroupAttributes: (NSString *)  groupID
keys: (NSArray< NSString * > *_Nullable)  keys
succ: (_Nullable V2TIMSucc)  succ
fail: (deleteGroupAttributes(groupID:keys:succ:fail:))  NS_SWIFT_NAME 

2.7 删除群指定属性，keys 传 nil 则清空所有群属性。

注意
  • 6.7 及其以前版本，只支持 AVChatRoom 直播群；
  • 从 6.8 版本开始，同时支持 AVChatRoom、Public、Meeting、Work 四种群类型；
  • 从 7.0 版本开始，除了话题外，群属性支持所有的群类型。

◆ getGroupAttributes:keys:succ:fail:()

- (void) getGroupAttributes: (NSString *)  groupID
keys: (NSArray< NSString * > *_Nullable)  keys
succ: (V2TIMGroupAttributeListSucc)  succ
fail: (V2TIMFail)  fail 

2.8 获取群指定属性，keys 传 nil 则获取所有群属性。

注意
  • 6.7 及其以前版本，只支持 AVChatRoom 直播群；
  • 从 6.8 版本开始，同时支持 AVChatRoom、Public、Meeting、Work 四种群类型；
  • 从 7.0 版本开始，除了话题外，群属性支持所有的群类型。

◆ getGroupOnlineMemberCount:succ:fail:()

- (void) getGroupOnlineMemberCount: (NSString *)  groupID
succ: (V2TIMGroupOnlineMemberCountSucc)  succ
fail: (getGroupOnlineMemberCount(groupID:succ:fail:))  NS_SWIFT_NAME 

2.9 获取指定群在线人数

参数
groupID群id
succ成功回调
fail失败回调
注意
  • IMSDK 7.3 以前的版本仅支持直播群（ AVChatRoom）；
  • IMSDK 7.3 及其以后的版本支持所有群类型。

◆ setGroupCounters:counters:succ:fail:()

- (void) setGroupCounters: (NSString *)  groupID
counters: (NSDictionary< NSString *, NSNumber * > *)  counters
succ: (V2TIMGroupCounterResultSucc)  succ
fail: (setGroupCounters(groupID:counters:succ:fail:))  NS_SWIFT_NAME 

2.10 设置群计数器（7.0 及其以上版本支持）

注意
  • 该计数器的 key 如果存在，则直接更新计数器的 value 值；如果不存在，则添加该计数器的 key-value；
  • 当群计数器设置成功后，在 succ 回调中会返回最终成功设置的群计数器信息；
  • 除了社群和话题，群计数器支持所有的群组类型。

◆ getGroupCounters:keys:succ:fail:()

- (void) getGroupCounters: (NSString *)  groupID
keys: (NSArray< NSString * > *_Nullable)  keys
succ: (V2TIMGroupCounterResultSucc)  succ
fail: (getGroupCounters(groupID:keys:succ:fail:))  NS_SWIFT_NAME 

2.11 获取群计数器（7.0 及其以上版本支持）

注意
  • 如果 keys 为空，则表示获取群内的所有计数器；
  • 除了社群和话题，群计数器支持所有的群组类型。

◆ increaseGroupCounter:key:value:succ:fail:()

- (void) increaseGroupCounter: (NSString *)  groupID
key: (NSString *)  key
value: (NSInteger)  value
succ: (V2TIMGroupCounterResultSucc)  succ
fail: (increaseGroupCounter(groupID:key:value:succ:fail:))  NS_SWIFT_NAME 

2.12 递增群计数器（7.0 及其以上版本支持）

参数
groupID群 ID
key群计数器的 key
value群计数器的递增的变化量，计数器 key 对应的 value 变更方式为： new_value = old_value + value
succ成功后的回调，会返回当前计数器做完递增操作后的 value
fail失败的回调
注意
  • 该计数器的 key 如果存在，则直接在当前值的基础上根据传入的 value 作递增操作；反之，添加 key，并在默认值为 0 的基础上根据传入的 value 作递增操作；
  • 除了社群和话题，群计数器支持所有的群组类型。

◆ decreaseGroupCounter:key:value:succ:fail:()

- (void) decreaseGroupCounter: (NSString *)  groupID
key: (NSString *)  key
value: (NSInteger)  value
succ: (V2TIMGroupCounterResultSucc)  succ
fail: (decreaseGroupCounter(groupID:key:value:succ:fail:))  NS_SWIFT_NAME 

2.13 递减群计数器（7.0 及其以上版本支持）

参数
groupID群 ID
key群计数器的 key
value群计数器的递减的变化量，计数器 key 对应的 value 变更方式为： new_value = old_value - value
succ成功后的回调，会返回当前计数器做完递减操作后的 value
fail失败的回调
注意
  • 该计数器的 key 如果存在，则直接在当前值的基础上根据传入的 value 作递减操作；反之，添加 key，并在默认值为 0 的基础上根据传入的 value 作递减操作
  • 除了社群和话题，群计数器支持所有的群组类型。

◆ getGroupMemberList:filter:nextSeq:succ:fail:()

- (void) getGroupMemberList: (NSString *)  groupID
filter: (uint32_t)  filter
nextSeq: (uint64_t)  nextSeq
succ: (V2TIMGroupMemberInfoResultSucc)  succ
fail: (V2TIMFail)  fail 

3.1 获取群成员列表

参数
filter指定群成员类型。
nextSeq分页拉取标志，第一次拉取填 0，回调成功如果 nextSeq 不为零，需要分页，传入再次拉取，直至为 0。
注意
  • 普通群（工作群、会议群、公开群）的限制：
  1. filter 只能设置为 V2TIMGroupMemberFilter 定义的数值，SDK 会返回指定角色的成员。
  • 直播群（AVChatRoom）的限制：
  1. 如果设置 filter 为 V2TIMGroupMemberFilter 定义的数值，SDK 返回全部成员。返回的人数规则为：拉取最近入群群成员最多 1000 人，新进来的成员排在前面，需要升级旗舰版，并且在 控制台 开启“直播群在线成员列表”开关（6.3 及以上版本支持）。
  2. 如果设置 filter 为群成员自定义标记，旗舰版支持拉取指定标记的成员列表。标记群成员的设置请参考 markGroupMemberList:memberList:markType:enableMark:succ:fail: API。
  3. 程序重启后，请重新加入群组，否则拉取群成员会报 10007 错误码。
  4. 群成员资料信息仅支持 userID | nickName | faceURL | role 字段。
  • 社群（Community）的限制：
  1. 如果设置 filter 为 V2TIMGroupMemberFilter 定义的数值，SDK 返回指定角色的成员。
  2. 如果设置 filter 为群成员自定义标记，旗舰版支持拉取指定标记的成员列表(7.5 及以上版本支持）。标记群成员的设置请参考 markGroupMemberList:memberList:markType:enableMark:succ:fail: API。

◆ getGroupMembersInfo:memberList:succ:fail:()

- (void) getGroupMembersInfo: (NSString *)  groupID
memberList: (NSArray< NSString * > *)  memberList
succ: (V2TIMGroupMemberInfoListSucc)  succ
fail: (getGroupMembersInfo(groupID:memberList:succ:fail:))  NS_SWIFT_NAME 

3.2 指定的群成员资料

◆ searchGroupMembers:succ:fail:()

- (void) searchGroupMembers: (V2TIMGroupMemberSearchParam *)  searchParam
succ: (V2TIMGroupMemberInfoListSearchSucc)  succ
fail: (searchGroupMembers(searchParam:succ:fail:))  NS_SWIFT_NAME 

3.3 搜索本地群成员资料（5.4.666 及以上版本支持）

参数
searchParam搜索参数
注意
该功能为 IM 旗舰版功能，购买旗舰版套餐包后可使用，详见价格说明

◆ searchCloudGroupMembers:succ:fail:()

- (void) searchCloudGroupMembers: (V2TIMGroupMemberSearchParam *)  searchParam
succ: (V2TIMGroupMemberSearchResultSucc)  succ
fail: (searchCloudGroupMembers(searchParam:succ:fail:))  NS_SWIFT_NAME 

3.4 搜索云端群成员资料（8.4 及以上版本支持）

参数
searchParam搜索参数
注意
该功能为 IM 增值功能，详见价格说明

◆ setGroupMemberInfo:info:succ:fail:()

- (void) setGroupMemberInfo: (NSString *)  groupID
info: (V2TIMGroupMemberFullInfo *)  info
succ: (_Nullable V2TIMSucc)  succ
fail: (setGroupMemberInfo(groupID:info:succ:fail:))  NS_SWIFT_NAME 

3.5 修改指定的群成员资料

◆ muteGroupMember:member:muteTime:succ:fail:()

- (void) muteGroupMember: (NSString *)  groupID
member: (NSString *)  userID
muteTime: (uint32_t)  seconds
succ: (_Nullable V2TIMSucc)  succ
fail: (muteGroupMember(groupID:memberUserID:muteTimeSeconds:succ:fail:))  NS_SWIFT_NAME 

3.6 禁言群成员（只有管理员或群主能够调用）

参数
seconds禁言时间长度，单位秒，表示调用该接口成功后多少秒内不允许被禁言用户再发言。

◆ muteAllGroupMembers:isMute:succ:fail:()

- (void) muteAllGroupMembers: (NSString *)  groupID
isMute: (BOOL)  isMute
succ: (_Nullable V2TIMSucc)  succ
fail: (muteAllGroupMembers(groupID:isMute:succ:fail:))  NS_SWIFT_NAME 

3.7 禁言全体群成员，只有管理员或群主能够调用（7.5 及以上版本支持）

参数
groupID群组 ID
isMuteYES 表示禁言，NO 表示解除禁言
注意
  • 禁言全体群成员没有时间限制，设置 isMute 为 NO 则解除禁言。
  • 禁言或解除禁言后，会触发 V2TIMGroupListener 中的 onAllGroupMembersMuted:isMute: 回调。
  • 群主和管理员可以禁言普通成员。普通成员不能操作禁言/解除禁言。

◆ inviteUserToGroup:userList:succ:fail:()

- (void) inviteUserToGroup: (NSString *)  groupID
userList: (NSArray< NSString * > *)  userList
succ: (V2TIMGroupMemberOperationResultListSucc)  succ
fail: (inviteUserToGroup(groupID:userList:succ:fail:))  NS_SWIFT_NAME 

3.8 邀请他人入群

注意
请注意不同类型的群有如下限制：
  • 工作群（Work）：群里的任何人都可以邀请其他人进群。
  • 会议群（Meeting）和公开群（Public）：默认不允许邀请加入群，您可以修改群资料 V2TIMGroupInfo 的 groupApproveOpt 字段打开邀请入群方式。打开该选项之后，群里的任何人都可以邀请其他人进群。
  • 直播群（AVChatRoom）：不支持此功能。
  • 后台限制单次邀请的群成员个数不能超过 20。

◆ kickGroupMember:memberList:reason:duration:succ:fail:()

- (void) kickGroupMember: (NSString *)  groupID
memberList: (NSArray< NSString * > *)  memberList
reason: (NSString *_Nullable)  reason
duration: (uint32_t)  duration
succ: (V2TIMGroupMemberOperationResultListSucc)  succ
fail: (kickGroupMember(groupID:memberList:reason:duration:succ:fail:))  NS_SWIFT_NAME 

3.9 踢人

参数
groupID群 id
memberList被踢用户的 userID 列表
reason被踢的原因
duration指定自被踢出群组开始算起，禁止被踢用户重新申请加群的时长，单位：秒
succ成功后的回调
fail失败后的回调
注意
  • 从 7.2 版本开始，支持设置一个时长参数，用于指定用户从被踢出群组开始算起，禁止重新申请加群的时长；
  • 工作群（Work）：只有群主或 APP 管理员可以踢人；
  • 公开群（Public）、会议群（Meeting）：群主、管理员和 APP 管理员可以踢人；
  • 直播群（AVChatRoom）：6.6 之前版本只支持禁言（muteGroupMember），不支持踢人。6.6 及以上版本支持禁言和踢人。需要您购买旗舰版套餐；
  • 该接口其他使用限制请查阅：https://cloud.tencent.com/document/product/269/75400#.E8.B8.A2.E4.BA.BA。

◆ setGroupMemberRole:member:newRole:succ:fail:()

- (void) setGroupMemberRole: (NSString *)  groupID
member: (NSString *)  userID
newRole: (uint32_t)  role
succ: (_Nullable V2TIMSucc)  succ
fail: (setGroupMemberRole(groupID:memberUserID:newRole:succ:fail:))  NS_SWIFT_NAME 

3.10 切换群成员的角色

注意
请注意不同类型的群有如下限制：
  • 工作群（Work）不支持设置群成员角色。
  • 只有群主才能对群成员进行普通成员和管理员之间的角色切换。
  • 转让群组请调用 transferGroupOwner 接口。
  • 会议群（Meeting）切换群成员角色之后，不会有 onGrantAdministrator 和 onRevokeAdministrator 通知回调。
  • 切换的角色支持普通群成员（ V2TIM_GROUP_MEMBER_ROLE_MEMBER） 和管理员（V2TIM_GROUP_MEMBER_ROLE_ADMIN)。

◆ markGroupMemberList:memberList:markType:enableMark:succ:fail:()

- (void) markGroupMemberList: (NSString *)  groupID
memberList: (NSArray< NSString * > *)  memberList
markType: (uint32_t)  markType
enableMark: (BOOL)  enableMark
succ: (_Nullable V2TIMSucc)  succ
fail: (markGroupMemberList(groupID:memberList:markType:enableMark:succ:fail:))  NS_SWIFT_NAME 

3.11 标记群成员(需要您购买旗舰版套餐)

参数
groupID群 ID。
memberList群成员 ID 列表。
markType标记类型。数字类型，大于等于 1000，您可以自定义，一个群组里最多允许定义 10 个标记。
enableMarkYES 表示添加标记，NO 表示移除标记。
注意
  • 直播群从 6.6 版本开始支持。
  • 社群从 7.5 版本开始支持。
  • 只有群主才有权限标记群组中其他人。

◆ transferGroupOwner:member:succ:fail:()

- (void) transferGroupOwner: (NSString *)  groupID
member: (NSString *)  userID
succ: (_Nullable V2TIMSucc)  succ
fail: (transferGroupOwner(groupID:memberUserID:succ:fail:))  NS_SWIFT_NAME 

3.12 转让群主

注意
请注意不同类型的群有如下限制：
  • 普通类型的群（Work、Public、Meeting）：只有群主才有权限进行群转让操作。
  • 直播群（AVChatRoom）：不支持转让群主。

◆ kickGroupMember:memberList:reason:succ:fail:()

- (void) kickGroupMember: (NSString *)  groupID
memberList: (NSArray< NSString * > *)  memberList
reason: (NSString *_Nullable)  reason
succ: (V2TIMGroupMemberOperationResultListSucc)  succ
fail: (V2TIMFail)  fail 

3.13 踢人（直播群踢人从 6.6 版本开始支持，需要您购买旗舰版套餐）

注意
使用限制如下：
  • 待废弃接口，请使用 kickGroupMember:memberList:reason:duration:succ:fail: 接口；
  • 工作群（Work）：只有群主或 APP 管理员可以踢人；
  • 公开群（Public）、会议群（Meeting）：群主、管理员和 APP 管理员可以踢人；
  • 直播群（AVChatRoom）：6.6 之前版本只支持禁言（muteGroupMember），不支持踢人。6.6 及以上版本支持禁言和踢人；
  • 该接口其他使用限制请查阅：https://cloud.tencent.com/document/product/269/75400#.E8.B8.A2.E4.BA.BA。

◆ getGroupApplicationList:fail:()

- (void) getGroupApplicationList: (V2TIMGroupApplicationResultSucc)  succ
fail: (getGroupApplicationList(succ:fail:))  NS_SWIFT_NAME 

4.1 获取加群申请列表

注意
最多支持50个

◆ acceptGroupApplication:reason:succ:fail:()

- (void) acceptGroupApplication: (V2TIMGroupApplication *)  application
reason: (NSString *_Nullable)  reason
succ: (_Nullable V2TIMSucc)  succ
fail: (acceptGroupApplication(application:reason:succ:fail:))  NS_SWIFT_NAME 

4.2 同意某一条加群申请

◆ refuseGroupApplication:reason:succ:fail:()

- (void) refuseGroupApplication: (V2TIMGroupApplication *)  application
reason: (NSString *_Nullable)  reason
succ: (_Nullable V2TIMSucc)  succ
fail: (refuseGroupApplication(application:reason:succ:fail:))  NS_SWIFT_NAME 

4.3 拒绝某一条加群申请

◆ setGroupApplicationRead:fail:()

- (void) setGroupApplicationRead: (_Nullable V2TIMSucc)  succ
fail: (setGroupApplicationRead(succ:fail:))  NS_SWIFT_NAME 

4.4 标记申请列表为已读