发送状态(MessageStatusIndicator)
发送状态:MessageStatusIndicator 是 IDL 定义的跨端 UI 组件,props / events / behaviors 在各平台语义一致。本页给出契约属性、事件、渲染行为、数据源与 Native (C ABI) 端绑定/示例。
契约属性(props)
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
status | 'sending'|'sent'|'delivered'|'read'|'failed' | 是 | 发送状态:sending / sent / delivered / read / failed |
readCount | int | 否 | 已读人数 |
totalMembers | int | 否 | 群成员总数(n/m 分母) |
事件
该组件未声明事件;交互通过属性和宿主回调完成。
渲染行为
- sending 转圈;failed 显示重发;单聊显示已读/未读;群聊显示 n/m
数据源
未在 IDL 声明 dataSource;由宿主从 IMLib 拉取(getConversationList / getHistoryMessages / MESSAGES / CONVERSATION 事件)。
依赖边界
组件不直连网络与数据库:会话/消息由宿主从 IMLib 拉取后传入,组件只做排序、角标、格式化与渲染。
平台绑定
| 项 | 值 |
|---|---|
| 公开符号 / 签名 | im_kit_message_status_text(const char* message_json, int read_count, int total_members, char* out, size_t out_len) |
| 导出列表包含 | — |
| UI 框架 | view-model / 格式化 / 角标 / 状态计算层(不访问网络,不渲染 UI) |
使用示例
C(view-model 层)
char status_text[64];
im_kit_message_status_text(message_json, read_count, total_members, status_text, sizeof(status_text));
/* 发送中 / 已发送 / 已送达 / 已读 / 发送失败 */相关文档
- 功能列表:能力矩阵
- 组件 API:全部组件 props / events
- 主题定制
- 多语言与格式化
- Native (C ABI) IMLib:数据来源