SDKsFlutter

插入本地群聊消息

使用 Flutter SDK 插入一条本地群聊消息。

仅在当前设备本地的群聊历史中插入一条虚拟或系统提示消息，不执行网络投递：

参数说明

参数	类型	是否必填	说明
`groupID`	`String`	是	目标群组 ID。
`senderID`	`String`	是	消息发送者的用户 ID（可为当前用户或虚拟系统账号）。
`message`	`Message`	是	待持久化到本地的完整消息对象。

final stored = await OpenIM.iMManager.messageManager
    .insertGroupMessageToLocalStorage(
  groupID: groupID,
  senderID: senderUserID,
  message: localMessage,
);

各参数在 SDK 底层虽标记为可空，但实际调用时必须提供有效非空值以确保本地消息路由正确。

返回结果

Future 成功返回已写入本地存储的消息对象（Message）。客户端可根据其 clientMsgID 合并至当前群聊界面的消息列表中。

该操作仅修改当前设备本地数据库，不会同步至服务端漫游，不会向其他群成员发送，也不会触发任何跨端事件通知。若需要执行真实的群消息发送，请参考发送消息；若需在单聊中插入本地消息，请参考插入本地单聊消息。

这个页面有帮助吗？