收发消息

收发消息：超级群用「群 + 频道 + 用户组」承载大规模社区；频道可绑定用户组做定向可见。

适用场景​

  • 万人级社区按频道分流
  • 频道级未读/免打扰与定向消息
  • 用户组批量授权频道

前置条件​

  • 服务端已开通超级群能力
  • 群已创建并拿到 groupId
  • 业务侧理解频道/用户组模型

能力与 API​

以下操作来自冻结的 sdk-imlib.json；签名与参数逐字取自 sdk-bindings.json → bindings.ios.imlib.methodMap。

操作Swift 签名返回参数
sendMessagefunc sendMessage(conversationType: IMPConversationType, targetId: String, content: IMPMessageContent, options: IMPSendOptions?) async -> RcResult<IMPMessage>MessageconversationType:ConversationType, targetId:string, content:Content, options?:{clientMsgId?:string, channelId?:string}
getHistoryMessagesfunc getHistoryMessages(conversationType: IMPConversationType, targetId: String, options: IMPHistoryOptions?) async -> RcResult<IMPHistoryPage>{messages:Message[], hasMore:bool}conversationType:ConversationType, targetId:string, options?:{limit?:uint32, beforeSeq?:uint64, channelId?:string}

完整字段与错误码见 API 参考；示例可直接复制到 Swift/Objective-C 工程。

Swift / Objective-C 示例​

let res = await client.sendMessage(conversationType: .group, targetId: "g_1001", content: .text(IMPTextContent(text: "群消息")), options: nil)
[client sendMessageWithConversationType:1 /* 单聊 */ targetId:@"user2" content:@{ @"type": @"text", @"text": @"你好，NI PaaS" } options:nil completion:^(IMPOSResult *result) {
    if (result.code != 0) { NSLog(@"IM 调用失败：%ld %@", (long)result.code, result.msg); }
}];
let historyRes = await client.getHistoryMessages(conversationType: .group, targetId: "g_1001", options: nil)
[client getHistoryMessagesWithConversationType:1 /* 单聊 */ targetId:@"user2" options:nil completion:^(IMPOSResult *result) {
    if (result.code != 0) { NSLog(@"IM 调用失败：%ld %@", (long)result.code, result.msg); }
}];
错误处理

IMLib 不 throw：检查 res.code。常见：1002 Token 无效、1001 参数错误、3001 未连接（可重试）、3002 超时。完整码表见 状态码。

与融云对应页 / 差异​

项内容
融云页面ios-imlib/ultragroup/chat（收发消息）
融云接口状态部分覆盖（主路径可用，子能力缺失）
我方对应sendMessage(options.channelId)、getHistoryMessages(options.channelId)
差异说明频道消息收发可用；缺频道维度的未读/历史批量接口与定向消息

相关错误码​

错误码名称含义处理
1001INVALID_PARAMETER参数错误修正参数/权限后重试
1002INVALID_TOKENToken 无效或已过期修正参数/权限后重试
1007MESSAGE_TOO_LARGE消息体过大（上限 5KB）修正参数/权限后重试
1009GROUP_MUTED你已被禁言修正参数/权限后重试
1010SENSITIVE_WORD内容包含敏感词修正参数/权限后重试
3001SDK_NOT_CONNECTED长连接未就绪可重试（退避）
3002SDK_TIMEOUT请求超时可重试（退避）
3003SDK_NETWORK_ERROR网络错误可重试（退避）

排查建议​

  • 先确认 client.getConnectionStatus() 为 connected，再调用业务 op。
  • 按错误码区分：1001/1007 修正参数；1002/1003 重新登录；3001/3002 退避重试。
  • 本地数据异常时先查看本地库路径与迁移日志，再清缓存复现。

相关页面​