insertGroupMessageToLocalStorage

功能介绍

说明

插入一条群聊消息到本地，仅当前设备可见，不会同步到其他端。

注意

相关回调：
onConversationChanged
仅当前设备可见。

iOS

函数原型

  Future<Message> insertGroupMessageToLocalStorage({
    String? groupID,
    String? senderID,
    Message? message,
    String? operationID,
  })

输入参数

参数名称	参数类型	是否必填	描述
message	Message	是	消息体
groupID	String	是	接收消息的 groupID
senderID	String	是	发送消息的 userID

返回结果

名称	类型	描述
~	Message	成功返回

代码示例

   await OpenIM.iMManager.messageManager.insertGroupMessageToLocalStorage(
      groupID: '',
      senderID: '',
      message: Message()
    );
    // todo

Android

函数原型

- (void)insertGroupMessageToLocalStorage:(OIMMessageInfo *)message
                                 groupID:(NSString * _Nullable)groupID
                                  sendID:(NSString * _Nullable)sendID
                               onSuccess:(nullable OIMMessageInfoCallback)onSuccess
                               onFailure:(nullable OIMFailureCallback)onFailure;

输入参数

参数名称	参数类型	是否必填	描述
message	OIMMessageInfo	是	消息体
groupID	NSString	是	接收消息的 groupID
sendID	NSString	是	发送消息的 userID

返回结果

名称	类型	描述
onSuccess	OIMMessageInfo	成功返回
onFailure	OIMFailureCallback	失败返回

代码示例

[OIMManager.manager insertGroupMessageToLocalStorage:
                                             groupID:@""
                                             sendID:@""
                                          onSuccess:^(OIMMessageInfo * _Nullable message) {

} onFailure:^(NSInteger code, NSString * _Nullable msg) {

}];

Flutter

函数原型

    public void insertGroupMessageToLocalStorage(OnBase<String> base, Message message, String groupID, String senderID)

输入参数

参数名称	参数类型	是否必填	描述
callBack	OnBase<String>	是	回调接口
message	Message	是	消息体
groupID	String	是	接收消息的 groupID
senderID	String	是	发送消息的 userID

代码示例

        OpenIMClient.getInstance().messageManager.insertGroupMessageToLocalStorage(new OnBase<AdvancedMessage>() {
            @Override
            public void onError(int code, String error) {

            }

            @Override
            public void onSuccess(AdvancedMessage data) {

            }
        },  message,  groupID,  senderID);

uni-app

函数原型

IMSDK.insertGroupMessageToLocalStorage({
  message: MessageItem;
  groupID: string;
  sendID: string;
}, operationID?: string): Promise<WsResponse>

输入参数

参数名称	参数类型	是否必填	描述
message	MessageItem	是	消息体
groupID	string	是	接收消息的 groupID
sendID	string	是	发送消息的 userID

返回结果

参数名称	参数类型	描述
Promise.then()	Promise<WsResponse>	调用成功回调
Promise.catch()	Promise<WsResponse>	调用失败回调

代码示例

import { getSDK } from 'open-im-sdk-wasm';
const IMSDK = getSDK();

// use in electron with ffi
// import { getWithRenderProcess } from '@openim/electron-client-sdk/lib/render';
// const { instance: IMSDK } = getWithRenderProcess();

// use in mini program
// import { OpenIMSDK } from 'open-im-sdk';
// const IMSDK = new OpenIMSDK();

IMSDK.insertGroupMessageToLocalStorage({
  message: {
    // MessageItem
    ...
  };
  groupID: "",
  sendID: "",
})
  .then(({ data }) => {
    // 调用成功
  })
  .catch(({ errCode, errMsg }) => {
    // 调用失败
  });

Browser/Electron/MiniProgram

函数原型

IMSDK.asyncApi('insertGroupMessageToLocalStorage', operationID: string,{
  message: MessageItem;
  groupID: string;
  sendID: string;
}): Promise<void>

输入参数

参数名称	参数类型	是否必填	描述
operationID	string	是	操作 ID，用于定位问题，保持唯一，建议用当前时间和随机数
message	MessageItem	是	消息体
groupID	string	是	接收消息的 groupID
sendID	string	是	发送消息的 userID

返回结果

通过openim-uniapp-polyfill包将函数 Promise 化，调用时需要使用then和catch判断并处理成功和失败回调。

参数名称	参数类型	描述
Promise.then()	Promise<void>	调用成功回调
Promise.catch()	Promise<CatchResponse>	调用失败回调

代码示例

import IMSDK from 'openim-uniapp-polyfill';

IMSDK.asyncApi(
  'insertGroupMessageToLocalStorage',
  IMSDK.uuid(),
  {
    message: {
      // MessageItem
      ...
    };
    groupID: "",
    sendID: "",
  }
)
  .then((data) => {
    // 调用成功
  })
  .catch(({ errCode, errMsg }) => {
    // 调用失败
  });

React-Native

函数原型

OpenIMSDKRN.insertGroupMessageToLocalStorage({
  message: MessageItem;
  groupID: string;
  sendID: string;
},operationID: string): Promise<void>

输入参数

参数名称	参数类型	是否必填	描述
operationID	string	是	操作 ID，用于定位问题，保持唯一，建议用当前时间和随机数
message	MessageItem	是	消息体
groupID	string	是	接收消息的 groupID
sendID	string	是	发送消息的 userID

返回结果

参数名称	参数类型	描述
Promise.then()	Promise<void>	调用成功回调
Promise.catch()	Promise<CatchResponse>	调用失败回调

代码示例

import OpenIMSDKRN from "open-im-sdk-rn";

OpenIMSDKRN.insertGroupMessageToLocalStorage({
  message: {
    // MessageItem
    ...
  };
  groupID: "",
  sendID: "",
}, 'operationID')
  .then((data) => {
    // 调用成功
  })
  .catch(({ errCode, errMsg }) => {
    // 调用失败
  });

Unity

函数原型

public static void InsertGroupMessageToLocalStorage(OnMsgStruct cb,MsgStruct message, string groupID, string sendID)

输入参数

参数名称	参数类型	是否必填	描述
cb	OnMsgStruct	是	回调接口
message	MsgStruct	是	消息体
groupID	string	是	接收消息的 groupID
senderID	string	是	发送消息的 userID

代码示例

IMSDK.InsertGroupMessageToLocalStorage((msg,errCode,errMsg)=>{

},  message,  groupID,  senderID);