[**RongIMLib**](../README.md)

***

[RongIMLib](../globals.md) / getUltraGroupMessageListByMessageUId

# Function: getUltraGroupMessageListByMessageUId()

> **getUltraGroupMessageListByMessageUId**(`options`, `messages`): `Promise`\<[`RCResult`](../interfaces/RCResult.md)\<\{\[`messageUId`: `string`\]: [`IAReceivedMessage`](../interfaces/IAReceivedMessage.md) \| `undefined`; \}\>\>

从服务端获取特定批量消息。
* 从 SDK 版本 5.28.0 开始，该接口支持查询非超级群消息，查询不再需要传入消息发送时间。
* 从 SDK 版本 5.7.0 开始，该接口的返回数据类型由 [IReceivedMessage](../interfaces/IReceivedMessage.md) 变更为 [IAReceivedMessage](../interfaces/IAReceivedMessage.md)

## Parameters

### options

[`IConversationIdentifier`](../interfaces/IConversationIdentifier.md)

获取消息参数，包含会话类型、目标 Id、频道 Id，类型为 [IConversationOption](../type-aliases/IConversationOption.md)

### messages

`IMessageDesc`[]

消息列表，包含消息的 Uid，类型为 [IMessageDesc](../interfaces/IMessageDesc.md) 数组

## Returns

`Promise`\<[`RCResult`](../interfaces/RCResult.md)\<\{\[`messageUId`: `string`\]: [`IAReceivedMessage`](../interfaces/IAReceivedMessage.md) \| `undefined`; \}\>\>

## Description

根据消息的 Uid 从服务端获取特定批量消息

## Example

**从服务端获取特定批量消息示例：**

```ts
const options = {
 conversationType: RongIMLib.ConversationType.ULTRA_GROUP,
 targetId: 'targetId',
 channelId: 'channelId',
};

const messages = [{ messageUId: 'messageUId1' }];
const res = await RongIMLib.getUltraGroupMessageListByMessageUId(options, messages);
console.log('从服务端获取特定批量消息结果：', res);
```