findMessageList

Description

info

Find local messages by message ID.

Note

Only supports messages that have been pulled locally.

iOS

Function Prototype

  Future<SearchResult> findMessageList({
    required List<SearchParams> searchParams,
    String? operationID,
  })

Input Parameters

Parameter Name	Parameter Type	Required	Description
SearchParams.conversationID	String	Yes	Conversation ID
SearchParams.clientMsgIDList	List<String>	Yes	Message ID list

Return Result

Name	Type	Description
~	SearchResult	Success return

SearchResult

Field Name	Field Type	Description
totalCount	int	Total number of messages retrieved
findResultItems	List<SearchResultItems>	Search results returned by findXX method

Code Example

    SearchResult result = await OpenIM.iMManager.messageManager.findMessageList(
      searchParams: [
        SearchParams(
          clientMsgIDList: [],
          conversationID: '',
        )
      ],
    );
    // todo

Android

Function Prototype

- (void)findMessageList:(NSArray<OIMFindMessageListParam *> *)param
              onSuccess:(nullable OIMMessageSearchCallback)onSuccess
              onFailure:(nullable OIMFailureCallback)onFailure;

Input Parameters

Parameter Name	Parameter Type	Required	Description
OIMFindMessageListParam.conversationID	NSSting	Yes	Conversation ID, if not empty, get by conversation ID, otherwise get by userID and groupID
OIMFindMessageListParam.clientMsgIDList	NSArray <NSString *>	Yes	Starting message clientMsgID, empty string for first pull

Return Result

Name	Type	Description
onSuccess	OIMSearchResultInfo	Success return
onFailure	OIMFailureCallback	Failure return

OIMSearchResultInfo

Field Name	Field Type	Description
totalCount	NSInteger	Total number of messages retrieved
searchResultItems	NSArray< OIMSearchResultItemInfo * >	Search results

Code Example

OIMFindMessageListParam *param = [OIMFindMessageListParam new];
param.conversationID = @"";
param.clientMsgIDList = @[];

[OIMManager.manager findMessageList:@[param]
                          onSuccess:^(OIMSearchResultInfo * _Nullable result) {

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

}];

Flutter

Function Prototype

    public void findMessageList(OnBase<SearchResult> base, List<SearchParams> searchParams)

Input Parameters

Parameter Name	Parameter Type	Required	Description
callBack	OnBase<TypeKeySetResult>	Yes	Callback interface
SearchParams	List<SearchParams>	Yes

Return Result

Name	Type	Description
~	TypeKeySetResult	Success return

Code Example

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

            }

            @Override
            public void onSuccess(SearchResult data) {

            }
        },searchParams);
    // todo

uni-app

Function Prototype

SearchMessageResultItem

type FindMessageResult = {
  totalCount: number;
  findResultItems: SearchMessageResultItem[];
};
IMSDK.findMessageList({
  conversationID: string;
  clientMsgIDList: string[];
}[], operationID?: string): Promise<WsResponse<FindMessageResult>>

Input Parameters

Parameter Name	Parameter Type	Required	Description
conversationID	string	Yes	Conversation ID
clientMsgIDList	string[]	Yes	Message ID list

Return Result

Parameter Name	Parameter Type	Description
Promise.then()	Promise<WsResponse<FindMessageResult>>	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.findMessageList([
  {
    conversationID: 'conversation id',
    clientMsgIDList: ['msgid'],
  },
])
  .then(({ data }) => {
    // Call successful
  })
  .catch(({ errCode, errMsg }) => {
    // Call failed
  });

Browser/Electron

Function Prototype

SearchMessageResultItem

type FindMessageResult = {
  totalCount: number;
  findResultItems: SearchMessageResultItem[];
};
IMSDK.asyncApi('findMessageList', operationID: string, {
conversationID: string,
clientMsgIDList: string[]
}): Promise<FindMessageResult>

Input Parameters

Parameter Name	Parameter Type	Required	Description
operationID	string	Yes	Operation ID, used to pinpoint issues, keep unique, prefer time+random
conversationID	string	Yes	Conversation ID
clientMsgIDList	string[]	Yes	Message ID

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<FindMessageResult>	Success callback
Promise.catch()	Promise<CatchResponse>	Failure callback

Code Example

import IMSDK from 'openim-uniapp-polyfill';

IMSDK.asyncApi('findMessageList', IMSDK.uuid(), {
  conversationID: '',
  clientMsgIDList: ['msgid'],
})
  .then((data) => {
    // Call successful
  })
  .catch(({ errCode, errMsg }) => {
    // Call failed
  });

React-Native

Function Prototype

SearchMessageResultItem

OpenIMSDK.findMessageList({
  conversationID: string,
  clientMsgIDList: string[]
}, operationID?: string): Promise<FindMessageResult>

Input Parameters

Parameter Name	Parameter Type	Required	Description
conversationID	string	Yes	Conversation ID
clientMsgIDList	string[]	Yes	Message ID
operationID	string	No	Operation ID, used to pinpoint issues, keep unique, prefer time+random

Return Result

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

Code Example

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

OpenIMSDK.findMessageList(
  {
    conversationID: '',
    clientMsgIDList: ['msgid'],
  },
)
  .then((data) => {
    // Call successful
  })
  .catch((error) => {
    // Call failed
  });

Unity

Function Prototype

public static void FindMessageList(OnBase<FindMessageResult> cb, ConversationArgs[] findMessageOptions)

Input Parameters

Parameter Name	Parameter Type	Required	Description
cb	OnBase< FindMessageResult>	Yes	Callback interface
findMessageOptions	ConversationArgs[]	Yes

FindMessageResult

Field Name	Field Type	Description
TotalCount	int	Total number of messages retrieved
FindResultItems	List< SearchResultItem >	Search results

Code Example

IMSDK.FindMessageList((result,errCode,errMsg)=>{

},findMessageOptions);