Android 超级群频道消息用法

本页给出 Android 端发送/读取超级群频道消息的完整用法：options.channelId、Message.channelId、按频道过滤历史，以及 IMKit 的频道视图入口（io.nipaas.imkit）。路由与权限语义见 超级群频道级消息。

项内容
包 / 模块io.nipaas.imlib
IMKitio.nipaas.imkit
调用风格IMLib 回调式（callback-last）；IMKit `IMKit.routeToConversation` + `ConversationIdentifier(channelId)`
频道消息条件conversationType=10 + options.channelId（空白 = 群级消息）
消息模型Message.channelId?: string（仅频道消息出现）
版本前提

需要 SDK/服务端包含 rev23（options.channelId、Message.channelId）。

未升级时：客户端会忽略/拒绝 channelId，或服务端按旧语义处理；请先升级服务端，再升级客户端。

未升级的读取端仍可读频道消息（忽略未知字段，按群级展示），但这意味着私有频道内容不会在旧端隔离。

发送频道消息​

Kotlin
// 1) 发送频道消息：TextSendOptions/SendOptions 带 channelId（仅 SUPER_GROUP）
client.sendTextMessage(
    conversationType = ConversationType.SUPER_GROUP,
    targetId = "g_1001",
    text = "频道消息：今晚 8 点发布",
    options = TextSendOptions(channelId = "ch_news"),
    callback = object : SendMessageCallback {
        override fun onSuccess(message: Message) { /* message.channelId */ }
        override fun onError(error: IMError) { /* 1001/1003/1005/1006 */ }
    },
)

// 任意内容：sendMessage(conversationType = SUPER_GROUP, targetId, content,
//     options = SendOptions(channelId = "ch_news"), callback = ...)
// channelId 为空/空白 = 群级消息

读取历史与渲染​

Kotlin
// 2) 历史：HistoryOptions(channelId = ...) 过滤
client.getHistoryMessages(
    conversationType = ConversationType.SUPER_GROUP,
    targetId = "g_1001",
    options = HistoryOptions(limit = 20, channelId = "ch_news"),
    callback = object : ResultCallback<HistoryPage> {
        override fun onSuccess(page: HistoryPage) {
            page.messages.forEach { message ->
                if (message.channelId != null) renderChannelMessage(message)
                else renderGroupMessage(message)
            }
        }
        override fun onError(error: IMError) { /* 1003 私有频道非成员 / 1005 */ }
    },
)

IMKit 频道视图​

Kotlin
// 3) IMKit：ConversationIdentifier 带 channelId 打开频道会话
IMKit.routeToConversation(
    context,
    ConversationIdentifier(
        conversationType = ConversationType.SUPER_GROUP,
        targetId = "g_1001",
        title = "产品讨论",
        channelId = "ch_news",
    ),
)

// 自定义入口：ChatActivity 接受 ImkitIntents.EXTRA_CHANNEL_ID；ChatFragment 从 Intent 读取
// 频道列表/成员页由宿主实现（IMKit 只提供单频道会话视图）

接口与错误码​

操作入参返回错误码
sendMessageconversationType:ConversationType, targetId:string, content:Content, options:{clientMsgId?:string, channelId?:string}?Message1001 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1016 1021 3001 3002
sendTextMessageconversationType:ConversationType, targetId:string, text:string, options:{clientMsgId?:string, mentionedInfo?:MentionedInfo, quote?:Quote, channelId?:string}?Message1001 1007 1009 1010 1011 3001 3002
getHistoryMessagesconversationType:ConversationType, targetId:string, options:{limit?:uint32, beforeSeq?:uint64, channelId?:string}?{messages:Message[], hasMore:bool}1001 1003
错误码名称含义可重试
1001INVALID_PARAMETER参数错误否
1003FORBIDDEN无权限否
1005GROUP_NOT_FOUND群组不存在否
1006NOT_GROUP_MEMBER未加入群组否

限制​

  • 频道消息仍属于群会话（10 + groupId）：未读/回执/免打扰按群会话聚合，不会出现独立频道会话行。
  • 私有频道发送/读取要求频道成员（1003）；公有频道群成员发送会自动加入频道。
  • typing 未按频道收窄；客户端搜索暂未按频道裁剪（Open API 搜索已过滤）。
  • IMKit 只提供单频道会话视图，频道列表/成员管理页需宿主实现（Electron 无 IMKit）。
  • 存量 rev22 群级消息（无 channelId）永远按群级处理。

相关链接​