Native (C ABI) IMLib

Native 端以 Rust 实现 + C ABI 头文件交付：opaque 句柄 + 返回 int 错误码 + out 参数；字符串统一 UTF-8、NUL 结尾。IMKit 以 view-model / 格式化 / 角标 / 状态计算层交付，UI 由宿主原生框架渲染。

平台状态

契约 IDL v1.0.0（frozen，冻结修订 35）；本平台绑定状态：ga。已按冻结 IDL 交付。

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

环境与制品​

项值
语言 / 运行时Rust core + C ABI
包 / 模块名im-sdk (crate) + libim_sdk
IMLib 制品im-sdk
IMKit 制品im-kit + include/im_kit.h
类型 / 契约声明—
Demo / 示例—
绑定状态ga

API 风格​

项内容
客户端类IMClient
工厂 / 初始化init(options)
命名规则im_<domain>_<action>
异步风格C ABI 约定：im_client_* 返回 int（0 成功，非 0 为 IDL 错误码）；char** out_json 由库分配、调用方用 im_string_free 释放；char* out + size_t cap 为调用方缓冲区（0 成功 / -1 参数非法 / -2 缓冲区不足）。
事件 APIaddEventListener(event, handler) / removeEventListener(event, handler)
事件对象Events

ABI 形态：opaque handle + 返回 int 错误码 + out 参数；句柄：im_client_t*；命名：im_<domain>_<action>。

常量​

该绑定以 ABI 常量 / 字符串事件名为主，未单独声明常量枚举；事件名来自 capabilityModel.events。

能力总览​

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

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

快速链接​

相关文档​