V2TIMMessageListGetOption

Public Member Functions
void	setGetType (int getType)
void	setUserID (String userID)
void	setGroupID (String groupID)
void	setCount (int count)
void	setLastMsg (V2TIMMessage lastMsg)
void	setLastMsgSeq (long lastMsgSeq)
void	setGetTimeBegin (long getTimeBegin)
void	setGetTimePeriod (long getTimePeriod)
int	getGetType ()
String	getUserID ()
String	getGroupID ()
int	getCount ()
V2TIMMessage	getLastMsg ()
long	getLastMsgSeq ()
long	getGetTimeBegin ()
long	getGetTimePeriod ()
void	setMessageTypeList (List< Integer > messageTypeList)
List< Integer >	getMessageTypeList ()
void	setMessageSeqList (List< Long > messageSeqList)
List< Long >	getMessageSeqList ()

Static Public Attributes
static final int	V2TIM_GET_CLOUD_OLDER_MSG = 1
static final int	V2TIM_GET_CLOUD_NEWER_MSG = 2
static final int	V2TIM_GET_LOCAL_OLDER_MSG = 3
static final int	V2TIM_GET_LOCAL_NEWER_MSG = 4

Member Function Documentation

setGetType()

void setGetType ( int  getType )

inline

Message pulling type (whether to pull older or newer messages from the cloud or local storage)

Attention

If messages are pulled from the cloud, they will be merged with locally stored messages before being returned. If network connection is not available, only locally stored messages will be returned.

About getType, the starting message, and the time range for message pulling:

• getType indicates the pulling direction: whether to pull older or newer messages.
• lastMsg and lastMsgSeq indicate the start point for message pulling. For first time pulling, they can be left empty or set to 0.
• getTimeBegin and getTimePeriod indicate the time range for message pulling. Together with getType, it determines the start and end time for message pulling.
• If both the starting message and time range are specified, the result returned will be the intersection of messages pulled if only the starting message is specified and the messages pulled if only the time range is specified.
• If neither the starting message nor time range is specified, the system will pull either older or newer messages (determined by getType) starting from the latest message of the current conversation.

Parameters

getType

Pulling type. Valid values: V2TIM_GET_CLOUD_OLDER_MSG, V2TIM_GET_CLOUD_NEWER_MSG, V2TIM_GET_LOCAL_OLDER_MSG, V2TIM_GET_LOCAL_NEWER_MSG

setUserID()

void setUserID ( String  userID )

inline

Pull the message history of a one-to-one chat

setGroupID()

void setGroupID ( String  groupID )

inline

Pull the message history of a group chat

setCount()

void setCount ( int  count )

inline

Number of messages to be pulled

setLastMsg()

void setLastMsg ( V2TIMMessage  lastMsg )

inline

Start message for message pulling

Attention

When one-to-one messages are pulled, only lastMsg can be used to specify the start point for message pulling. If lastMsg is not specified, the Chat SDK will pull starting from the newest message of the conversation.

When group messages are pulled, lastMsg or lastMsgSeq can be used to specify the start point for message pulling:

• If lastMsg is used to specify the start point for message pulling, the returned message list does not include the message specified by lastMsg.
• If lastMsgSeq is used to specify the start point for message pulling, the returned message list will include the message specified by lastMsgSeq.

Attention

When group messages are pulled:

If both lastMsg and lastMsgSeq are specified, the Chat SDK will use lastMsg to determine the start point for message pulling.

If neither lastMsg nor lastMsgSeq is specified, there are two cases for determining the start point for message pulling:

• If the time range for message pulling is specified, the Chat SDK will start pulling from the time point specified by getTimeBegin.
• If the time range is not specified, the Chat SDK will start pulling from the newest message of the conversation.

setLastMsgSeq()

void setLastMsgSeq ( long  lastMsgSeq )

inline

Start sequence for group message pulling

setGetTimeBegin()

void setGetTimeBegin ( long  getTimeBegin )

inline

Time range for message pulling

getTimeBegin: indicates the start point of the time range. The default value is 0, indicating to start pulling now. The value can also be a UTC timestamp, in seconds.

getTimePeriod: indicates the length of the time range, in seconds. The default value is 0, indicating that the time range is not limited.

Attention

The direction of the time range is determined by the getType parameter:

If getType is V2TIM_GET_CLOUD_OLDER_MSG/V2TIM_GET_LOCAL_OLDER_MSG, the time range is a time period (determined by getTimePeriod) prior to getTimeBegin.

If getType is V2TIM_GET_CLOUD_NEWER_MSG/V2TIM_GET_LOCAL_NEWER_MSG, the time range is a time period (determined by getTimePeriod) after getTimeBegin.

The value range is a closed range, including the start and end points in time. The relationship between the two is as follows:

• If older messages are pulled, the time range is [getTimeBegin-getTimePeriod, getTimeBegin].
• If newer messages are pulled, the time range is [getTimeBegin, getTimeBegin+getTimePeriod].

setGetTimePeriod()

void setGetTimePeriod ( long  getTimePeriod )

inline

Duration for message pulling

getGetType()

int getGetType ( )

inline

getUserID()

String getUserID ( )

inline

getGroupID()

String getGroupID ( )

inline

getCount()

int getCount ( )

inline

getLastMsg()

V2TIMMessage getLastMsg ( )

inline

getLastMsgSeq()

long getLastMsgSeq ( )

inline

getGetTimeBegin()

long getGetTimeBegin ( )

inline

getGetTimePeriod()

long getGetTimePeriod ( )

inline

setMessageTypeList()

void setMessageTypeList ( List< Integer >  messageTypeList )

inline

Set the type of messages to pull. This API works only if getType is V2TIM_GET_LOCAL_OLDER_MSG or V2TIM_GET_LOCAL_NEWER_MSG. If null is passed in, all message types will be pulled.

getMessageTypeList()

List<Integer> getMessageTypeList ( )

inline

setMessageSeqList()

void setMessageSeqList ( List< Long >  messageSeqList )

inline

Pull the historical messages of a group chat according to the specified sequences (supported in 7.1 and later versions)

Attention

• This API works only if group messages are pulled.
• The message sequence comes from the seq field of V2TIMMessage;
• When getType is set to pull from the cloud, the cloud messages will be merged with local messages. If there is no network connection, local messages will be returned.
• When getType is set to pull from local storage, local messages will be returned.
• When getType is set to pull older messages, the message list will be in reverse chronological order, that is, the messages will be sorted in descending order by timestamp
• When getType is set to pull newer messages, the message list will be in chronological order, that is, the messages will be sorted in ascending order by timestamp.

getMessageSeqList()

List<Long> getMessageSeqList ( )

inline

Field Documentation

V2TIM_GET_CLOUD_OLDER_MSG

final int V2TIM_GET_CLOUD_OLDER_MSG = 1

static

Get older messages from the cloud

V2TIM_GET_CLOUD_NEWER_MSG

final int V2TIM_GET_CLOUD_NEWER_MSG = 2

static

Get newer messages from the cloud

V2TIM_GET_LOCAL_OLDER_MSG

final int V2TIM_GET_LOCAL_OLDER_MSG = 3

static

Get older messages from local storage

V2TIM_GET_LOCAL_NEWER_MSG

final int V2TIM_GET_LOCAL_NEWER_MSG = 4

static

Get newer messages from local storage