浏览 SDKs · iOS
SDKsiOS商业版

创建会话分组

使用 Open_im_sdkCreateConversationGroup 创建会话分组。

复制

Open_im_sdkCreateConversationGroup 使用 JSON req 创建当前用户的会话分组。普通分组至少需要名称;需要同时放入一个会话时,可以传入 conversationID

参数说明

字段是否必填说明
name必填分组名称。
order可选顺序值;排序方向由产品统一约定。
ex可选业务扩展字符串。
conversationID可选创建后立即加入该分组的会话。
conversationGroupType可选0 为普通分组,1 为筛选分组。
#import <OpenIMSDK/CallbackProxy.h>
@import OpenIMCore;

NSDictionary *request = @{
    @"name": @"工作",
    @"order": @100,
    @"conversationID": conversationID,
    @"conversationGroupType": @0,
};

NSData *requestData = [NSJSONSerialization dataWithJSONObject:request options:0 error:nil];
NSString *requestJSON = [[NSString alloc] initWithData:requestData
                                              encoding:NSUTF8StringEncoding];

CallbackProxy *callback = [[CallbackProxy alloc]
    initWithOnSuccess:^(NSString * _Nullable data) {
        if (data == nil) {
            return;
        }
        [self upsertConversationGroupJSON:data];
    }
    onFailure:^(NSInteger code, NSString * _Nullable message) {
        [self showConversationGroupError:code message:message ?: @"创建会话分组失败"];
    }];

callbackrequestJSON 交给 Open_im_sdkCreateConversationGroup

返回结果

成功 callback 的 data 是一个分组 JSON 对象。常用字段包括 conversationGroupIDnameorderversionconversationGroupTypehiddenunreadCountconversationIDs

其他登录端或后续同步可能收到 onConversationGroupAdded:。listener 的完整归属见会话分组概览