insertGroupMessageToLocalStorage

Description

info

Insert a group chat message into the local storage, visible only on the current device and will not be synchronized to other devices.

Note

Related Callback:
onConversationChanged
Visible only on the current device.

iOS

Function Prototype

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

Input Parameters

Parameter Name	Parameter Type	Required	Description
message	Message	Yes	Message body
groupID	String	Yes	Receiving message groupID
senderID	String	Yes	Sending message userID

Return Result

Name	Type	Description
~	Message	Success return

Code Example

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

Android

Function Prototype

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

Input Parameters

Parameter Name	Parameter Type	Required	Description
message	OIMMessageInfo	Yes	Message body
groupID	NSString	Yes	Receiving message groupID
sendID	NSString	Yes	Sending message userID

Return Result

Name	Type	Description
onSuccess	OIMMessageInfo	Success return
onFailure	OIMFailureCallback	Failure return

Code Example

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

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

}];

Flutter

Function Prototype

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

Input Parameters

Parameter Name	Parameter Type	Required	Description
callBack	OnBase<String>	Yes	Callback interface
message	Message	Yes	Message body
groupID	String	Yes	Receiving message groupID
senderID	String	Yes	Sending message userID

Code Example

        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

Function Prototype

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

Input Parameters

Parameter Name	Parameter Type	Required	Description
message	MessageItem	Yes	Message body
groupID	string	Yes	Receiving message groupID
sendID	string	Yes	Sending message userID

Return Result

Parameter Name	Parameter Type	Description
Promise.then()	Promise<WsResponse>	Success callback
Promise.catch()	Promise<WsResponse>	Failure callback

Code Example

import { getSDK } from '@openim/wasm-client-sdk';
const IMSDK = getSDK();

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

IMSDK.insertGroupMessageToLocalStorage({
  message: {
    // MessageItem
    ...
  };
  groupID: "",
  sendID: "",
})
  .then(({ data }) => {
    // Call successful
  })
  .catch(({ errCode, errMsg }) => {
    // Call failed
  });

Browser/Electron

Function Prototype

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

Input Parameters

Parameter Name	Parameter Type	Required	Description
operationID	string	Yes	Operation ID, used to pinpoint issues, keep unique, prefer time+random
message	MessageItem	Yes	Message body
groupID	string	Yes	Receiving message groupID
sendID	string	Yes	Sending message userID

Return Result

Use the openim-uniapp-polyfill package to make the function Promise. When calling, you need to use then and catch to determine and handle success and failure callbacks.

Parameter Name	Parameter Type	Description
Promise.then()	Promise<void>	Success callback
Promise.catch()	Promise<CatchResponse>	Failure callback

Code Example

import IMSDK from 'openim-uniapp-polyfill';

IMSDK.asyncApi(
  'insertGroupMessageToLocalStorage',
  IMSDK.uuid(),
  {
    message: {
      // MessageItem
      ...
    };
    groupID: "",
    sendID: "",
  }
)
  .then((data) => {
    // Call successful
  })
  .catch(({ errCode, errMsg }) => {
    // Call failed
  });

React-Native

Function Prototype

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

Input Parameters

Parameter Name	Parameter Type	Required	Description
operationID	string	No	Operation ID, used to pinpoint issues, keep unique, prefer time+random
message	MessageItem	Yes	Message body
groupID	string	Yes	Receiving message groupID
sendID	string	Yes	Sending message userID

Return Result

Parameter Name	Parameter Type	Description
Promise.then()	Promise<void>	Success callback
Promise.catch()	Promise<OpenIMApiError>	Failure callback

Code Example

import OpenIMSDK from "@openim/rn-client-sdk";

OpenIMSDK.insertGroupMessageToLocalStorage({
  message: {
    // MessageItem
    ...
  },
  groupID: "",
  sendID: "",
})
  .then((data) => {
    // Call successful
  })
  .catch((error) => {
    // Call failed
  });

Unity

Function Prototype

public static void InsertGroupMessageToLocalStorage(OnBase<Message> cb, Message message, string groupId, string sendId)

Input Parameters

Parameter Name	Parameter Type	Required	Description
cb	OnBase<Message>	Yes	Callback interface
message	Message	Yes	Message body
groupId	string	Yes	Receiving message groupID
senderId	string	Yes	Sending message userID

Code Example

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

},  message,  groupId,  senderId);