Android IMLib

Android 端以 Kotlin 绑定交付：IMLib 为无 UI 通信库，覆盖连接、消息、会话、用户、好友、群组、聊天室、系统通知与文件上传 9 个能力域；IMKit 在其上提供 View 体系 UI 组件。方法名与 IDL 语义 op 同名（规则 A：名字零漂移），唯一形态差异是 init 需要 Context 与 callback-last。

平台状态

契约 IDL v1.0.0（frozen，冻结修订 35）；本平台绑定状态：in-progress。实现仍在推进中，接口以冻结 IDL 为准。

事件：16 类（来自 IDL eventPayloads），详见 连接监听。

环境与制品​

项值
语言 / 运行时Kotlin (JVM/Android)
包 / 模块名io.nipaas.imlib / io.nipaas.imkit
IMLib 制品imlib
IMKit 制品imkit
类型 / 契约声明api-surface.json
Demo / 示例demo/android
绑定状态in-progress

API 风格​

项内容
客户端类IMClient
工厂 / 初始化IMClient.init(context, options)
命名规则camelCase；方法名与 IDL 语义 op 同名（规则 A：名字零漂移）；唯一例外 init 因 Android 必须携带 Context 而落在伴生对象上。形态按 Android 惯例做 callback-last，语义不变。
异步风格回调式（callback-last）：有返回数据用 ResultCallback<T>{onSuccess(T), onError(IMError)}，无返回数据用 OperationCallback{onSuccess(), onError(IMError)}；所有回调在主线程投递；可选 imlib-coroutines 适配层提供 suspend 版本（不计入 62 op）
事件 APIaddEventListener(event: IMClientEvent, handler: EventHandler) / removeEventListener(event: IMClientEvent, handler: EventHandler)；同一 handler 重复注册只生效一次
事件对象IMClientEvent

常量​

常量 / 枚举说明
IMClientEvent绑定常量集（取值以绑定实现为准）
ConnectionStatusCONNECTED=0，CONNECTING=1，DISCONNECTED=2，SUSPEND=3
ConversationTypePRIVATE=1，GROUP=2，CHATROOM=3，SYSTEM=4，SUPER_GROUP=10
NotificationLevelALL=0，MENTION=1，MUTED=2
ContentTypetext / image / file / voice / location / custom / recall / system / combine
DirectionSEND=1，RECEIVE=2
GroupTypeNORMAL=normal，SUPER=super
GroupRoleOWNER=owner，ADMIN=admin，MEMBER=member
ErrorCode绑定常量集（取值以绑定实现为准）
CONTENT_TYPE_COMBINE绑定常量集（取值以绑定实现为准）

能力总览​

能力域操作数功能页
连接与监听7建立连接、连接监听
消息26发送消息、接收消息、消息管理、已读回执、输入状态、消息进阶
会话22历史消息、会话列表、未读数、草稿、置顶与免打扰、会话标签与分组、会话删除与类型免打扰
用户10用户资料、在线状态、在线状态订阅与推送令牌
好友与黑名单11好友列表、好友请求、黑名单
群组20创建群组、群成员、群管理、超级群频道与用户组
聊天室5加入与退出、聊天室信息
系统通知1系统通知
文件上传1文件上传

共 103 个语义操作、9 个能力域、29 个功能页；方法名与签名逐项来自 sdk-bindings.json。

快速链接​

相关文档​