logo
In-app Chat
On this page

Struct

2026-01-21
ZIMAppConfigZIMAudioANSParam
ZIMAudioErrorZIMAudioFrameParam
ZIMAudioMessageZIMAudioMessageLiteInfo
ZIMAudioPlayConfigZIMAudioRecordConfig
ZIMBarrageMessageZIMBlacklistQueryConfig
ZIMCacheConfigZIMCallAcceptConfig
ZIMCallCancelConfigZIMCallEndConfig
ZIMCallInfoZIMCallingInvitationSentInfo
ZIMCallingInviteConfigZIMCallInvitationAcceptedInfo
ZIMCallInvitationCancelledInfoZIMCallInvitationCreatedInfo
ZIMCallInvitationEndedInfoZIMCallInvitationQueryConfig
ZIMCallInvitationReceivedInfoZIMCallInvitationRejectedInfo
ZIMCallInvitationSentInfoZIMCallInvitationTimeoutInfo
ZIMCallInviteConfigZIMCallJoinConfig
ZIMCallJoinSentInfoZIMCallQuitConfig
ZIMCallQuitSentInfoZIMCallRejectConfig
ZIMCallUserInfoZIMCallUserStateChangeInfo
ZIMCombineMessageZIMCombineMessageLiteInfo
ZIMCommandMessageZIMConversation
ZIMConversationBaseInfoZIMConversationChangeInfo
ZIMConversationDeleteConfigZIMConversationFilterOption
ZIMConversationQueryConfigZIMConversationsAllDeletedInfo
ZIMConversationSearchConfigZIMConversationSearchInfo
ZIMConversationTotalUnreadMessageCountQueryConfigZIMCustomMessage
ZIMCustomMessageLiteInfoZIMError
ZIMErrorUserInfoZIMFileCacheClearConfig
ZIMFileCacheInfoZIMFileCacheQueryConfig
ZIMFileMessageZIMFileMessageLiteInfo
ZIMFriendAddConfigZIMFriendApplicationAcceptConfig
ZIMFriendApplicationInfoZIMFriendApplicationListQueryConfig
ZIMFriendApplicationRejectConfigZIMFriendApplicationSendConfig
ZIMFriendDeleteConfigZIMFriendInfo
ZIMFriendListQueryConfigZIMFriendRelationCheckConfig
ZIMFriendRelationInfoZIMFriendsSearchConfig
ZIMGroupZIMGroupAdvancedConfig
ZIMGroupApplicationInfoZIMGroupApplicationListQueryConfig
ZIMGroupAttributesUpdateInfoZIMGroupConversation
ZIMGroupEnterInfoZIMGroupFullInfo
ZIMGroupInfoZIMGroupInviteApplicationAcceptConfig
ZIMGroupInviteApplicationRejectConfigZIMGroupInviteApplicationSendConfig
ZIMGroupJoinApplicationAcceptConfigZIMGroupJoinApplicationRejectConfig
ZIMGroupJoinApplicationSendConfigZIMGroupMemberInfo
ZIMGroupMemberMuteConfigZIMGroupMemberMutedListQueryConfig
ZIMGroupMemberQueryConfigZIMGroupMemberSearchConfig
ZIMGroupMemberSimpleInfoZIMGroupMessageReceiptMemberQueryConfig
ZIMGroupMuteConfigZIMGroupMuteInfo
ZIMGroupOperatedInfoZIMGroupSearchConfig
ZIMGroupSearchInfoZIMGroupVerifyInfo
ZIMImageMessageZIMImageMessageLiteInfo
ZIMLogConfigZIMLoginConfig
ZIMMediaDownloadConfigZIMMediaMessage
ZIMMediaMessageLiteInfoZIMMessage
ZIMMessageDeleteConfigZIMMessageDeletedInfo
ZIMMessageEditConfigZIMMessageExportConfig
ZIMMessageImportConfigZIMMessageLiteInfo
ZIMMessageMentionedInfoZIMMessagePinStatusChangeInfo
ZIMMessageQueryConfigZIMMessageReaction
ZIMMessageReactionUserInfoZIMMessageReactionUserQueryConfig
ZIMMessageReceiptInfoZIMMessageReceivedInfo
ZIMMessageRepliedInfoZIMMessageRepliedListQueryConfig
ZIMMessageRevokeConfigZIMMessageRootRepliedCountInfo
ZIMMessageRootRepliedInfoZIMMessageSearchConfig
ZIMMessageSendConfigZIMMessageSentStatusChangeInfo
ZIMMultipleMessageZIMMultipleMessageLiteInfo
ZIMOfflinePushPrivateMessageTemplateZIMPushConfig
ZIMRevokeMessageZIMRevokeMessageLiteInfo
ZIMRoomAdvancedConfigZIMRoomAttributesBatchOperationConfig
ZIMRoomAttributesDeleteConfigZIMRoomAttributesSetConfig
ZIMRoomAttributesUpdateInfoZIMRoomFullInfo
ZIMRoomInfoZIMRoomMemberAttributesInfo
ZIMRoomMemberAttributesOperatedInfoZIMRoomMemberAttributesQueryConfig
ZIMRoomMemberAttributesSetConfigZIMRoomMemberAttributesUpdateInfo
ZIMRoomMemberInfoZIMRoomMemberQueryConfig
ZIMRoomOperatedInfoZIMSelfUserInfo
ZIMSelfUserRuleZIMSendingMessageCancelConfig
ZIMSubscribedUserStatusQueryConfigZIMTextMessage
ZIMTextMessageLiteInfoZIMTipsMessage
ZIMTipsMessageChangeInfoZIMTipsMessageGroupChangeInfo
ZIMTipsMessageGroupMemberChangeInfoZIMTipsMessagePinStatusChangeInfo
ZIMUserFullInfoZIMUserInfo
ZIMUserOfflinePushRuleZIMUsersInfoQueryConfig
ZIMUserStatusZIMUserStatusSubscribeConfig
ZIMUserStatusSubscriptionZIMVideoMessage
ZIMVideoMessageLiteInfoZIMVoIPConfig
ZPNsConfigZPNsMessage
ZPNsRegisterMessage

ZIMAppConfig

ZIM application configuration, including AppID and AppSign.

Declared in entity/ZIMAppConfig.java

Properties

appID

appID
public long appID
  • Required: Required.

appSign

appSign
public String appSign
  • Required: Required.

ZIMAudioANSParam

ANS Parameter

Details

Includes noise suppression mode.

Declared in ZIMAudioANSParam.java

Properties

mode

mode
public ZIMAudioANSMode mode

Noise Suppression Mode (ANS).

ZIMAudioError

Details

It can be used to record the error type and error information generated by the SDK, check the error code table on the ZEGO official website, and seek assistance from ZEGO technical support.

Declared in ZIMAudioError.java

Properties

code

code
public ZIMAudioErrorCode code

Error code.

message

message
public String message

It can be used to record the error type and error information generated by the SDK, check the error code table on the ZEGO official website, and seek assistance from ZEGO technical support.

ZIMAudioFrameParam

Details

Audio frame attribute parameters.

Declared in ZIMAudioFrameParam.java

Properties

sampleRate

sampleRate
public Number sampleRate

The audio sample rate.

channels

channels
public Number channels

The number of audio channels.

ZIMAudioMessage

Audio message object.

Details

Identifies the basic parameters of a message.

  • Caution: If the Type parameter of the base class is Audio during callback, you can force the base class message object to be of this type.

Declared in entity/ZIMAudioMessage.java

Properties

audioDuration

audioDuration
public long audioDuration
  • Required: Required by the sender, if not filled, the audio message will fail to be sent When sending local audio messages.

fileLocalPath

fileLocalPath
public String fileLocalPath
  • Required: If a local file is sent, this parameter must be set by the sender. Otherwise, the message fails to be sent.

fileDownloadUrl

fileDownloadUrl
public String fileDownloadUrl

Detail description: The external download url of the media message is used for the developer to transparently transmit the media file to other users by filling in this URL when the developer uploads the media file to his own server.

Required or not: If an external URL is sent, this parameter is mandatory on the sender end.

fileUID

fileUID
public String fileUID

Detail description: The unique ID of the media file.

Required or not: The sender does not need to fill in, this value is generated by the SDK.

fileName

fileName
public String fileName

Detail description: The filename of the media file.

Required or not: If you are sending an external URL, you need to fill in this value and include the file extension. If a local file is sent, the value is optional.

fileSize

fileSize
public long fileSize

Detail description: The size of the media file.

Required or not: The sender does not need to fill in, this value is generated by the SDK.

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

  • Use cases: Can be used to index other messages.
  • Caution: When the developer actively creates a message, there is no need to modify this parameter. This parameter only has a value during callback.

timestamp

timestamp
public long timestamp

Identifies the sending time of a message

  • Use cases: Used to present the sending time of a message, and can be used for message sorting.
  • Caution: This is a standard UNIX timestamp, in milliseconds.

senderUserID

senderUserID
public String senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public String conversationID

Conversation ID. Ids of the same conversation type are unique.

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public long conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

The larger the orderKey, the newer the message, and can be used for ordering messages.

localMessageID

localMessageID
public long localMessageID

SDK locally generated MessageID, developers do not need to pay attention to.

isUserInserted

isUserInserted
public boolean isUserInserted

Detail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

Business scenario: used to determine the status of the current message in the receipt message

extendedData

extendedData
public String extendedData

message extension field

  • Use cases: You can add extended fields to the message and send it to the peer
  • Required: no
  • Caution: the length is 1k, you can contact technical support for configuration
  • Available since: 2.6.0 or higher

localExtendedData

localExtendedData
public String localExtendedData

The expandable message field visible only on this end can store additional information locally, Through [updateMessageLocalExtendedData] change and currently has a length limit of 128K. If you have special requirements, please contact ZEGO technical support for configuration.

isBroadcastMessage

isBroadcastMessage
public boolean isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
private boolean isMentionAll

Whether to mention everyone. It can be presented as "@Everyone".

  • Use cases: For example, it can be used in groups or rooms.
  • Required: No.
  • Default value: false.
  • Recommended value: Set to true if you need to mention everyone.
  • Caution: This value does not add the "@Everyone" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

mentionedUserIDs

mentionedUserIDs
private ArrayList\<String> mentionedUserIDs

Whether to mention everyone. It can be presented as "@User".

  • Use cases: For example, it can be used in sending messages.
  • Required: No.
  • Caution: This value does not add the "@User" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

messageSeq

messageSeq
public long messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public int rootRepliedCount

The number of reply messages corresponding to the root message of the reply message tree.

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public String editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public long editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public boolean isGroupTargetedMessage

Identify if this message is group targeted message.

pinnedUserID

pinnedUserID
public String pinnedUserID

The last user who pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

pinnedTime

pinnedTime
public long pinnedTime

The last timestamp when pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

ZIMAudioMessageLiteInfo

Audio message lite info object.

Details

Identifies the basic parameters of a audio message.

Declared in entity/ZIMAudioMessageLiteInfo.java

Properties

audioDuration

audioDuration
public long audioDuration
  • Required: Required by the sender, if not filled, the audio message will fail to be sent When sending local audio messages.

fileLocalPath

fileLocalPath
public String fileLocalPath
  • Required: If a local file is sent, this parameter must be set by the sender. Otherwise, the message fails to be sent.

fileDownloadUrl

fileDownloadUrl
public String fileDownloadUrl

Detail description: The external download url of the media message is used for the developer to transparently transmit the media file to other users by filling in this URL when the developer uploads the media file to his own server.

Required or not: If an external URL is sent, this parameter is mandatory on the sender end.

fileName

fileName
public String fileName

Detail description: The filename of the media file.

Required or not: If you are sending an external URL, you need to fill in this value and include the file extension. If a local file is sent, the value is optional.

fileSize

fileSize
public long fileSize

Detail description: The size of the media file.

Required or not: The sender does not need to fill in, this value is generated by the SDK.

type

type
public ZIMMessageType type

Identifies the type of this message.

ZIMAudioPlayConfig

Audio Playback Configuration

Details

Playing configuration. Configuration specifies the audio file path and routing type that currently need to be played.

Declared in ZIMAudioPlayConfig.java

Properties

filePath

filePath
public String filePath

The absolute path of the file needs to be played. Currently, only full absolute paths with the suffix .mp3 or .m4a are supported. When passing in file paths in other formats, the SDK will throw an illegal file path error.

routeType

routeType
public ZIMAudioRouteType routeType

Starting audio routing type when playing.

ZIMAudioRecordConfig

Audio Recording Configuration

Details

Configure the recording file output path and maximum recording time during recording.

Declared in ZIMAudioRecordConfig.java

Properties

filePath

filePath
public String filePath

The output path of the recording file. Currently, only full absolute paths with the suffix .mp3 or .m4a are supported. When passing in file paths in other formats, the SDK will throw an illegal file path error.

maxDuration

maxDuration
public number maxDuration

The maximum recording time, the default is 60000 ms, which is 60s. The unit of this parameter is milliseconds, and the maximum value does not exceed 300000.

ZIMBarrageMessage

Barrage message class.

Details

The barrage message class does not appear in the session and does not store historical messages.

Declared in entity/ZIMBarrageMessage.java

Properties

message

message
public String message

The content of barrage message.

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

  • Use cases: Can be used to index other messages.
  • Caution: When the developer actively creates a message, there is no need to modify this parameter. This parameter only has a value during callback.

timestamp

timestamp
public long timestamp

Identifies the sending time of a message

  • Use cases: Used to present the sending time of a message, and can be used for message sorting.
  • Caution: This is a standard UNIX timestamp, in milliseconds.

senderUserID

senderUserID
public String senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public String conversationID

Conversation ID. Ids of the same conversation type are unique.

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public long conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

The larger the orderKey, the newer the message, and can be used for ordering messages.

localMessageID

localMessageID
public long localMessageID

SDK locally generated MessageID, developers do not need to pay attention to.

isUserInserted

isUserInserted
public boolean isUserInserted

Detail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

Business scenario: used to determine the status of the current message in the receipt message

extendedData

extendedData
public String extendedData

message extension field

  • Use cases: You can add extended fields to the message and send it to the peer
  • Required: no
  • Caution: the length is 1k, you can contact technical support for configuration
  • Available since: 2.6.0 or higher

localExtendedData

localExtendedData
public String localExtendedData

The expandable message field visible only on this end can store additional information locally, Through [updateMessageLocalExtendedData] change and currently has a length limit of 128K. If you have special requirements, please contact ZEGO technical support for configuration.

isBroadcastMessage

isBroadcastMessage
public boolean isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
private boolean isMentionAll

Whether to mention everyone. It can be presented as "@Everyone".

  • Use cases: For example, it can be used in groups or rooms.
  • Required: No.
  • Default value: false.
  • Recommended value: Set to true if you need to mention everyone.
  • Caution: This value does not add the "@Everyone" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

mentionedUserIDs

mentionedUserIDs
private ArrayList\<String> mentionedUserIDs

Whether to mention everyone. It can be presented as "@User".

  • Use cases: For example, it can be used in sending messages.
  • Required: No.
  • Caution: This value does not add the "@User" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

messageSeq

messageSeq
public long messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public int rootRepliedCount

The number of reply messages corresponding to the root message of the reply message tree.

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public String editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public long editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public boolean isGroupTargetedMessage

Identify if this message is group targeted message.

pinnedUserID

pinnedUserID
public String pinnedUserID

The last user who pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

pinnedTime

pinnedTime
public long pinnedTime

The last timestamp when pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

ZIMBlacklistQueryConfig

Query the blacklist configuration.

Details

Through this configuration, you can set the total number of queries and the pagination query.

Declared in entity/ZIMBlacklistQueryConfig.java

Properties

count

count
public int count

count.

  • Required: Required.

nextFlag

nextFlag
public int nextFlag

nextFlag.

  • Required: Not required, it is 0 by default for the first time, which means to start the query from the beginning.

ZIMCacheConfig

Cache configuration

Details

Configure the storage path of cache files (such as chat records).

Declared in entity/ZIMCacheConfig.java

Properties

cachePath

cachePath
public String cachePath

The storage path of the cache files. Refer to the official website document for the default path.

ZIMCallAcceptConfig

Behavior property set by accepting a call invitation.

Details

Behavior property set by accepting a call invitation.

Declared in entity/ZIMCallAcceptConfig.java

Properties

extendedData

extendedData
public String extendedData

Extended field, through which the inviter can carry information to the invitee.

  • Required: Required.

ZIMCallCancelConfig

Behavior property that cancels the call invitation setting.

Details

Behavior property that cancels the call invitation setting.

Declared in entity/ZIMCallCancelConfig.java

Properties

extendedData

extendedData
public String extendedData

Extended field, through which the inviter can carry information to the invitee.

  • Required: not required.
  • Default value: "".

pushConfig

pushConfig
public ZIMPushConfig pushConfig

详情描述: 离线推送配置。 是否必填:非必填。

ZIMCallEndConfig

End the behavior attribute of the call invitation setting.

Details

End the behavior attribute of the call invitation setting.

Declared in entity/ZIMCallAcceptConfig.java

Properties

extendedData

extendedData
public String extendedData

Extended field, through which the inviter can carry information to the invitee.

  • Required: not required.

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Offline push configuration.

  • Required: not required.

ZIMCallInfo

Call invitation information.

Details

Call invitation information.

Declared in entity/ZIMCallUserInfo.java

Properties

callID

callID
public String callID

Call invite ID.

caller

caller
public String caller

Call invitation initiator ID.

mode

mode

Call invitation mode.

state

state
public ZIMCallState state

Call invitation status.

extendedData

extendedData
public String extendedData

Create a call invitation additional information.

createTime

createTime
public number createTime

Call invites to create a timestamp.

endTime

endTime
public number endTime

Call invitation end time.

callUserList

callUserList
public ZIMCallUserInfo[] callUserList

The list of call member.

ZIMCallInvitationAcceptedInfo

Accept the call invitation message.

Details

Accept the call invitation message.

Declared in entity/ZIMCallInvitationAcceptedInfo.java

Properties

invitee

invitee
public String invitee

Invitee ID.

extendedData

extendedData
public String extendedData

Extended field, through which the inviter can carry information to the invitee.

ZIMCallInvitationCancelledInfo

Cancel the call invitation message.

Details

Cancel the call invitation message.

Declared in entity/ZIMCallInvitationCancelledInfo.java

Properties

inviter

inviter
public String inviter

The inviter ID of the call invitation.

extendedData

extendedData
public String extendedData

Extended field, through which the inviter can carry information to the invitee.

ZIMCallInvitationCreatedInfo

Information to created the call invitation.

Details

Information to created the call invitation.

Declared in entity/ZIMCallInvitationCreatedInfo.java

Properties

timeout

timeout
public int timeout

The timeout setting of the call invitation, the unit is seconds.

extendedData

extendedData
public String extendedData

Extended field, through which the inviter can carry information to the invitee.

mode

mode

mode of the call invitation.

caller

caller
public String caller

The creator of the call invitation is the same as the userID that calls callInvite.

createTime

createTime
public long createTime

The event stamp when the call invitation was created on the server, accurate to milliseconds.

callUserList

callUserList
public ArrayList<ZIMCallUserInfo> callUserList

List of members invited to the call.

ZIMCallInvitationEndedInfo

End the call operation information.

Details

End the call operation information.

Declared in ZIM.java

Properties

caller

caller
public String caller

The calling party of the current call.

operatedUserID

operatedUserID
public String operatedUserID

End the call operator.

extendedData

extendedData
public String extendedData

The pass-through field that comes with invoking the end of the call.

mode

mode

The mode of the call invitation.

endTime

endTime
public long endTime

Time stamp of the end of the call, in milliseconds. The format is UTC time stamp.

ZIMCallInvitationQueryConfig

Inquiry the setting attribute of the call invitation list

Details

Inquiry the setting attribute of the call invitation list

Declared in entity/ZIMCallAcceptConfig.java

Properties

count

count
public int count

The query number is limited to up to 100.

  • Required: required.

nextFlag

nextFlag
public long nextFlag

The flag of the query list.No padding is required for the first query. After the query, callback will return a nextFlag, which can be filled in the next query to continue the query based on the last query.

  • Required: not required.

ZIMCallInvitationReceivedInfo

Information to accept the call invitation.

Details

Information to accept the call invitation.

Declared in entity/ZIMCallInvitationReceivedInfo.java

Properties

timeout

timeout
public int timeout

The timeout setting of the call invitation, the unit is seconds.

inviter

inviter
public String inviter

Inviter ID.

extendedData

extendedData
public String extendedData

Extended field, through which the inviter can carry information to the invitee.

mode

mode

mode of the call invitation.

caller

caller
public String caller

The creator of the call invitation is the same as the userID that calls callInvite.

createTime

createTime
public long createTime

The event stamp when the call invitation was created on the server, accurate to milliseconds.

callUserList

callUserList
public ArrayList<ZIMCallUserInfo> callUserList

List of members invited to the call.

ZIMCallInvitationRejectedInfo

Reject the call invitation message.

Details

Reject the call invitation message.

Declared in entity/ZIMCallInvitationRejectedInfo.java

Properties

invitee

invitee
public String invitee

Invitee ID.

extendedData

extendedData
public String extendedData

Extended field, through which the inviter can carry information to the invitee.

ZIMCallInvitationSentInfo

Call invitation sent message.

Details

Call invitation sent message.

Declared in entity/ZIMCallInvitationSentInfo.java

Properties

timeout

timeout
public int timeout

The timeout setting of the call invitation, the unit is seconds.

errorInvitees

errorInvitees
deprecated
public ArrayList<ZIMCallUserInfo> errorInvitees

User id that has not received a call invitation.

Deprecated
This field has been discarded in 2.9.0. Use errorUserList instead.

errorUserList

errorUserList
public ArrayList<ZIMErrorUserInfo> errorUserList

User id that has not received a call invitation list.

ZIMCallInvitationTimeoutInfo

Information class about timeout notifications.

Details

Information class about timeout notifications.

Declared in entity/ZIMCallInvitationAcceptedInfo.java

Properties

mode

mode

Call invitation type.

ZIMCallInviteConfig

The behavior property of the Send Call Invitation setting.

Details

The behavior property of the Send Call Invitation setting.

Declared in entity/ZIMCallInviteConfig.java

Properties

timeout

timeout
public int timeout

The timeout setting of the call invitation, the unit is seconds. The range is [1, 600].

  • Required: not required.

Default: 90.

extendedData

extendedData
public String extendedData

Extended field, through which the inviter can carry information to the invitee.

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Offline push configuration.

  • Required: not required.

mode

mode

Call invitation mode configuration. Supported Version: 2.9.0 or later.

  • Required: required. default:GENERAL

enableNotReceivedCheck

enableNotReceivedCheck
public boolean enableNotReceivedCheck

If the pass value is true, the system checks whether the call invitation is delivered in this call and subsequent calls.

  • Use cases: After the calling party sends a call invitation, if the called party does not receive the invitation within 5 seconds (3 or 4 seconds can be configured for technical support) because the user is disconnected or not online, the user status changes to notYetReceived. You can use this state flow to indicate to the user that the user may not be online. If the called party goes online before the call times out, the status changes to received received.
  • Required: This is not required.
  • Default value: false
  • Recommended value: This property takes effect in version 2.15.0 and later, when the new version sends an invitation to a call with delivery detection turned on to the old version, which will continue to display the inviting status instead of notYetReceived.

ZIMCallJoinConfig

Add the behavior attribute of the call invitation setting.

Details

Add the behavior attribute of the call invitation setting.

Declared in entity/ZIMCallInviteConfig.java

Properties

extendedData

extendedData
public String extendedData

Extended field, through which the inviter can carry information to the invitee.

ZIMCallJoinSentInfo

Result of join the call operation.

Details

Result of join the call operation.

Declared in entity/ZIMCallJoinSentInfo.java

Properties

createTime

createTime
public long createTime

Timestamp of the time when the call invitation was created.

joinTime

joinTime
public long joinTime

Time stamp of the person join the call invitation.

extendedData

extendedData
public String extendedData

The pass-through field that comes with invoking the end of the call.

callUserList

callUserList
public ArrayList<ZIMCallUserInfo> callUserList

List of user information in the current call invitation.

ZIMCallQuitConfig

Behavior property set by quit a call invitation.

Details

Behavior property set by quit a call invitation.

Declared in entity/ZIMCallAcceptConfig.java

Properties

extendedData

extendedData
public String extendedData

Extended field, through which the inviter can carry information to the invitee.

  • Required: Required.

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Offline push configuration.

  • Required: not required.

ZIMCallQuitSentInfo

Result of quit the call operation.

Details

Result of quit the call operation.

Declared in entity/ZIMCallQuitSentInfo.java

Properties

createTime

createTime
public long createTime

Timestamp of the time when the call invitation was created.

acceptTime

acceptTime
public long acceptTime

Time stamp of the person accepting the call invitation.

quitTime

quitTime
public long quitTime

The time stamp for me to exit the call.

ZIMCallRejectConfig

This parameter is used to set the configuration item of call invitation rejection.

Details

This command is used to customize the call invitation when sending invitation rejection.

  • Use cases: You need to pass the configuration item to the interface when invoking the call rejection invitation.

Declared in entity/ZIMGroupFullInfo.java

Properties

extendedData

extendedData
public String extendedData

Additional fields for attaching custom content when sending a reject invitation.

  • Use cases: When the user needs to refuse to send some custom content to the inviter.
  • Required: Required.
  • Default value: "".

ZIMCallUserInfo

Call invitation user information.

Details

Call invitation user information.

Declared in entity/ZIMCallUserInfo.java

Properties

userID

userID
public String userID

User ID, a string with a maximum length of 32 bytes or less. It is customized by the developer. Only support numbers, English characters and '!', '#', '$', '%', '&', '(', ')', '+', '-', ':', ';', '<', '=', '.', '>', '?', '@', '[', ']', '^', '_', '{', '}', '|', '~'.

state

state
public ZIMCallUserState state

user status.

extendedData

extendedData
public String extendedData

Call the additional information in user information.

ZIMCallUserStateChangeInfo

Call member status change information.

Details

Call member status change information.

Declared in /ZIMCallUserStateChangeInfo.java

Properties

callUserList

callUserList
public ArrayList<ZIMCallUserInfo> callUserList

List of call members whose status changes.

ZIMCallingInvitationSentInfo

Information about callingInvite

Details

Information about callingInvite

Declared in entity/ZIMCallingInvitationSentInfo.java

Properties

errorUserList

errorUserList
public ArrayList<ZIMErrorUserInfo> errorUserList

Error user list.

ZIMCallingInviteConfig

Behavior property set by quit a call invitation.

Details

Behavior property set by quit a call invitation.

Declared in entity/ZIMCallingInviteConfig.java

Properties

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Offline push configuration.

  • Required: not required.

ZIMCombineMessage

Base class for combine message objects.

  • Available since: 2.14.0 and above.

Declared in entity/ZIMCombineMessage.java

Properties

title

title
public String title

The title of combine message

summary

summary
public String summary

The summary of combine message

combineID

combineID
public String combineID

Combine ID, internal user

messageList

messageList
public ArrayList<ZIMMessage> messageList

List of child messages

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

  • Use cases: Can be used to index other messages.
  • Caution: When the developer actively creates a message, there is no need to modify this parameter. This parameter only has a value during callback.

timestamp

timestamp
public long timestamp

Identifies the sending time of a message

  • Use cases: Used to present the sending time of a message, and can be used for message sorting.
  • Caution: This is a standard UNIX timestamp, in milliseconds.

senderUserID

senderUserID
public String senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public String conversationID

Conversation ID. Ids of the same conversation type are unique.

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public long conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

The larger the orderKey, the newer the message, and can be used for ordering messages.

localMessageID

localMessageID
public long localMessageID

SDK locally generated MessageID, developers do not need to pay attention to.

isUserInserted

isUserInserted
public boolean isUserInserted

Detail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

Business scenario: used to determine the status of the current message in the receipt message

extendedData

extendedData
public String extendedData

message extension field

  • Use cases: You can add extended fields to the message and send it to the peer
  • Required: no
  • Caution: the length is 1k, you can contact technical support for configuration
  • Available since: 2.6.0 or higher

localExtendedData

localExtendedData
public String localExtendedData

The expandable message field visible only on this end can store additional information locally, Through [updateMessageLocalExtendedData] change and currently has a length limit of 128K. If you have special requirements, please contact ZEGO technical support for configuration.

isBroadcastMessage

isBroadcastMessage
public boolean isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
private boolean isMentionAll

Whether to mention everyone. It can be presented as "@Everyone".

  • Use cases: For example, it can be used in groups or rooms.
  • Required: No.
  • Default value: false.
  • Recommended value: Set to true if you need to mention everyone.
  • Caution: This value does not add the "@Everyone" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

mentionedUserIDs

mentionedUserIDs
private ArrayList\<String> mentionedUserIDs

Whether to mention everyone. It can be presented as "@User".

  • Use cases: For example, it can be used in sending messages.
  • Required: No.
  • Caution: This value does not add the "@User" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

messageSeq

messageSeq
public long messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public int rootRepliedCount

The number of reply messages corresponding to the root message of the reply message tree.

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public String editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public long editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public boolean isGroupTargetedMessage

Identify if this message is group targeted message.

pinnedUserID

pinnedUserID
public String pinnedUserID

The last user who pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

pinnedTime

pinnedTime
public long pinnedTime

The last timestamp when pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

ZIMCombineMessageLiteInfo

Base class for combine message lite info objects.

Details

Detail description: Identifies a combine message.

Declared in entity/ZIMCombineMessageLiteInfo.java

Properties

title

title
public String title

The title of combine message

summary

summary
public String summary

The summary of combine message

type

type
public ZIMMessageType type

Identifies the type of this message.

ZIMCommandMessage

Custom binary message object.

Details

Identifies a binary message.

  • Caution: If the Type parameter of the base class is Custom during callback, you can force the base class message object to be of this type.

Declared in entity/ZIMCommandMessage.java

Properties

message

message
public byte[] message

The content of the custom message.

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

  • Use cases: Can be used to index other messages.
  • Caution: When the developer actively creates a message, there is no need to modify this parameter. This parameter only has a value during callback.

timestamp

timestamp
public long timestamp

Identifies the sending time of a message

  • Use cases: Used to present the sending time of a message, and can be used for message sorting.
  • Caution: This is a standard UNIX timestamp, in milliseconds.

senderUserID

senderUserID
public String senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public String conversationID

Conversation ID. Ids of the same conversation type are unique.

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public long conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

The larger the orderKey, the newer the message, and can be used for ordering messages.

localMessageID

localMessageID
public long localMessageID

SDK locally generated MessageID, developers do not need to pay attention to.

isUserInserted

isUserInserted
public boolean isUserInserted

Detail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

Business scenario: used to determine the status of the current message in the receipt message

extendedData

extendedData
public String extendedData

message extension field

  • Use cases: You can add extended fields to the message and send it to the peer
  • Required: no
  • Caution: the length is 1k, you can contact technical support for configuration
  • Available since: 2.6.0 or higher

localExtendedData

localExtendedData
public String localExtendedData

The expandable message field visible only on this end can store additional information locally, Through [updateMessageLocalExtendedData] change and currently has a length limit of 128K. If you have special requirements, please contact ZEGO technical support for configuration.

isBroadcastMessage

isBroadcastMessage
public boolean isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
private boolean isMentionAll

Whether to mention everyone. It can be presented as "@Everyone".

  • Use cases: For example, it can be used in groups or rooms.
  • Required: No.
  • Default value: false.
  • Recommended value: Set to true if you need to mention everyone.
  • Caution: This value does not add the "@Everyone" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

mentionedUserIDs

mentionedUserIDs
private ArrayList\<String> mentionedUserIDs

Whether to mention everyone. It can be presented as "@User".

  • Use cases: For example, it can be used in sending messages.
  • Required: No.
  • Caution: This value does not add the "@User" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

messageSeq

messageSeq
public long messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public int rootRepliedCount

The number of reply messages corresponding to the root message of the reply message tree.

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public String editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public long editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public boolean isGroupTargetedMessage

Identify if this message is group targeted message.

pinnedUserID

pinnedUserID
public String pinnedUserID

The last user who pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

pinnedTime

pinnedTime
public long pinnedTime

The last timestamp when pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

Methods

ZIMCommandMessage

ZIMCommandMessage
Declared in entity/ZIMCommandMessage.java

ZIMConversation

Session specific content.

Details

The specific content of the session.

Declared in entity/ZIMConversation.java

Properties

conversationID

conversationID
public String conversationID

conversationID.

conversationName

conversationName
public String conversationName

conversationName is the same as the groupName/userName value corresponding to the session.

type

type

conversation type.

unreadMessageCount

unreadMessageCount
public int unreadMessageCount

Session unread.

lastMessage

lastMessage
public ZIMMessage lastMessage

last message.

orderKey

orderKey
public long orderKey

OrderKey is used to describe the order of messages in the session. The larger orderKey is, the newer it is.

notificationStatus

notificationStatus
public ZIMConversationNotificationStatus notificationStatus

session notification status.

conversationAvatarUrl

conversationAvatarUrl
public String conversationAvatarUrl

Detail description: Conversation avatar URL. The peer to peer chat conversation avatar URL is the same as the user avatar URL, and the group chat conversation avatar URL is the same as the group avatar URL.

Use Limit: the maximum number of characters is 500 bytes. There is no limit on special characters.

isPinned

isPinned
public boolean isPinned

Whether the conversation is pinned.

mentionedInfoList

mentionedInfoList
public ArrayList<ZIMMessageMentionedInfo> mentionedInfoList

When reminded in a message or reminded to everyone in a conversation, this array will record the reminders.

  • Use cases: For example, you can display the number of reminders in the conversation list based on this array, and also display which user's reminder it is.

conversationAlias

conversationAlias
public String conversationAlias

After the friend remarks are set through [updateFriendAlias], this parameter is changed for each chat conversation. After setting a group alias by [updateGroupAlias], the corresponding group chat conversation's parameter will be modified synchronously.

  • Use cases: After update alias for friends or groups, the corresponding conversation chooses to display the alias over the conversation name when rendering the conversation page.

marks

marks
public ArrayList\<Integer> marks

Describes all the existing marks for the conversation.

  • Use cases: The business layer can group logic, etc., according to different conversations with different marks.

draft

draft
public String draft

Conversation draft, when draft set conversation will carry this parameter.

ZIMConversationBaseInfo

Conversation base content.

Details

The base content of the session.

Declared in entity/ZIMConversation.java

Properties

conversationID

conversationID
public String conversationID

conversationID.

conversationType

conversationType
public ZIMConversationType conversationType

conversation type.

ZIMConversationChangeInfo

Session change information.

Details

Contains information after session changes.

Declared in callback/ZIMConversationChangeInfo.java

Properties

event

event

session events.

conversation

conversation
public ZIMConversation conversation

Session specific information.

ZIMConversationDeleteConfig

Delete session configuration.

Details

Delete the related configuration of the session.

Declared in entity/ZIMConversationDeleteConfig.java

Properties

isAlsoDeleteServerConversation

isAlsoDeleteServerConversation
public boolean isAlsoDeleteServerConversation

Whether to delete the conversation on the server

  • Required: not required.
  • Default value: true.

ZIMConversationFilterOption

Search filters related to the conversation.

Details

Configurable filter options when querying conversation list.

Declared in entity/ZIMConversationQueryConfig

Properties

marks

marks
public ArrayList\<Integer> marks

Conversation marks. Only integers in the range [1, 20] are supported. If the list contains -1, the query result will be all marked conversation; if the list contains 0, the query result will be all unmarked conversations; if multiple markers are passed, the query result will be the union of all passed markers; if the list is empty, the query result will be all conversations.

  • Use cases: This filter can be used when needing to search for conversations that include specified conversation marks.

conversationTypes

conversationTypes
public ArrayList<ZIMConversationType> conversationTypes

Conversation types. Only support one-on-one and group conversations.

  • Use cases: When you need to search by conversation type, you can use this filter.

isOnlyUnreadConversation

isOnlyUnreadConversation
public boolean isOnlyUnreadConversation

Whether to only query conversations with unread counts. Pass true to only query conversations with unread counts. Pass false to query without considering whether conversations have unread counts.

  • Use cases: It is necessary to query conversations that have a message unread count.

ZIMConversationQueryConfig

Query the relevant configuration of the session.

Details

Configurable information when querying a session.

Declared in entity/ZIMConversationQueryConfig

Properties

nextConversation

nextConversation
public ZIMConversation nextConversation

Session that needs to be queried.

  • Required: Not required.

count

count
public int count

The number of sessions to query.

  • Required: Required.

ZIMConversationSearchConfig

Conversation search configuration.

Details

Conversation search configuration.

Declared in entity/ZIMConversationSearchConfig.java

Properties

nextFlag

nextFlag
public int nextFlag

Pagination token, fill in 0 initially, and then fill in the nextFlag returned from the callback to retrieve data for the next page.

totalConversationCount

totalConversationCount
public int totalConversationCount

The number of messages that can be retrieved in one search. It is recommended to be less than 20 to reduce performance overhead.

  • Required: Required.

conversationMessageCount

conversationMessageCount
public int conversationMessageCount

The number of local messages that can be retrieved for a single conversation in one search. It is recommended to be less than 10 to reduce performance overhead.

keywords

keywords
public ArrayList\<String> keywords

Search keywords, supports up to 5. Otherwise, an error will occur. For example, if you pass in "1" and "2", the search results will only display conversations that contain both "1" and "2" keywords in the messages.

messageTypes

messageTypes
public ArrayList<ZIMMessageType> messageTypes

Message types, can be used to specify message types. Support passing in multiple types.

subMessageTypes

subMessageTypes
public ArrayList\<Integer> subMessageTypes

The subtypes of custom messages have a value range of [0,200]. Developers can use this range to search for specific custom types.

senderUserIDs

senderUserIDs
public ArrayList\<String> senderUserIDs

Send user ID, supports up to 5. For example, if you pass in "zego2023", the search results will only display conversations where messages have been sent by the user "zego2023".

startTime

startTime
public long startTime

The starting point of the search, in milliseconds, with a default value of 0. The format is UTC timestamp.

endTime

endTime
public long endTime

The ending point of the search, which must be greater than the startTime, in milliseconds. The default value is 0 and the format is UTC timestamp.

ZIMConversationSearchInfo

Conversations search info.

Declared in entity/ZIMConversationSearchInfo.java

Properties

conversationID

conversationID
public String conversationID

The conversation ID of the local message to be search.

conversationType

conversationType
public ZIMConversationType conversationType

conversation type.

totalMessageCount

totalMessageCount
public int totalMessageCount

Total message count

messageList

messageList
public ArrayList<ZIMMessage> messageList

Search results of messages.

ZIMConversationTotalUnreadMessageCountQueryConfig

Search filters related to the conversation total unread message count.

Details

Configurable filter options when querying conversation total unread message count.

Declared in entity/ZIMConversationQueryConfig

Properties

marks

marks
public ArrayList\<Integer> marks

Conversation marks. Only integers in the range [1, 20] are supported. If the list contains -1, the query result will be all marked conversation; if the list contains 0, the query result will be all unmarked conversations; if multiple markers are passed, the query result will be the union of all passed markers; if the list is empty, the query result will be all conversations.

  • Use cases: This filter can be used when needing to search for conversations that include specified conversation marks.

conversationTypes

conversationTypes
public ArrayList<ZIMConversationType> conversationTypes

Conversation types. Only support one-on-one and group conversations.

  • Use cases: When you need to search by conversation type, you can use this filter.

ZIMConversationsAllDeletedInfo

Delete all session notification information.

Details

Delete all session notification information.

Declared in entity/ZIMConversationsAllDeletedInfo.java

Properties

count

count
public int count

Number of sessions that were deleted.

ZIMCustomMessage

Custom message object.

Details

Identifies a custom message.

  • Caution: When calling back, if the Type parameter of the base class is Custom, the base class message object can be forcibly converted to this class.
  • Available since: 2.8.0 and above.

Declared in entity/ZIMCustomMessage.java

Properties

message

message
public String message

The text content of the message.

subType

subType
public int subType

The subtype of the message, which is used by customers to customize the usage of different custom messages.

  • Required: The sender is required, otherwise the message will fail to be sent.

searchedContent

searchedContent
public String searchedContent

Search fields for custom messages. Since you cannot search for a custom message by directly searching the message field, you can concatenate the content you want to be searched in the custom message (such as the title of the poll, etc.) and put it in this parameter (the length is 64 bytes by default), so that follow-up search.

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

  • Use cases: Can be used to index other messages.
  • Caution: When the developer actively creates a message, there is no need to modify this parameter. This parameter only has a value during callback.

timestamp

timestamp
public long timestamp

Identifies the sending time of a message

  • Use cases: Used to present the sending time of a message, and can be used for message sorting.
  • Caution: This is a standard UNIX timestamp, in milliseconds.

senderUserID

senderUserID
public String senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public String conversationID

Conversation ID. Ids of the same conversation type are unique.

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public long conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

The larger the orderKey, the newer the message, and can be used for ordering messages.

localMessageID

localMessageID
public long localMessageID

SDK locally generated MessageID, developers do not need to pay attention to.

isUserInserted

isUserInserted
public boolean isUserInserted

Detail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

Business scenario: used to determine the status of the current message in the receipt message

extendedData

extendedData
public String extendedData

message extension field

  • Use cases: You can add extended fields to the message and send it to the peer
  • Required: no
  • Caution: the length is 1k, you can contact technical support for configuration
  • Available since: 2.6.0 or higher

localExtendedData

localExtendedData
public String localExtendedData

The expandable message field visible only on this end can store additional information locally, Through [updateMessageLocalExtendedData] change and currently has a length limit of 128K. If you have special requirements, please contact ZEGO technical support for configuration.

isBroadcastMessage

isBroadcastMessage
public boolean isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
private boolean isMentionAll

Whether to mention everyone. It can be presented as "@Everyone".

  • Use cases: For example, it can be used in groups or rooms.
  • Required: No.
  • Default value: false.
  • Recommended value: Set to true if you need to mention everyone.
  • Caution: This value does not add the "@Everyone" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

mentionedUserIDs

mentionedUserIDs
private ArrayList\<String> mentionedUserIDs

Whether to mention everyone. It can be presented as "@User".

  • Use cases: For example, it can be used in sending messages.
  • Required: No.
  • Caution: This value does not add the "@User" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

messageSeq

messageSeq
public long messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public int rootRepliedCount

The number of reply messages corresponding to the root message of the reply message tree.

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public String editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public long editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public boolean isGroupTargetedMessage

Identify if this message is group targeted message.

pinnedUserID

pinnedUserID
public String pinnedUserID

The last user who pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

pinnedTime

pinnedTime
public long pinnedTime

The last timestamp when pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

ZIMCustomMessageLiteInfo

Custom message lite info object.

Details

Identifies a custom message.

Declared in entity/ZIMCustomMessageLiteInfo.java

Properties

message

message
public String message

The text content of the message.

subType

subType
public int subType

The subtype of the message, which is used by customers to customize the usage of different custom messages.

  • Required: The sender is required, otherwise the message will fail to be sent.

searchedContent

searchedContent
public String searchedContent

Search fields for custom messages. Since you cannot search for a custom message by directly searching the message field, you can concatenate the content you want to be searched in the custom message (such as the title of the poll, etc.) and put it in this parameter (the length is 64 bytes by default), so that follow-up search.

type

type
public ZIMMessageType type

Identifies the type of this message.

ZIMError

Error infomation

Details

Error infomation.

Declared in entity/ZIMError.java

Properties

code

code
public ZIMErrorCode code

The storage path of the log files. Refer to the official website document for the default path.

message

message
public String message

Error infomation description.

ZIMErrorUserInfo

Error user information class.

Details

Used to show the failed user and the reason for the failure.

Declared in entity/ZIMErrorUserInfo.java

Properties

userID

userID
public String userID

User ID, a string with a maximum length of 32 bytes or less. It is customized by the developer. Only support numbers, English characters and '!', '#', '$', '%', '&', '(', ')', '+', '-', ':', ';', '<', '=', '.', '>', '?', '@', '[', ']', '^', '_', '{', '}', '|', '~'.

reason

reason
public int reason

Description Reason for the query failure.

ZIMFileCacheClearConfig

Clear cache configuration.

Details

Clear cache configuration.

Declared in entity/ZIMFileCacheClearConfig.java

Properties

endTime

endTime
public long endTime

Expiration stamp of cache cleanup.

  • Required: Not required.

ZIMFileCacheInfo

File cache information.

Details

Detailed description: File cache information.

Declared in entity/ZIMFileCacheInfo.java

Properties

totalFileSize

totalFileSize
public long totalFileSize

Total file size in bytes (B).

ZIMFileCacheQueryConfig

Query cache configuration.

Details

Query cache configuration.

Declared in entity/ZIMFileCacheQueryConfig.java

Properties

endTime

endTime
public long endTime

Example Query the expiration timestamp of the cache.

  • Required: Not required.

ZIMFileMessage

File message object.

Details

Identifies the basic parameters of a message.

  • Caution: If the Type parameter of the base class is File during callback, you can force the base class message object to be of this type.

Declared in entity/ZIMFileMessage.java

Properties

fileLocalPath

fileLocalPath
public String fileLocalPath
  • Required: If a local file is sent, this parameter must be set by the sender. Otherwise, the message fails to be sent.

fileDownloadUrl

fileDownloadUrl
public String fileDownloadUrl

Detail description: The external download url of the media message is used for the developer to transparently transmit the media file to other users by filling in this URL when the developer uploads the media file to his own server.

Required or not: If an external URL is sent, this parameter is mandatory on the sender end.

fileUID

fileUID
public String fileUID

Detail description: The unique ID of the media file.

Required or not: The sender does not need to fill in, this value is generated by the SDK.

fileName

fileName
public String fileName

Detail description: The filename of the media file.

Required or not: If you are sending an external URL, you need to fill in this value and include the file extension. If a local file is sent, the value is optional.

fileSize

fileSize
public long fileSize

Detail description: The size of the media file.

Required or not: The sender does not need to fill in, this value is generated by the SDK.

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

  • Use cases: Can be used to index other messages.
  • Caution: When the developer actively creates a message, there is no need to modify this parameter. This parameter only has a value during callback.

timestamp

timestamp
public long timestamp

Identifies the sending time of a message

  • Use cases: Used to present the sending time of a message, and can be used for message sorting.
  • Caution: This is a standard UNIX timestamp, in milliseconds.

senderUserID

senderUserID
public String senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public String conversationID

Conversation ID. Ids of the same conversation type are unique.

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public long conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

The larger the orderKey, the newer the message, and can be used for ordering messages.

localMessageID

localMessageID
public long localMessageID

SDK locally generated MessageID, developers do not need to pay attention to.

isUserInserted

isUserInserted
public boolean isUserInserted

Detail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

Business scenario: used to determine the status of the current message in the receipt message

extendedData

extendedData
public String extendedData

message extension field

  • Use cases: You can add extended fields to the message and send it to the peer
  • Required: no
  • Caution: the length is 1k, you can contact technical support for configuration
  • Available since: 2.6.0 or higher

localExtendedData

localExtendedData
public String localExtendedData

The expandable message field visible only on this end can store additional information locally, Through [updateMessageLocalExtendedData] change and currently has a length limit of 128K. If you have special requirements, please contact ZEGO technical support for configuration.

isBroadcastMessage

isBroadcastMessage
public boolean isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
private boolean isMentionAll

Whether to mention everyone. It can be presented as "@Everyone".

  • Use cases: For example, it can be used in groups or rooms.
  • Required: No.
  • Default value: false.
  • Recommended value: Set to true if you need to mention everyone.
  • Caution: This value does not add the "@Everyone" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

mentionedUserIDs

mentionedUserIDs
private ArrayList\<String> mentionedUserIDs

Whether to mention everyone. It can be presented as "@User".

  • Use cases: For example, it can be used in sending messages.
  • Required: No.
  • Caution: This value does not add the "@User" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

messageSeq

messageSeq
public long messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public int rootRepliedCount

The number of reply messages corresponding to the root message of the reply message tree.

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public String editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public long editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public boolean isGroupTargetedMessage

Identify if this message is group targeted message.

pinnedUserID

pinnedUserID
public String pinnedUserID

The last user who pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

pinnedTime

pinnedTime
public long pinnedTime

The last timestamp when pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

ZIMFileMessageLiteInfo

File message lite info object.

Details

Identifies the basic parameters of a message.

Declared in entity/ZIMFileMessageLiteInfo.java

Properties

fileLocalPath

fileLocalPath
public String fileLocalPath
  • Required: If a local file is sent, this parameter must be set by the sender. Otherwise, the message fails to be sent.

fileDownloadUrl

fileDownloadUrl
public String fileDownloadUrl

Detail description: The external download url of the media message is used for the developer to transparently transmit the media file to other users by filling in this URL when the developer uploads the media file to his own server.

Required or not: If an external URL is sent, this parameter is mandatory on the sender end.

fileName

fileName
public String fileName

Detail description: The filename of the media file.

Required or not: If you are sending an external URL, you need to fill in this value and include the file extension. If a local file is sent, the value is optional.

fileSize

fileSize
public long fileSize

Detail description: The size of the media file.

Required or not: The sender does not need to fill in, this value is generated by the SDK.

type

type
public ZIMMessageType type

Identifies the type of this message.

ZIMFriendAddConfig

The behavior property of the Add Friend setting.

Details

The behavior property of the Add Friend setting.

Declared in entity/ZIMCallInviteConfig.java

Properties

wording

wording
public String wording

Add a friend postscript.

friendAlias

friendAlias
public String friendAlias

Alias of friend.

friendAttributes

friendAttributes
public HashMap<String, String> friendAttributes

Friend attributes. Up to 5 can be set. The key of the attribute can only be selected from k0 to k4.

ZIMFriendApplicationAcceptConfig

Behavior attributes for accepting friend requests.

Details

Behavior attributes for accepting friend requests.

Declared in entity/ZIMCallInviteConfig.java

Properties

friendAlias

friendAlias
public String friendAlias

friend alias.

friendAttributes

friendAttributes
public HashMap<String, String> friendAttributes

friend attributes.

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Offline push configuration

ZIMFriendApplicationInfo

Friend application information.

Details

Detailed description: Friend application information.

Declared in entity/ZIMFriendApplicationInfo.java

Properties

applyUser

applyUser
public ZIMUserInfo applyUser

Detail description: If you are the applicant, here is the respondent information; if you are the respondent, here is the applicant information;

wording

wording
public String wording

The wording of friend application information.

createTime

createTime
public int createTime

Friend add time.

updateTime

updateTime
public int updateTime

Friend application status update time.

type

type

Friend application type.

state

state

Friend application state.

ZIMFriendApplicationListQueryConfig

Query the configuration of the friend application list.

Details

Query the configuration of the friend application list.

Declared in entity/ZIMCallInviteConfig.java

Properties

count

count
public int count

Total number of current queries.

nextFlag

nextFlag
public int nextFlag

The index of the current query anchor point.

ZIMFriendApplicationRejectConfig

Behavior attributes for rejecting friend application.

Details

Behavior attributes for rejecting friend application.

Declared in entity/ZIMCallInviteConfig.java

Properties

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Offline push configuration

ZIMFriendApplicationSendConfig

The behavior property of the Send Friend Application setting.

Details

The behavior property of the Send Friend Application setting.

Declared in entity/ZIMFriendApplicationSendConfig.java

Properties

wording

wording
public String wording

Add a friend postscript.

friendAlias

friendAlias
public String friendAlias

Alias of friend.

friendAttributes

friendAttributes
public HashMap<String, String> friendAttributes

Friend attributes. Up to 5 can be set. The key of the attribute can only be selected from k0 to k4.

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Offline push configuration.

ZIMFriendDeleteConfig

The behavior property of the Delete Friend setting.

Details

The behavior property of the Delete Friend setting.

Declared in entity/ZIMCallInviteConfig.java

Properties

type

type

Delete type.

ZIMFriendInfo

Friend information.

Details

Detailed description: Friend information.

Declared in entity/ZIMFriendInfo.java

Properties

userID

userID
public String userID

Detail description: UserID of the operator.

friendAlias

friendAlias
public String friendAlias

The alias of friend.

friendAttributes

friendAttributes
public HashMap<String, String> friendAttributes

Friend attributes. Up to 5 can be set. The key of the attribute can only be selected from k0 to k4.

createTime

createTime
public int createTime

Friend add time.

userName

userName
public String userName

User name, defined by you. For version 2.0.0 and onwards, the string has a maximum length of 256 bytes.

  • Required: Not required.
  • Privacy reminder: Please do not provide sensitive personal information, including but not limited to mobile phone numbers, ID card numbers, passport numbers, and real names.

userAvatarUrl

userAvatarUrl
public String userAvatarUrl

The user avatar, which is custom generated by the developer, is not restricted by special characters and has a maximum length of 500 bytes.

  • Required: Not required.
  • Privacy reminder: Please do not provide sensitive personal information, including but not limited to mobile phone numbers, ID card numbers, passport numbers, and real names.
  • Available since: 2.13.0 and above.

userExtendedData

userExtendedData
public String userExtendedData

Extended field information of the user.

  • Caution: This property has a value only for room users.

ZIMFriendListQueryConfig

Query the configuration of the friend list.

Details

Query the configuration of the friend list.

Declared in entity/ZIMCallInviteConfig.java

Properties

count

count
public int count

Total number of current queries.

nextFlag

nextFlag
public int nextFlag

The index of the current query anchor point.

ZIMFriendRelationCheckConfig

Check the behavior properties of friend relationships.

Details

Check the behavior properties of friend relationships.

Declared in entity/ZIMCallInviteConfig.java

Properties

type

type

Check type.

ZIMFriendRelationInfo

Friend relationship information.

Details

Detailed description: Friend relationship information.

Declared in entity/ZIMFriendRelationInfo.java

Properties

userID

userID
public String userID

user ID.

type

type

Friend relationship type.

ZIMFriendsSearchConfig

Search local friend configuration.

Details

Search local friend configuration.

Declared in entity/ZIMCallInviteConfig.java

Properties

keywords

keywords
public ArrayList\<String> keywords

Search keyword list.

isAlsoMatchFriendAlias

isAlsoMatchFriendAlias
public boolean isAlsoMatchFriendAlias

Whether to match friend aliases.

count

count
public int count

Current total number of searches.

nextFlag

nextFlag
public int nextFlag

The starting and ending index of the current search.

ZIMGroup

complete group information for group list.

Details

complete group information for group list.

Declared in entity/ZIMGroupFullInfo.java

Properties

baseInfo

baseInfo
public ZIMGroupInfo baseInfo

basic group information.

notificationStatus

notificationStatus
public ZIMGroupMessageNotificationStatus notificationStatus

group message notification status.

groupAlias

groupAlias
public String groupAlias

the group alias defined by user, which is visible only to that user.

ZIMGroupAdvancedConfig

Group advanced configuration.

Details

Group advanced configuration.

  • Required: required.

Declared in entity/ZIMGroupAdvancedConfig.java

Properties

groupAttributes

groupAttributes
public HashMap<String, String> groupAttributes

Group properties, up to 10 can be configured..

  • Required: Optional.

groupNotice

groupNotice
public String groupNotice

group notice.

  • Required: Optional.

maxMemberCount

maxMemberCount
public int maxMemberCount

The maximum number of group members.

  • Use cases: When you need to limit the number of group members.
  • Required: Optional.
  • Default value: 0.
  • Value range: [0, The default maximum number of group members for the business package].
  • Caution: Supports version 2.15 and above.

joinMode

joinMode
public ZIMGroupJoinMode joinMode

Verification mode for joining the group.

  • Required: Optional.
  • Caution: Supports version 2.15 and above.

inviteMode

inviteMode
public ZIMGroupInviteMode inviteMode

Verification mode for invite to the group.

  • Required: Optional.
  • Caution: Supports version 2.15 and above.

beInviteMode

beInviteMode
public ZIMGroupBeInviteMode beInviteMode

Verification mode for being invited to the group.

  • Required: Optional.
  • Caution: Supports version 2.15 and above.

ZIMGroupApplicationInfo

Group application information.

Declared in entity/ZIMGroupApplicationInfo.java

Properties

applyUser

applyUser
public ZIMUserInfo applyUser

Detail description: The applicant is the applicant when applying to join, the invitee when applying to invite, and the inviter when applying by invitation.

wording

wording
public String wording

The wording of group application information.

createTime

createTime
public long createTime

Group application create time.

updateTime

updateTime
public long updateTime

Group application status update time.

type

type

Group application type.

state

state

Group application state.

groupInfo

groupInfo
public ZIMGroupInfo groupInfo

Group information for applying to join the group.

operatedUser

operatedUser
public ZIMGroupMemberSimpleInfo operatedUser

The operator who agrees to join the group application.

ZIMGroupApplicationListQueryConfig

Query the group application configuration.

Details

Through this configuration, you can set the total number of queries and the pagination query.

Declared in entity/ZIMGroupApplicationListQueryConfig.java

Properties

count

count
public int count

count. It is advised to be no more than 30.

  • Required: Yes.

nextFlag

nextFlag
public int nextFlag

nextFlag.

  • Required: Not required, it is 0 by default for the first time, which means to start the query from the beginning.

ZIMGroupAttributesUpdateInfo

Group attribute update information.

Details

Group attribute update information.

Declared in entity/ZIMGroupAttributesUpdateInfo.java

Properties

action

action

Group attribute update action.

groupAttributes

groupAttributes
public HashMap<String, String> groupAttributes

group properties.

ZIMGroupConversation

Group session object, extend from ZIMGroupConversation.

Details

Group session object, extend from ZIMGroupConversation.

Declared in ZIMGroupConversation.java

Properties

mutedExpiredTime

mutedExpiredTime
public long long mutedExpiredTime

The expiration date of the group gag.

isDisabled

isDisabled
public boolean isDisabled

Whether the group session is unavailable.

conversationID

conversationID
public String conversationID

conversationID.

conversationName

conversationName
public String conversationName

conversationName is the same as the groupName/userName value corresponding to the session.

type

type

conversation type.

unreadMessageCount

unreadMessageCount
public int unreadMessageCount

Session unread.

lastMessage

lastMessage
public ZIMMessage lastMessage

last message.

orderKey

orderKey
public long orderKey

OrderKey is used to describe the order of messages in the session. The larger orderKey is, the newer it is.

notificationStatus

notificationStatus
public ZIMConversationNotificationStatus notificationStatus

session notification status.

conversationAvatarUrl

conversationAvatarUrl
public String conversationAvatarUrl

Detail description: Conversation avatar URL. The peer to peer chat conversation avatar URL is the same as the user avatar URL, and the group chat conversation avatar URL is the same as the group avatar URL.

Use Limit: the maximum number of characters is 500 bytes. There is no limit on special characters.

isPinned

isPinned
public boolean isPinned

Whether the conversation is pinned.

mentionedInfoList

mentionedInfoList
public ArrayList<ZIMMessageMentionedInfo> mentionedInfoList

When reminded in a message or reminded to everyone in a conversation, this array will record the reminders.

  • Use cases: For example, you can display the number of reminders in the conversation list based on this array, and also display which user's reminder it is.

conversationAlias

conversationAlias
public String conversationAlias

After the friend remarks are set through [updateFriendAlias], this parameter is changed for each chat conversation. After setting a group alias by [updateGroupAlias], the corresponding group chat conversation's parameter will be modified synchronously.

  • Use cases: After update alias for friends or groups, the corresponding conversation chooses to display the alias over the conversation name when rendering the conversation page.

marks

marks
public ArrayList\<Integer> marks

Describes all the existing marks for the conversation.

  • Use cases: The business layer can group logic, etc., according to different conversations with different marks.

draft

draft
public String draft

Conversation draft, when draft set conversation will carry this parameter.

ZIMGroupEnterInfo

Information about group members when they join the group.

Declared in entity/ZIMGroupEnterInfo.java

Properties

enterType

enterType
public ZIMGroupEnterType enterType

Group entry type.

enterTime

enterTime
public long enterTime

The timestamp of the server when joining the group.

operatedUser

operatedUser
public ZIMGroupMemberSimpleInfo operatedUser

The operator who agrees to the application to join the group or the inviter who invites the application to join the group.

ZIMGroupFullInfo

complete group information.

Details

complete group information.

Declared in entity/ZIMGroupFullInfo.java

Properties

baseInfo

baseInfo
public ZIMGroupInfo baseInfo

basic group information.

groupAttributes

groupAttributes
public HashMap<String, String> groupAttributes

group properties.

groupNotice

groupNotice
public String groupNotice

Group of announcement.

notificationStatus

notificationStatus
public ZIMGroupMessageNotificationStatus notificationStatus

group message notification status.

mutedInfo

mutedInfo
public ZIMGroupMuteInfo mutedInfo

Group mute info.

createTime

createTime
public long createTime

The timestamp of the server when the group was created.

  • Caution: Supports version 2.15 and above.

maxMemberCount

maxMemberCount
public int maxMemberCount

The maximum number of group members.

  • Caution: Supports version 2.15 and above.

verifyInfo

verifyInfo
public ZIMGroupVerifyInfo verifyInfo

Verification mode for joining the group.

  • Caution: Supports version 2.15 and above.

groupAlias

groupAlias
public String groupAlias

the group alias defined by user, which is visible only to that user.

ZIMGroupInfo

group information.

Details

group information.

Declared in entity/ZIMGroupInfo.java

Properties

groupID

groupID
public String groupID

groupID.

Required or not: Mandatory, it will be automatically generated in the background.

Value: Supports only digits, English characters, and '!', '#', '$', '%', '&', '(', ')', '+', '-', ':', ';', '<', '=', '.', '>', '?', '@', '[', ']', '^', '_', '{', '}', '|', '~' and not by '#' at the beginning.

groupName

groupName
public String groupName

Group name.

  • Required: Optional.

Value: A string of up to 50 bytes.

groupAvatarUrl

groupAvatarUrl
public String groupAvatarUrl
  • Required: not required.

Use Limit: the maximum number of characters is 500 bytes. There is no limit on special characters.

ZIMGroupInviteApplicationAcceptConfig

The behavior property of the accept group invite application setting.

Declared in entity/ZIMGroupInviteApplicationAcceptConfig.java

Properties

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Offline push configuration.

ZIMGroupInviteApplicationRejectConfig

The behavior property of the reject group invite application setting.

Declared in entity/ZIMGroupInviteApplicationRejectConfig.java

Properties

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Offline push configuration.

ZIMGroupInviteApplicationSendConfig

The behavior property of the send group invite application setting.

Declared in entity/ZIMGroupInviteApplicationSendConfig.java

Properties

wording

wording
public String wording

Postscript to the application operation.

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Offline push configuration.

ZIMGroupJoinApplicationAcceptConfig

The behavior property of the accept group join application setting.

Declared in entity/ZIMGroupJoinApplicationAcceptConfig.java

Properties

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Offline push configuration.

ZIMGroupJoinApplicationRejectConfig

The behavior property of the reject group join application setting.

Declared in entity/ZIMGroupJoinApplicationRejectConfig.java

Properties

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Offline push configuration.

ZIMGroupJoinApplicationSendConfig

The behavior property of the send group join application setting.

Declared in entity/ZIMGroupJoinApplicationSendConfig.java

Properties

wording

wording
public String wording

Postscript to the application operation.

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Offline push configuration.

ZIMGroupMemberInfo

Group member information.

Details

Group member information.

Declared in entity/ZIMGroupMemberInfo.java

Properties

memberNickname

memberNickname
public String memberNickname

Group member nickname.

memberRole

memberRole
public int memberRole

group role.

memberAvatarUrl

memberAvatarUrl
deprecated
public String memberAvatarUrl

Detailed description: group member avatar URL.

User Limit: the maximum number of characters is 500 bytes. There is no limit on special characters.

Deprecated
Deprecated since version 2.13.0. To obtain the URL of a group member's avatar, please refer to userAvatarUrl.

muteExpiredTime

muteExpiredTime
public long muteExpiredTime

Group member's mute expiration time. When it's 0, it means no mute; when it's -1, it means permanent mute.

groupEnterInfo

groupEnterInfo
public ZIMGroupEnterInfo groupEnterInfo

Information about group members when they join the group.

  • Caution: Supports version 2.15 and above.

userID

userID
public String userID

User ID, a string with a maximum length of 32 bytes or less. It is customized by the developer. Only support numbers, English characters and '!', '#', '$', '%', '&', '(', ')', '+', '-', ':', ';', '<', '=', '.', '>', '?', '@', '[', ']', '^', '_', '{', '}', '|', '~'.

userName

userName
public String userName

User name, defined by you. For version 2.0.0 and onwards, the string has a maximum length of 256 bytes.

  • Required: Not required.
  • Privacy reminder: Please do not provide sensitive personal information, including but not limited to mobile phone numbers, ID card numbers, passport numbers, and real names.

userAvatarUrl

userAvatarUrl
public String userAvatarUrl

The user avatar, which is custom generated by the developer, is not restricted by special characters and has a maximum length of 500 bytes.

  • Required: Not required.
  • Privacy reminder: Please do not provide sensitive personal information, including but not limited to mobile phone numbers, ID card numbers, passport numbers, and real names.
  • Available since: 2.13.0 and above.

userExtendedData

userExtendedData
public String userExtendedData

Extended field information of the user.

  • Caution: This property has a value only for room users.

ZIMGroupMemberMuteConfig

Group members mute configuration.

Details

Group members mute configuration.

  • Required: required.

Declared in entity/ZIMGroupMemberMuteConfig.java

Properties

duration

duration
public int duration

Group members mute duration, the unit is seconds. The value is -1, which means permanent mute. If you need to implement non-permanent mute, the upper limit is 604800 (7 days). If you need to increase it, please contact ZEGO technical support.

  • Required: Required.

ZIMGroupMemberMutedListQueryConfig

Group muted member list query configuration.

Details

Group muted member list query configuration.

Declared in entity/ZIMGroupMemberMutedListQueryConfig.java

Properties

count

count
public int count

count.

  • Required: Required.

nextFlag

nextFlag
public long nextFlag

nextFlag.

  • Required: Not required, it is empty by default for the first time, which means to start the query from the beginning.

ZIMGroupMemberQueryConfig

group member query configuration.

Details

group member query configuration.

Declared in entity/ZIMGroupMemberQueryConfig.java

Properties

count

count
public int count

count. Quantity, upper limit is 100, over 100 will be treated as 100.

  • Required: Required.

nextFlag

nextFlag
public int nextFlag

nextFlag.

  • Required: Not required, it is empty by default for the first time, which means to start the query from the beginning.

ZIMGroupMemberSearchConfig

group member search configuration.

Details

group member search configuration.

Declared in entity/ZIMGroupMemberSearchConfig.java

Properties

count

count
public int count

count.

  • Required: Required.

nextFlag

nextFlag
public int nextFlag

The flag for querying, fill in 0 when calling the interface for the first time. When calling the interface again later, fill in the nextFlag returned from the callback to retrieve the remaining data.

  • Required: Not required.

keywords

keywords
public ArrayList\<String> keywords

Search keywords, up to 5 keywords are supported, otherwise an error will be reported. For example: passing in "1" and "2" will make the search results only show group members whose names contain both keywords "1" and "2".

  • Required: No
  • Caution: Up to 5 keywords can be entered, otherwise an error will be reported.

isAlsoMatchGroupMemberNickname

isAlsoMatchGroupMemberNickname
public boolean isAlsoMatchGroupMemberNickname

Whether the search scope includes group member user nickname. Default is false.

  • Required: No.
  • Default value: false

ZIMGroupMemberSimpleInfo

Group member simple information.

Declared in entity/ZIMGroupMemberSimpleInfo.java

Properties

memberNickname

memberNickname
public String memberNickname

Group member nickname.

memberRole

memberRole
public int memberRole

group role.

userID

userID
public String userID

User ID, a string with a maximum length of 32 bytes or less. It is customized by the developer. Only support numbers, English characters and '!', '#', '$', '%', '&', '(', ')', '+', '-', ':', ';', '<', '=', '.', '>', '?', '@', '[', ']', '^', '_', '{', '}', '|', '~'.

userName

userName
public String userName

User name, defined by you. For version 2.0.0 and onwards, the string has a maximum length of 256 bytes.

  • Required: Not required.
  • Privacy reminder: Please do not provide sensitive personal information, including but not limited to mobile phone numbers, ID card numbers, passport numbers, and real names.

userAvatarUrl

userAvatarUrl
public String userAvatarUrl

The user avatar, which is custom generated by the developer, is not restricted by special characters and has a maximum length of 500 bytes.

  • Required: Not required.
  • Privacy reminder: Please do not provide sensitive personal information, including but not limited to mobile phone numbers, ID card numbers, passport numbers, and real names.
  • Available since: 2.13.0 and above.

userExtendedData

userExtendedData
public String userExtendedData

Extended field information of the user.

  • Caution: This property has a value only for room users.

ZIMGroupMessageReceiptMemberQueryConfig

Details

Group message receipt read/unread member query configuration.

Declared in entity/ZIMGroupMessageReceiptMemberQueryConfig.java

Properties

count

count
public int count
  • Required: Required.

nextFlag

nextFlag
public int nextFlag

Detailed description: The next sign. Initially fill in 0, then get the next next flag from the [ZIMGroupMessageReceiptMemberListQueriedCallback] callback.

ZIMGroupMuteConfig

Group mute configuration.

Details

Group mute configuration.

  • Required: required.

Declared in entity/ZIMGroupMuteConfig.java

Properties

mode

mode
public ZIMGroupMuteMode mode

Group mute mode.

  • Default value: All.
  • Required: Required.

duration

duration
public int duration

Group mute duration, the unit is seconds. The value is -1, which means permanent mute. If you need to implement non-permanent mute, the upper limit is 604800 (7 days). If you need to increase it, please contact ZEGO technical support.

  • Required: Required.

roles

roles
public ArrayList<Integer> roles

Group role list.

  • Required: This field is only meaningful when ZIMGroupMuteMode is set to Custom.
  • Caution: When there is a 3 (ordinary user) in the list, other roles must also be present and cannot be 1, 2, or 4. If only muting ordinary users is needed, ZIMGroupMuteMode should be set to Normal.

ZIMGroupMuteInfo

Group mute information.

Details

Group mute information.

Declared in entity/ZIMGroupMuteInfo.java

Properties

mode

mode
public ZIMGroupMuteMode mode

Group mute mode.

expiredTime

expiredTime
public long expiredTime

Group mute expiration time, measured in seconds. When it's 0, there is no mute; when it's -1, it means permanent mute.

roles

roles
public ArrayList\<Integer> roles

Detail description: Role list muted in the group.

ZIMGroupOperatedInfo

The group causes the event to change the operator's information.

Details

The group causes the event to change the operator's information.

Declared in entity/ZIMGroupOperatedInfo.java

Properties

operatedUserInfo

operatedUserInfo
deprecated
public ZIMGroupMemberInfo operatedUserInfo

Group member information.

Deprecated
Deprecated since version 2.3.0, please use other properties of this class. At the same time, the attribute class cannot obtain the avatar URL information of group members.

userID

userID
public String userID

The operator's user ID.

userName

userName
public String userName

The operator's username.

memberNickname

memberNickname
public String memberNickname

The operator's group member nickname.

memberRole

memberRole
public int memberRole

The operator's group member role.

ZIMGroupSearchConfig

Group search configuration.

Details

Group search configuration.

Declared in entity/ZIMGroupSearchConfig.java

Properties

count

count
public int count

count.

  • Required: Required.

nextFlag

nextFlag
public int nextFlag

The flag used to search groups.

  • Required: The flag should be 0 when you search groups for the first time. After that, the flag should be the same as the nextFlag from the search result Callback to get the next page data.

keywords

keywords
public ArrayList\<String> keywords

Search keywords. For example: passing in "1" and "2" will make the search results only show groups whose group names contain both keywords "1" and "2".

  • Required: No
  • Caution: Up to 5 keywords can be entered, otherwise an error will be reported.

isAlsoMatchGroupMemberNickname

isAlsoMatchGroupMemberNickname
public boolean isAlsoMatchGroupMemberNickname

Whether the search scope includes group member user nicknames. Default is false.

  • Required: No.
  • Default value: false

isAlsoMatchGroupMemberUserName

isAlsoMatchGroupMemberUserName
public boolean isAlsoMatchGroupMemberUserName

Whether the search scope includes group member user names. Default is false.

  • Required: No.
  • Default value: false

ZIMGroupSearchInfo

Group search info.

Details

Group search info.

Declared in entity/ZIMGroupSearchInfo.java

Properties

groupInfo

groupInfo
public ZIMGroupInfo groupInfo

group info.

userList

userList
public ArrayList<ZIMGroupMemberInfo> userList

Group member information

ZIMGroupVerifyInfo

Verification mode for joining the group.

Declared in entity/ZIMGroupVerifyInfo.java

Properties

joinMode

joinMode
public ZIMGroupJoinMode joinMode

Verification mode for joining the group.

inviteMode

inviteMode
public ZIMGroupInviteMode inviteMode

Verification mode for invite to the group.

beInviteMode

beInviteMode
public ZIMGroupBeInviteMode beInviteMode

Verification mode for being invited to the group.

ZIMImageMessage

Image message object.

Details

Identifies the basic parameters of a message.

  • Caution: If the Type parameter of the base class is Image during callback, you can force the base class message object to be of this type.

Declared in entity/ZIMImageMessage.java

Properties

thumbnailLocalPath

thumbnailLocalPath
public String thumbnailLocalPath

Detailed description: The thumbnail local path of the image file.

Required or not: The sender does not need to fill in it. After calling [downloadMediaFile] to download, the SDK will generate this value.

thumbnailDownloadUrl

thumbnailDownloadUrl
public String thumbnailDownloadUrl

Detail description: Thumbnail external download URL of the image file. When developers upload thumbnails to their own servers, the SDK can pass through this field to other users.

Required or not: optional on the sender side, this field will only take effect when fileDownloadUrl is filled in.

largeImageLocalPath

largeImageLocalPath
public String largeImageLocalPath

Detailed description: The large image local path of the image file.

Required or not: The sender does not need to fill in it. After calling [downloadMediaFile] to download, the SDK will generate this value.

largeImageDownloadUrl

largeImageDownloadUrl
public String largeImageDownloadUrl

Detail description: large Image external download URL of the image file. When developers upload large Images to their own servers, the SDK can pass through this field to other users.

Required or not: optional on the sender side, this field will only take effect when fileDownloadUrl is filled in.

originalImageWidth

originalImageWidth
public int originalImageWidth

Original image width.

  • Use cases: When the user needs to draw the image UI, the parameter used to determine the width of the original image,the unit is pixel.

originalImageHeight

originalImageHeight
public int originalImageHeight

Original image height.

  • Use cases: When the user needs to draw the image UI, the parameter used to determine the height of the original image,the unit is pixel.

largeImageWidth

largeImageWidth
public int largeImageWidth

Large image width. When sending local images, the ZIM service will compress the shortest side of the original image to 720 pixels, with the other side being scaled proportionally. When the shortest side of the original image is less than 720 pixels, no compression is applied.

  • Use cases: When the user needs to draw the image UI, the parameter used to determine the width of the large image, the unit is pixel.

largeImageHeight

largeImageHeight
public int largeImageHeight

Large image height. When sending local images, the ZIM service will compress the shortest side of the original image to 720 pixels, with the other side being scaled proportionally. When the shortest side of the original image is less than 720 pixels, no compression is applied.

  • Use cases: When the user needs to draw the image UI, the parameter used to determine the height of the large image, the unit is pixel.

thumbnailWidth

thumbnailWidth
public int thumbnailWidth

Thumbnail width. When sending local images, the ZIM service will compress the shortest side of the original image to 198 pixels, with proportional scaling applied to the other side. If the shortest side of the original image is smaller than 198 pixels, no compression will be performed.

  • Use cases: When the user needs to draw the image UI, the parameter used to determine the width of the thumbnail, the unit is pixel.

thumbnailHeight

thumbnailHeight
public int thumbnailHeight

Thumbnail height. When sending local images, the ZIM service will compress the shortest side of the original image to 198 pixels, with proportional scaling applied to the other side. If the shortest side of the original image is smaller than 198 pixels, no compression will be performed.

  • Use cases: When the user needs to draw the image UI, the parameter used to determine the height of the thumbnail, the unit is pixel.

fileLocalPath

fileLocalPath
public String fileLocalPath
  • Required: If a local file is sent, this parameter must be set by the sender. Otherwise, the message fails to be sent.

fileDownloadUrl

fileDownloadUrl
public String fileDownloadUrl

Detail description: The external download url of the media message is used for the developer to transparently transmit the media file to other users by filling in this URL when the developer uploads the media file to his own server.

Required or not: If an external URL is sent, this parameter is mandatory on the sender end.

fileUID

fileUID
public String fileUID

Detail description: The unique ID of the media file.

Required or not: The sender does not need to fill in, this value is generated by the SDK.

fileName

fileName
public String fileName

Detail description: The filename of the media file.

Required or not: If you are sending an external URL, you need to fill in this value and include the file extension. If a local file is sent, the value is optional.

fileSize

fileSize
public long fileSize

Detail description: The size of the media file.

Required or not: The sender does not need to fill in, this value is generated by the SDK.

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

  • Use cases: Can be used to index other messages.
  • Caution: When the developer actively creates a message, there is no need to modify this parameter. This parameter only has a value during callback.

timestamp

timestamp
public long timestamp

Identifies the sending time of a message

  • Use cases: Used to present the sending time of a message, and can be used for message sorting.
  • Caution: This is a standard UNIX timestamp, in milliseconds.

senderUserID

senderUserID
public String senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public String conversationID

Conversation ID. Ids of the same conversation type are unique.

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public long conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

The larger the orderKey, the newer the message, and can be used for ordering messages.

localMessageID

localMessageID
public long localMessageID

SDK locally generated MessageID, developers do not need to pay attention to.

isUserInserted

isUserInserted
public boolean isUserInserted

Detail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

Business scenario: used to determine the status of the current message in the receipt message

extendedData

extendedData
public String extendedData

message extension field

  • Use cases: You can add extended fields to the message and send it to the peer
  • Required: no
  • Caution: the length is 1k, you can contact technical support for configuration
  • Available since: 2.6.0 or higher

localExtendedData

localExtendedData
public String localExtendedData

The expandable message field visible only on this end can store additional information locally, Through [updateMessageLocalExtendedData] change and currently has a length limit of 128K. If you have special requirements, please contact ZEGO technical support for configuration.

isBroadcastMessage

isBroadcastMessage
public boolean isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
private boolean isMentionAll

Whether to mention everyone. It can be presented as "@Everyone".

  • Use cases: For example, it can be used in groups or rooms.
  • Required: No.
  • Default value: false.
  • Recommended value: Set to true if you need to mention everyone.
  • Caution: This value does not add the "@Everyone" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

mentionedUserIDs

mentionedUserIDs
private ArrayList\<String> mentionedUserIDs

Whether to mention everyone. It can be presented as "@User".

  • Use cases: For example, it can be used in sending messages.
  • Required: No.
  • Caution: This value does not add the "@User" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

messageSeq

messageSeq
public long messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public int rootRepliedCount

The number of reply messages corresponding to the root message of the reply message tree.

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public String editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public long editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public boolean isGroupTargetedMessage

Identify if this message is group targeted message.

pinnedUserID

pinnedUserID
public String pinnedUserID

The last user who pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

pinnedTime

pinnedTime
public long pinnedTime

The last timestamp when pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

ZIMImageMessageLiteInfo

Image message lite info object.

Details

Identifies the basic parameters of a image message.

Declared in entity/ZIMImageMessageLiteInfo.java

Properties

thumbnailLocalPath

thumbnailLocalPath
public String thumbnailLocalPath

Detailed description: The thumbnail local path of the image file.

Required or not: The sender does not need to fill in it. After calling [downloadMediaFile] to download, the SDK will generate this value.

thumbnailDownloadUrl

thumbnailDownloadUrl
public String thumbnailDownloadUrl

Detail description: Thumbnail external download URL of the image file. When developers upload thumbnails to their own servers, the SDK can pass through this field to other users.

Required or not: optional on the sender side, this field will only take effect when fileDownloadUrl is filled in.

largeImageLocalPath

largeImageLocalPath
public String largeImageLocalPath

Detailed description: The large image local path of the image file.

Required or not: The sender does not need to fill in it. After calling [downloadMediaFile] to download, the SDK will generate this value.

largeImageDownloadUrl

largeImageDownloadUrl
public String largeImageDownloadUrl

Detail description: large Image external download URL of the image file. When developers upload large Images to their own servers, the SDK can pass through this field to other users.

Required or not: optional on the sender side, this field will only take effect when fileDownloadUrl is filled in.

originalImageWidth

originalImageWidth
public int originalImageWidth

Original image width.

  • Use cases: When the user needs to draw the image UI, the parameter used to determine the width of the original image,the unit is pixel.

originalImageHeight

originalImageHeight
public int originalImageHeight

Original image height.

  • Use cases: When the user needs to draw the image UI, the parameter used to determine the height of the original image,the unit is pixel.

largeImageWidth

largeImageWidth
public int largeImageWidth

Large image width. When sending local images, the ZIM service will compress the shortest side of the original image to 720 pixels, with the other side being scaled proportionally. When the shortest side of the original image is less than 720 pixels, no compression is applied.

  • Use cases: When the user needs to draw the image UI, the parameter used to determine the width of the large image, the unit is pixel.

largeImageHeight

largeImageHeight
public int largeImageHeight

Large image height. When sending local images, the ZIM service will compress the shortest side of the original image to 720 pixels, with the other side being scaled proportionally. When the shortest side of the original image is less than 720 pixels, no compression is applied.

  • Use cases: When the user needs to draw the image UI, the parameter used to determine the height of the large image, the unit is pixel.

thumbnailWidth

thumbnailWidth
public int thumbnailWidth

Thumbnail width. When sending local images, the ZIM service will compress the shortest side of the original image to 198 pixels, with proportional scaling applied to the other side. If the shortest side of the original image is smaller than 198 pixels, no compression will be performed.

  • Use cases: When the user needs to draw the image UI, the parameter used to determine the width of the thumbnail, the unit is pixel.

thumbnailHeight

thumbnailHeight
public int thumbnailHeight

Thumbnail height. When sending local images, the ZIM service will compress the shortest side of the original image to 198 pixels, with proportional scaling applied to the other side. If the shortest side of the original image is smaller than 198 pixels, no compression will be performed.

  • Use cases: When the user needs to draw the image UI, the parameter used to determine the height of the thumbnail, the unit is pixel.

fileLocalPath

fileLocalPath
public String fileLocalPath
  • Required: If a local file is sent, this parameter must be set by the sender. Otherwise, the message fails to be sent.

fileDownloadUrl

fileDownloadUrl
public String fileDownloadUrl

Detail description: The external download url of the media message is used for the developer to transparently transmit the media file to other users by filling in this URL when the developer uploads the media file to his own server.

Required or not: If an external URL is sent, this parameter is mandatory on the sender end.

fileName

fileName
public String fileName

Detail description: The filename of the media file.

Required or not: If you are sending an external URL, you need to fill in this value and include the file extension. If a local file is sent, the value is optional.

fileSize

fileSize
public long fileSize

Detail description: The size of the media file.

Required or not: The sender does not need to fill in, this value is generated by the SDK.

type

type
public ZIMMessageType type

Identifies the type of this message.

ZIMLogConfig

Log configuration

Details

Configure the storage path of log files and the maximum log file size.

Declared in entity/ZIMLogConfig.java

Properties

logPath

logPath
public String logPath

The storage path of the log files. Refer to the official website document for the default path.

logSize

logSize
public long logSize

The maximum log file size (Bytes). The default maximum size is 5MB (5 * 1024 * 1024 Bytes)

ZIMLoginConfig

Configuration of login-related parameters.

Details

Login-related parameters.

  • Use cases: Used to set different parameters during login.

Declared in entity/ZIMLoginConfig.java

Properties

userName

userName
public String userName

User name.

  • Use cases: Used in the scenario where user nickname is modified during login, leave it blank if no change is needed.
  • Required: No.

token

token
public String token

Token carried during login.

  • Use cases: Only pass this parameter in the scenario where token is used for authentication.
  • Required: No.

isOfflineLogin

isOfflineLogin
public boolean isOfflineLogin

Whether it is offline login.

  • Use cases: Set this parameter to true when performing offline login.
  • Required: No.
  • Default value: false.

customStatus

customStatus
public String customStatus

User-defined status, with a default maximum of 64 bytes and a default expiration time of 1 day. After expiration, it will be reset to an empty string. When logging in, if this field is an empty string (default is an empty string), the current user's custom status will not be modified.

ZIMMediaDownloadConfig

Configuration for downloading media files.

Declared in entity/ZIMConversationDeleteConfig.java

Properties

messageInfoIndex

messageInfoIndex
public int messageInfoIndex

Detailed description: The index of the array where a file in the download multiple message is located.

  • Required: Required when downloading a multiple message file.

ZIMMediaMessage

Base class for media message objects.

Details

Detail description: Identifies a media message.

This base class is the basis of all media messages and contains the properties required by media messages.

Declared in entity/ZIMFileMessage.java

Properties

fileLocalPath

fileLocalPath
public String fileLocalPath
  • Required: If a local file is sent, this parameter must be set by the sender. Otherwise, the message fails to be sent.

fileDownloadUrl

fileDownloadUrl
public String fileDownloadUrl

Detail description: The external download url of the media message is used for the developer to transparently transmit the media file to other users by filling in this URL when the developer uploads the media file to his own server.

Required or not: If an external URL is sent, this parameter is mandatory on the sender end.

fileUID

fileUID
public String fileUID

Detail description: The unique ID of the media file.

Required or not: The sender does not need to fill in, this value is generated by the SDK.

fileName

fileName
public String fileName

Detail description: The filename of the media file.

Required or not: If you are sending an external URL, you need to fill in this value and include the file extension. If a local file is sent, the value is optional.

fileSize

fileSize
public long fileSize

Detail description: The size of the media file.

Required or not: The sender does not need to fill in, this value is generated by the SDK.

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

  • Use cases: Can be used to index other messages.
  • Caution: When the developer actively creates a message, there is no need to modify this parameter. This parameter only has a value during callback.

timestamp

timestamp
public long timestamp

Identifies the sending time of a message

  • Use cases: Used to present the sending time of a message, and can be used for message sorting.
  • Caution: This is a standard UNIX timestamp, in milliseconds.

senderUserID

senderUserID
public String senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public String conversationID

Conversation ID. Ids of the same conversation type are unique.

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public long conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

The larger the orderKey, the newer the message, and can be used for ordering messages.

localMessageID

localMessageID
public long localMessageID

SDK locally generated MessageID, developers do not need to pay attention to.

isUserInserted

isUserInserted
public boolean isUserInserted

Detail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

Business scenario: used to determine the status of the current message in the receipt message

extendedData

extendedData
public String extendedData

message extension field

  • Use cases: You can add extended fields to the message and send it to the peer
  • Required: no
  • Caution: the length is 1k, you can contact technical support for configuration
  • Available since: 2.6.0 or higher

localExtendedData

localExtendedData
public String localExtendedData

The expandable message field visible only on this end can store additional information locally, Through [updateMessageLocalExtendedData] change and currently has a length limit of 128K. If you have special requirements, please contact ZEGO technical support for configuration.

isBroadcastMessage

isBroadcastMessage
public boolean isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
private boolean isMentionAll

Whether to mention everyone. It can be presented as "@Everyone".

  • Use cases: For example, it can be used in groups or rooms.
  • Required: No.
  • Default value: false.
  • Recommended value: Set to true if you need to mention everyone.
  • Caution: This value does not add the "@Everyone" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

mentionedUserIDs

mentionedUserIDs
private ArrayList\<String> mentionedUserIDs

Whether to mention everyone. It can be presented as "@User".

  • Use cases: For example, it can be used in sending messages.
  • Required: No.
  • Caution: This value does not add the "@User" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

messageSeq

messageSeq
public long messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public int rootRepliedCount

The number of reply messages corresponding to the root message of the reply message tree.

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public String editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public long editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public boolean isGroupTargetedMessage

Identify if this message is group targeted message.

pinnedUserID

pinnedUserID
public String pinnedUserID

The last user who pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

pinnedTime

pinnedTime
public long pinnedTime

The last timestamp when pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

ZIMMediaMessageLiteInfo

Base class for media message lite info objects.

Details

Detail description: Identifies a media message lite info.

This base class is the basis of all media messages lite info and contains the properties required by media messages lite info.

Declared in entity/ZIMMediaMessageLiteInfo.java

Properties

fileLocalPath

fileLocalPath
public String fileLocalPath
  • Required: If a local file is sent, this parameter must be set by the sender. Otherwise, the message fails to be sent.

fileDownloadUrl

fileDownloadUrl
public String fileDownloadUrl

Detail description: The external download url of the media message is used for the developer to transparently transmit the media file to other users by filling in this URL when the developer uploads the media file to his own server.

Required or not: If an external URL is sent, this parameter is mandatory on the sender end.

fileName

fileName
public String fileName

Detail description: The filename of the media file.

Required or not: If you are sending an external URL, you need to fill in this value and include the file extension. If a local file is sent, the value is optional.

fileSize

fileSize
public long fileSize

Detail description: The size of the media file.

Required or not: The sender does not need to fill in, this value is generated by the SDK.

type

type
public ZIMMessageType type

Identifies the type of this message.

ZIMMessage

Base class of message object

Details

Identifies the basic parameters of a message.

  • Caution: Some of the parameters, such as Message ID, only have values ​​during the callback. Developers do not need to assign values ​​to these parameters when they actively create this object for sending messages.

Declared in entity/ZIMMessage.java

Properties

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

  • Use cases: Can be used to index other messages.
  • Caution: When the developer actively creates a message, there is no need to modify this parameter. This parameter only has a value during callback.

timestamp

timestamp
public long timestamp

Identifies the sending time of a message

  • Use cases: Used to present the sending time of a message, and can be used for message sorting.
  • Caution: This is a standard UNIX timestamp, in milliseconds.

senderUserID

senderUserID
public String senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public String conversationID

Conversation ID. Ids of the same conversation type are unique.

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public long conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

The larger the orderKey, the newer the message, and can be used for ordering messages.

localMessageID

localMessageID
public long localMessageID

SDK locally generated MessageID, developers do not need to pay attention to.

isUserInserted

isUserInserted
public boolean isUserInserted

Detail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

Business scenario: used to determine the status of the current message in the receipt message

extendedData

extendedData
public String extendedData

message extension field

  • Use cases: You can add extended fields to the message and send it to the peer
  • Required: no
  • Caution: the length is 1k, you can contact technical support for configuration
  • Available since: 2.6.0 or higher

localExtendedData

localExtendedData
public String localExtendedData

The expandable message field visible only on this end can store additional information locally, Through [updateMessageLocalExtendedData] change and currently has a length limit of 128K. If you have special requirements, please contact ZEGO technical support for configuration.

isBroadcastMessage

isBroadcastMessage
public boolean isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
private boolean isMentionAll

Whether to mention everyone. It can be presented as "@Everyone".

  • Use cases: For example, it can be used in groups or rooms.
  • Required: No.
  • Default value: false.
  • Recommended value: Set to true if you need to mention everyone.
  • Caution: This value does not add the "@Everyone" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

mentionedUserIDs

mentionedUserIDs
private ArrayList\<String> mentionedUserIDs

Whether to mention everyone. It can be presented as "@User".

  • Use cases: For example, it can be used in sending messages.
  • Required: No.
  • Caution: This value does not add the "@User" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

messageSeq

messageSeq
public long messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public int rootRepliedCount

The number of reply messages corresponding to the root message of the reply message tree.

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public String editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public long editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public boolean isGroupTargetedMessage

Identify if this message is group targeted message.

pinnedUserID

pinnedUserID
public String pinnedUserID

The last user who pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

pinnedTime

pinnedTime
public long pinnedTime

The last timestamp when pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

ZIMMessageDeleteConfig

Details

Delete configurations related to messages.

Declared in entity/ZIMConversationDeleteConfig.java

Properties

isAlsoDeleteServerMessage

isAlsoDeleteServerMessage
public boolean isAlsoDeleteServerMessage

Whether to remove flags for server messages.

  • Required: not required.
  • Default value: false.

ZIMMessageDeletedInfo

Deleted message information.

Declared in entity/ZIMMessageDeletedInfo.java

Properties

conversationID

conversationID
public String conversationID

Conversation ID.

conversationType

conversationType
public ZIMConversationType conversationType

Conversation type.

messageList

messageList
public ArrayList<ZIMMessage> messageList

List of deleted messages.

isDeleteConversationAllMessage

isDeleteConversationAllMessage
deprecated
public boolean isDeleteConversationAllMessage

Whether to delete all current messages in the conversation.

Deprecated
This field was deprecated in version 2.14.0.

messageDeleteType

messageDeleteType
public ZIMMessageDeleteType messageDeleteType

[onMessageDeleted] Indicates the cause of being triggered.

ZIMMessageEditConfig

Details

(Empty Class) Configurations related to editing messages.

Declared in entity/ZIMMessageEditConfig.java

ZIMMessageExportConfig

Details

Export the configuration of the message. The Config is currently a reserved parameter.

Declared in entity/ZIMMessageExportConfig.java

ZIMMessageImportConfig

Details

Import the configuration of the message. The Config is currently a reserved parameter.

Declared in entity/ZIMMessageImportConfig.java

ZIMMessageLiteInfo

Base class of message lite info object.

Details

Identifies the basic parameters of a message.

Declared in entity/ZIMMessageLiteInfo.java

Properties

type

type
public ZIMMessageType type

Identifies the type of this message.

ZIMMessageMentionedInfo

message mention information.

Details

message mention information.

Declared in entity/ZIMMessageMentionedInfo.java

Properties

messageID

messageID
public long messageID

Message ID, used to match the notification information to which message it belongs to

Required or not: Developers do not need to fill in.'‘’

fromUserID

fromUserID
public String fromUserID

From which user.

  • Required: Developers do not need to fill in."

type

type

Type of notification, used to distinguish between reminding oneself and reminding everyone.

  • Required: Developers do not need to fill in.

messageSeq

messageSeq
public long messageSeq

message seq.

ZIMMessagePinStatusChangeInfo

Notification of the message pinned status changed.

Details

When a message in a conversation is successfully pinned or unpinned and a notification is raised, this structure can be used to obtain the operated message and its current pinned status.

Declared in entity/ZIMMessagePinStatusChangeInfo.java

Properties

pinStatus

pinStatus
public ZIMMessagePinStatus pinStatus

Message pinned status.

message

message
public ZIMMessage message

The root message object.

ZIMMessageQueryConfig

Example Query message configuration.

Details

Example Query the configurations of messages.

Declared in entity/ZIMConversationDeleteConfig.java

Properties

nextMessage

nextMessage
public ZIMMessage nextMessage

Query the anchor point of the message.

  • Required: This parameter is not required for the first query but is required for subsequent paging queries.

count

count
public int count

Number of query messages.

  • Required: Yes.

reverse

reverse
public Boolean reverse

Indicates whether the query is in reverse order.

  • Required: not required.
  • Default value: false.

ZIMMessageReaction

message reaction infos

Details

message reaction infos.

Declared in entity/ZIMMessageReaction.java

Properties

conversationID

conversationID
public String conversationID

conversationID.

conversationType

conversationType
public ZIMConversationType conversationType

conversation type.

messageID

messageID
public long messageID

Detail description: reaction message ID.

reactionType

reactionType
public String reactionType

Type of reaction, defined by you, with a maximum length of 32 bytes.

isSelfIncluded

isSelfIncluded
public boolean isSelfIncluded

The reaciton users if included myself.

totalCount

totalCount
public int totalCount

The reaction users number.

userList

userList
public ArrayList<ZIMMessageReactionUserInfo> userList

Reaction user info list.

ZIMMessageReactionUserInfo

reaction user information.

Details

Detail description: A class describing reaction user.

Declared in entity/ZIMMessageReactionUserInfo.java

Properties

userID

userID
public String userID

user ID

ZIMMessageReactionUserQueryConfig

Configuration for querying reaction user list

Details

When querying reaction member, you need to configure this object.

Declared in entity/ZIMQueryMemberConfig.java

Properties

nextFlag

nextFlag
public long nextFlag

The flag of the paging query. For the first query, set this field to an empty string. If the "nextFlag" field of the [ZIMMessageReactionUserListQueriedCallback] callback is not an empty string, it needs to be set here to continue the query on the next page.

  • Required: Not required.

count

count
public int count

How many members are retrieved in one query, 100 at most. Exceeding 100 will result in an error.

  • Caution: To obtain members in pages to reduce overhead, it is recommended to obtain within 20 members at a time. If the value is 0, the SDK will query 100 members by default.
  • Required: Required.

reactionType

reactionType
public String reactionType

reaction type, defined by you.

ZIMMessageReceiptInfo

receipt information.

Details

Detailed description: receipt information.

Declared in entity/ZIMMessageReceiptInfo.java

Properties

status

status

Detail description: receipt status.

messageID

messageID
public long messageID

Message ID.

Business scenario: Developers can match the loaded message list according to this ID.

Is it required: No, SDK fills in.

conversationID

conversationID
public String conversationID

Session ID.

Business scenario: Receipt information used to indicate which session this belongs to.

Is it required: No, SDK fills in.

conversationType

conversationType
public ZIMConversationType conversationType

Session type.

Business scenario: Indicates the type of the session.

Is it required: If no, the SDK is filled.

readMemberCount

readMemberCount
public int readMemberCount

Detailed description: Indicates the number of people who have read the receipt.

Business scenario: When used to query receipt information, it can display how many people have read the message.

Is it required: no.

Default: 0.

This value indicates how many people have read the message, it is only applicable to the message has been read; if the message is not sent by yourself, the value is 0.

unreadMemberCount

unreadMemberCount
public int unreadMemberCount

Detailed description: Indicates the number of unread people of the receipt.

Business scenario: When used to query receipt information, it can display how many people have unread the message.

Is it required: no.

Default: 0.

This value indicates how many people have not read the message, and it is only applicable to the message that has been read; if the message is not sent by yourself, the value is 0.

isSelfOperated

isSelfOperated
public boolean isSelfOperated

In a multi-device login scenario, after device A sets the message receipt as read, other online multi-devices use it to distinguish whether the message receipt set by itself has been read.

readTime

readTime
public long readTime

Server-side timestamp when the message receipt was read.

  • Default value: 0.
  • Caution: For the sender, this value is the timestamp when all session members read the message. For the recipient, this value is the timestamp when the message receipt was set.

ZIMMessageReceivedInfo

A structure in which the message receiving event carries relevant information.

Details

A structure in which the message receiving event carries relevant information.

  • Available since: Version 2.18.0 or later.

Declared in ZIMMessageReceivedInfo.java

Properties

isOfflineMessage

isOfflineMessage
public boolean isOfflineMessage

Whether the message is sent when the current user is offline, temporarily disconnected, or logged out,If yes is true.

ZIMMessageRepliedInfo

The reply message refers to the information of the source message.

Declared in entity/ZIMMessageRepliedInfo.java

Properties

state

state

the source message status.

sentTime

sentTime
public long sentTime

The send timestamp of the source message (in UTC).

senderUserID

senderUserID
public String senderUserID

The sender user ID of the source message.

messageSeq

messageSeq
public long messageSeq

The seq of the source message.

messageInfo

messageInfo
public ZIMMessageLiteInfo messageInfo

The source message lite info object.

messageID

messageID
public long messageID

The ID of the source message.

ZIMMessageRepliedListQueryConfig

Configuration for querying reply message list.

Declared in entity/ZIMMessageRepliedListQueryConfig.java

Properties

nextFlag

nextFlag
public long nextFlag

The flag of paginated query. When querying for the first time, set this field to 0. If the "nextFlag" field of the [queryMessageRepliedList] callback is not 0, it means that the query has not ended yet. You need to set it here to continue querying the next page.

count

count
public int count

The number of queries per query. The upper limit is 100. Exceeding 100 will result in an error.

  • Required: Required.

ZIMMessageRevokeConfig

Details

Revoke configurations related to messages.

Declared in entity/ZIMConversationDeleteConfig.java

Properties

revokeExtendedData

revokeExtendedData
public String revokeExtendedData

revoking additional messages.

  • Required: Not required.

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Configures the offline push function, If Android or iOS platform is integrated, it is strongly recommended to configure this.

  • Required: Not required.

ZIMMessageRootRepliedCountInfo

Information about the number of replies in the reply message tree.

Declared in entity/ZIMMessageRootRepliedCountInfo.java

Properties

conversationID

conversationID
public String conversationID

Conversation ID.

conversationType

conversationType
public ZIMConversationType conversationType

Conversation type.

messageID

messageID
public long messageID

root message id.

count

count
public int count

The number of replies for the reply message tree.

ZIMMessageRootRepliedInfo

Reply to the root message of the message tree.

Declared in entity/ZIMMessageRootRepliedInfo.java

Properties

state

state

Root message status.

sentTime

sentTime
public long sentTime

The send timestamp of the root message.

senderUserID

senderUserID
public String senderUserID

The sender user ID of the root message.

repliedCount

repliedCount
public int repliedCount

The number of replies for the reply message tree.

message

message
public ZIMMessage message

The root message object.

ZIMMessageSearchConfig

Message search configuration.

Details

Message search configuration.

Declared in entity/ZIMMessageSearchConfig.java

Properties

nextMessage

nextMessage
public ZIMMessage nextMessage

Paging fetch flag, which means fetching messages before or after nextMessage, with "before" or "after" determined by the order value. On the first search, nextMessage is null. On subsequent searches, nextMessage needs to pass in the last message in the message list queried last time.

count

count
public int count

count It is recommended to keep the number of items less than 20 to reduce performance overhead.

  • Required: Required.

order

order
public ZIMMessageOrder order

When the "order" is "DESCENDING" during message search, it means querying messages with sending time earlier than nextMessage. If it's the first message query (i.e. nextMessage is null), then query from the last message stored locally forward. When "order" is "ASCENDING", it means querying messages with sending time later than nextMessage. If it's the first message query (i.e. nextMessage is null), then query from the first message stored locally backward. The default is "DESCENDING".

keywords

keywords
public ArrayList\<String> keywords

Search keywords, up to 5 keywords are supported, otherwise an error will be reported. For example: passing in "1" and "2" will make the search results only show messages that contain both keywords "1" and "2".

messageTypes

messageTypes
public ArrayList<ZIMMessageType> messageTypes

Message types, can be used to specify message types. Support passing in multiple types.

subMessageTypes

subMessageTypes
public ArrayList\<Integer> subMessageTypes

The subtypes of custom messages have a value range of [0,200]. Developers can use this range to search for specific custom types.

senderUserIDs

senderUserIDs
public ArrayList\<String> senderUserIDs

The user ID of the message sender, supporting up to 5 IDs. For example, if "zego2023" is passed in, the search results will only display all the messages sent by the user "zego2023" in that conversation.

startTime

startTime
public long startTime

The starting point of the search, in milliseconds, with a default value of 0. The format is UTC timestamp.

endTime

endTime
public long endTime

The ending point of the search, which must be greater than the startTime, in milliseconds. The default value is 0 and the format is UTC timestamp.

ZIMMessageSendConfig

Details

Configurations related to sending messages.

Declared in entity/ZIMMessageSendConfig.java

Properties

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Configures the offline push function, If Android or iOS platform is integrated, it is strongly recommended to configure this.

  • Required: Not mandatory.

priority

priority
public ZIMMessagePriority priority
  • Required: Must mandatory.

hasReceipt

hasReceipt
public boolean hasReceipt
  • Required: not required.
  • Default value: false.

isNotifyMentionedUsers

isNotifyMentionedUsers
public boolean isNotifyMentionedUsers
  • Required: not required.
  • Default value: true.

isRetrySend

isRetrySend
public boolean isRetrySend

Whether to resend the failed message.

  • Required: No.

disableUnreadMessageCount

disableUnreadMessageCount
public boolean disableUnreadMessageCount
  • Required: No.
  • Default value: false.

ZIMMessageSentStatusChangeInfo

Notice of Room Message Status Change.

Details

Notice of Room Message Status Change.

Declared in entity/ZIMMessageSentStatusChangeInfo.java

Properties

message

message
public ZIMMessage message

ZIMMessage.

status

status
public ZIMMessageSentStatus status

message sent status.

reason

reason
public String reason

This field stores the reason why a message was rejected by ZEGOCLOUD In-app Chat due to interception by the server-side callback on message not sent yer. If you have enabled the ZEGOCLOUD In-app Chat content moderation service and require this field to capture failure reasons caused by failed content moderation, contact ZEGOCLOUD Technical Support for configuration.

ZIMMultipleMessage

Multiple message object.

Details

Detailed description: Identifies a multiple message.

Only supports the multiple of text, image, file, audio, video, and custom messages, and the number of array does not exceed 20.

Declared in entity/ZIMFileMessage.java

Properties

messageInfoList

messageInfoList
public ArrayList<ZIMMessageLiteInfo> messageInfoList

It can contain text, image, file, audio, video, and custom messages. The array length does not exceed 20.

  • Use cases: It can be used to send text and image multiple messages.
  • Recommended value: The total number of items does not exceed 20, the maximum number of image is 10, and the maximum number of file, audio, video and custom message is 1 each. The size and format restrictions of image, file, audio, and video are the same as those of the corresponding rich media messages.

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

  • Use cases: Can be used to index other messages.
  • Caution: When the developer actively creates a message, there is no need to modify this parameter. This parameter only has a value during callback.

timestamp

timestamp
public long timestamp

Identifies the sending time of a message

  • Use cases: Used to present the sending time of a message, and can be used for message sorting.
  • Caution: This is a standard UNIX timestamp, in milliseconds.

senderUserID

senderUserID
public String senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public String conversationID

Conversation ID. Ids of the same conversation type are unique.

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public long conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

The larger the orderKey, the newer the message, and can be used for ordering messages.

localMessageID

localMessageID
public long localMessageID

SDK locally generated MessageID, developers do not need to pay attention to.

isUserInserted

isUserInserted
public boolean isUserInserted

Detail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

Business scenario: used to determine the status of the current message in the receipt message

extendedData

extendedData
public String extendedData

message extension field

  • Use cases: You can add extended fields to the message and send it to the peer
  • Required: no
  • Caution: the length is 1k, you can contact technical support for configuration
  • Available since: 2.6.0 or higher

localExtendedData

localExtendedData
public String localExtendedData

The expandable message field visible only on this end can store additional information locally, Through [updateMessageLocalExtendedData] change and currently has a length limit of 128K. If you have special requirements, please contact ZEGO technical support for configuration.

isBroadcastMessage

isBroadcastMessage
public boolean isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
private boolean isMentionAll

Whether to mention everyone. It can be presented as "@Everyone".

  • Use cases: For example, it can be used in groups or rooms.
  • Required: No.
  • Default value: false.
  • Recommended value: Set to true if you need to mention everyone.
  • Caution: This value does not add the "@Everyone" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

mentionedUserIDs

mentionedUserIDs
private ArrayList\<String> mentionedUserIDs

Whether to mention everyone. It can be presented as "@User".

  • Use cases: For example, it can be used in sending messages.
  • Required: No.
  • Caution: This value does not add the "@User" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

messageSeq

messageSeq
public long messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public int rootRepliedCount

The number of reply messages corresponding to the root message of the reply message tree.

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public String editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public long editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public boolean isGroupTargetedMessage

Identify if this message is group targeted message.

pinnedUserID

pinnedUserID
public String pinnedUserID

The last user who pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

pinnedTime

pinnedTime
public long pinnedTime

The last timestamp when pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

ZIMMultipleMessageLiteInfo

Multiple message lite info object.

Details

Identifies the basic parameters of a multiple message.

Declared in entity/ZIMAudioMessageLiteInfo.java

Properties

messageInfoList

messageInfoList
public ArrayList<ZIMMessageLiteInfo> messageInfoList

Detail description: A list of elements that compose the message.

type

type
public ZIMMessageType type

Identifies the type of this message.

ZIMOfflinePushPrivateMessageTemplate

Offline push private message template.

Details

According to [OPUSH DMS template check ability to access instructions] (https://open.oppomobile.com/documentation/page/info?id=12391), OPPO in new message classification on the basis of the new push DMS templates, After you have configured the private message template in the OPPO console, if you need to apply the corresponding template during push notifications, you can assign a value to the privateMessageTemplate in ZIMPushConfig.

Declared in ZIM.java

Properties

templateID

templateID
public String templateID

The ID of the private message template pushed by OPPO must be carried when sending the corresponding private message template. If the category of OPPO in the resourceID is set to be classified as Content and Marketing, this field is invalid. Details please see [OPUSH DMS template check ability to access instructions] (https://open.oppomobile.com/documentation/page/info?id=12391

titleParameters

titleParameters
public String titleParameters

json string, OPPO push title template filling parameters. For example, the private message template ID title template is: Welcome to {city}\{city\} , {city}\{city\} Welcome you. The content of this parameter is :" {"city":" Beijing}".

contentParameters

contentParameters
public String contentParameters

json string, OPPO push content template filling parameter. Example: The content template corresponding to the private message template ID is: Welcome {userName}\{userName\} to {city}\{city\} . The content of this parameter is :" {"userName":" Tom ", "city":" Shenzhen City "}.

ZIMPushConfig

Description

push configuration.

Details

Details: Configuration before sending offline push.

Declared in entity/ZIMConversationDeleteConfig.java

Properties

title

title
public String title

Used to set the push title.

  • Required: Not required.

content

content
public String content

Used to set offline push content.

  • Required: Not required.

payload

payload
public String payload

This parameter is used to set the pass-through field of offline push.

  • Required: Not required.

resourcesID

resourcesID
public String resourcesID

A string defined by you, no more than 32 characters in length, used to map advanced configurations for offline push from multiple manufacturers, abstracting the push configurations of various manufacturers into a single push strategy that you define yourself. For detailed introduction and configuration steps, please refer to ResourcesID introduction.

  • Required: Not required.

enableBadge

enableBadge
public boolean enableBadge

Push whether to carry corner information switch.

badgeIncrement

badgeIncrement
public int badgeIncrement

The incremental index number carried by the push.

voIPConfig

voIPConfig
public ZIMVoIPConfig voIPConfig

If you use Flutter, RN ZPNs, offline push receiving device has iOS and uses VoIP push type, you can customize some VoIP options with this parameter.

privateMessageTemplate

privateMessageTemplate
public ZIMOfflinePushPrivateMessageTemplate privateMessageTemplate

If you use OPPO push notifications, you can apply the OPPO Private message template through this structure; otherwise, you can ignore it and it will be left blank by default.

ZIMRevokeMessage

Base class for revoke message objects.

Details

Detail description: Identifies a revoke message.

This base class is the basis of all revoke messages and contains the properties required by revoke messages.

Declared in entity/ZIMFileMessage.java

Properties

revokeType

revokeType
public ZIMRevokeType revokeType

Detail description: revoke type.

revokeStatus

revokeStatus
public ZIMMessageRevokeStatus revokeStatus

Detail description: revoke status.

revokeTimestamp

revokeTimestamp
public int revokeTimestamp

Detail description: revoke timestamp.

operatedUserID

operatedUserID
public String operatedUserID

Detail description: operated user ID.

revokeExtendedData

revokeExtendedData
public String revokeExtendedData

Detail description: revoke extended data.

originalMessageType

originalMessageType
public ZIMMessageType originalMessageType

original message type

originalTextMessageContent

originalTextMessageContent
public String originalTextMessageContent

original text message content

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

  • Use cases: Can be used to index other messages.
  • Caution: When the developer actively creates a message, there is no need to modify this parameter. This parameter only has a value during callback.

timestamp

timestamp
public long timestamp

Identifies the sending time of a message

  • Use cases: Used to present the sending time of a message, and can be used for message sorting.
  • Caution: This is a standard UNIX timestamp, in milliseconds.

senderUserID

senderUserID
public String senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public String conversationID

Conversation ID. Ids of the same conversation type are unique.

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public long conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

The larger the orderKey, the newer the message, and can be used for ordering messages.

localMessageID

localMessageID
public long localMessageID

SDK locally generated MessageID, developers do not need to pay attention to.

isUserInserted

isUserInserted
public boolean isUserInserted

Detail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

Business scenario: used to determine the status of the current message in the receipt message

extendedData

extendedData
public String extendedData

message extension field

  • Use cases: You can add extended fields to the message and send it to the peer
  • Required: no
  • Caution: the length is 1k, you can contact technical support for configuration
  • Available since: 2.6.0 or higher

localExtendedData

localExtendedData
public String localExtendedData

The expandable message field visible only on this end can store additional information locally, Through [updateMessageLocalExtendedData] change and currently has a length limit of 128K. If you have special requirements, please contact ZEGO technical support for configuration.

isBroadcastMessage

isBroadcastMessage
public boolean isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
private boolean isMentionAll

Whether to mention everyone. It can be presented as "@Everyone".

  • Use cases: For example, it can be used in groups or rooms.
  • Required: No.
  • Default value: false.
  • Recommended value: Set to true if you need to mention everyone.
  • Caution: This value does not add the "@Everyone" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

mentionedUserIDs

mentionedUserIDs
private ArrayList\<String> mentionedUserIDs

Whether to mention everyone. It can be presented as "@User".

  • Use cases: For example, it can be used in sending messages.
  • Required: No.
  • Caution: This value does not add the "@User" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

messageSeq

messageSeq
public long messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public int rootRepliedCount

The number of reply messages corresponding to the root message of the reply message tree.

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public String editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public long editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public boolean isGroupTargetedMessage

Identify if this message is group targeted message.

pinnedUserID

pinnedUserID
public String pinnedUserID

The last user who pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

pinnedTime

pinnedTime
public long pinnedTime

The last timestamp when pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

ZIMRevokeMessageLiteInfo

Base class for revoke message lite info objects.

Declared in entity/ZIMRevokeMessageLiteInfo.java

Properties

type

type
public ZIMMessageType type

Identifies the type of this message.

ZIMRoomAdvancedConfig

Room advanced config.

Details

Room‘s advanced config.

Declared in entity/ZIMRoomAdvancedConfig.java

Properties

roomAttributes

roomAttributes
public public HashMap<String, String> roomAttributes

Room attributes of a room.

roomDestroyDelayTime

roomDestroyDelayTime
public int roomDestroyDelayTime

Room destruction time delayed, the unit is seconds. The maximum room destroy delay time is 3 hours.

  • Use cases: If the number of rooms is 0, set the room time to ensure that the room exists during this period.
  • Required: Not mandatory.

ZIMRoomAttributesBatchOperationConfig

The behavior attribute set by the room attribute.

Details

The behavior attribute set by the room attribute.

Declared in entity/ZIMRoomAttributesBatchOperationConfig.java

Properties

isDeleteAfterOwnerLeft

isDeleteAfterOwnerLeft
public boolean isDeleteAfterOwnerLeft

Room attributes are automatically deleted after the owner leaves the room.

  • Required: Not required.

isForce

isForce
public boolean isForce

Whether the operation is mandatory, that is, the property of the room whose owner is another user can be modified.

  • Required: Not required.

isUpdateOwner

isUpdateOwner
public boolean isUpdateOwner

Whether to update the owner of the room attribute involved.

  • Required: Not required.

ZIMRoomAttributesDeleteConfig

The behavior attribute set by the room attribute.

Details

The behavior attribute set by the room attribute.

Declared in entity/ZIMRoomAttributesDeleteConfig.java

Properties

isForce

isForce
public boolean isForce

Whether the operation is mandatory, that is, the property of the room whose owner is another user can be deleted.

  • Required: Not required.

ZIMRoomAttributesSetConfig

The behavior attribute set by the room attribute.

Details

The behavior attribute set by the room attribute.

Declared in entity/ZIMRoomAttributesSetConfig.java

Properties

isDeleteAfterOwnerLeft

isDeleteAfterOwnerLeft
public boolean isDeleteAfterOwnerLeft

Room attributes are automatically deleted after the owner leaves the room.

  • Required: Not required.

isForce

isForce
public boolean isForce

Whether the operation is mandatory, that is, the property of the room whose owner is another user can be modified.

  • Required: Not required.

isUpdateOwner

isUpdateOwner
public boolean isUpdateOwner

Whether to update the owner of the room attribute involved.

  • Required: Not required.

ZIMRoomAttributesUpdateInfo

Notice of Room Attribute Change.

Details

Notice of Room Attribute Change.

Declared in entity/ZIMRoomAttributesUpdateInfo.java

Properties

action

action

Behavioral information of room attribute change notification.

roomAttributes

roomAttributes
public HashMap<String, String> roomAttributes

Room attributes.

ZIMRoomFullInfo

The room details object.

Details

Identifies the basic parameters of a message.

  • Caution: Identifies the detailed information of a room.

Declared in entity/ZIMRoomFullInfo.java

Properties

baseInfo

baseInfo
public ZIMRoomInfo baseInfo

The base object of the room.

ZIMRoomInfo

Room information object.

Details

Identifies a unique room.

Declared in entity/ZIMRoomInfo.java

Properties

roomID

roomID
public String roomID

Room ID. a string with a maximum length of 128 bytes. It is customized by the developer and supports only digits, English characters, , and '!', '#', '$', '%', '&', '(', ')', '+', '-', ':', ';', '<', '=', '.', '>', '?', '@', '[', ']', '^', '_', '{', '}', '|', ''.

roomName

roomName
public String roomName

Room name, It is customized by the developer .a string with a maximum length of 64 bytes or less

ZIMRoomMemberAttributesInfo

Room user attribute information.

Details

Detail description: A class describing room user attributes, including UserID and its corresponding attributes.

Declared in entity/ZIMRoomMemberAttributesInfo.java

Properties

userID

userID
public String userID

Detail description: User ID.

attributes

attributes
public HashMap<String, String> attributes

Detailed description: room user attributes.

ZIMRoomMemberAttributesOperatedInfo

Room user attribute operation information.

Details

Detail description: room user attribute operation information, including attributes of successful operation and keys of failure.

Declared in entity/ZIMRoomMemberAttributesOperatedInfo.java

Properties

attributesInfo

attributesInfo
public ZIMRoomMemberAttributesInfo attributesInfo

Detailed description: room user attribute information.

errorKeys

errorKeys
public ArrayList<String> errorKeys

Detail description: The key of the room user attribute operation failure.

ZIMRoomMemberAttributesQueryConfig

Room user attribute query configuration.

Details

Detailed description: room user attribute query configuration.

Declared in entity/ZIMRoomMemberAttributesQueryConfig.java

Properties

nextFlag

nextFlag
public String nextFlag

Detail description: Query anchor for room user properties.

Required or not: not required, it is empty by default for the first time, which means to start the query from the beginning.

count

count
public int count
  • Required: Required.

ZIMRoomMemberAttributesSetConfig

Room user property settings configuration.

Details

Detail description: room user attribute setting configuration, including configurable whether to retain user attributes after the user leaves, etc.

Business scenarios: When setting room user attributes, developers can choose to use them according to their actual application scenarios.

Declared in entity/ZIMRoomMemberAttributesSetConfig.java

Properties

isDeleteAfterOwnerLeft

isDeleteAfterOwnerLeft
public boolean isDeleteAfterOwnerLeft
  • Required: not required.

Default: true.

ZIMRoomMemberAttributesUpdateInfo

Room user attribute update information.

Details

Detailed description: Room user attribute update information.

Declared in entity/ZIMRoomMemberAttributesUpdateInfo.java

Properties

attributesInfo

attributesInfo
public ZIMRoomMemberAttributesInfo attributesInfo

Detailed description: room user attributes.

ZIMRoomMemberInfo

Room user information.

Details

Detail description: A class describing room user.

Declared in entity/ZIMRoomMemberInfo.java

Properties

userID

userID
public String userID

User ID, a string with a maximum length of 32 bytes or less. It is customized by the developer. Only support numbers, English characters and '!', '#', '$', '%', '&', '(', ')', '+', '-', ':', ';', '<', '=', '.', '>', '?', '@', '[', ']', '^', '_', '{', '}', '|', '~'.

userName

userName
public String userName

User name, defined by you. For version 2.0.0 and onwards, the string has a maximum length of 256 bytes.

  • Required: Not required.
  • Privacy reminder: Please do not provide sensitive personal information, including but not limited to mobile phone numbers, ID card numbers, passport numbers, and real names.

userAvatarUrl

userAvatarUrl
public String userAvatarUrl

The user avatar, which is custom generated by the developer, is not restricted by special characters and has a maximum length of 500 bytes.

  • Required: Not required.
  • Privacy reminder: Please do not provide sensitive personal information, including but not limited to mobile phone numbers, ID card numbers, passport numbers, and real names.
  • Available since: 2.13.0 and above.

userExtendedData

userExtendedData
public String userExtendedData

Extended field information of the user.

  • Caution: This property has a value only for room users.

ZIMRoomMemberQueryConfig

Configuration for querying room member.

Details

When querying member, you need to configure this object.

Declared in entity/ZIMQueryMemberConfig.java

Properties

nextFlag

nextFlag
public String nextFlag

The flag of the paging query. For the first query, set this field to an empty string. If the "nextFlag" field of the callback is not an empty string, it needs to be set here to continue the query on the next page.

  • Required: Not required.

count

count
public int count

How many messages are retrieved in one query.

  • Caution: To obtain messages in pages to reduce overhead, it is recommended to obtain within 100 messages at a time. If the value is 0, the SDK will query 100 room member by default.
  • Required: Required.

ZIMRoomOperatedInfo

Room operation information.

Details

Detailed description: Room operation information.

Declared in entity/ZIMRoomOperatedInfo.java

Properties

userID

userID
public String userID

Detail description: UserID of the operator.

ZIMSelfUserInfo

Carry user information and rules of the current user.

Details

Carry user information and rules of the current user.

Declared in entity/ZIMUserRule.java

Properties

userRule

userRule
public ZIMUserRule userRule

Rules for the current user, setting information.

userFullInfo

userFullInfo
public ZIMUserFullInfo userFullInfo

Personal information of the current user.

ZIMSelfUserRule

User's own rule class.

Declared in entity/ZIMSelfUserRule.java

Properties

offlinePushRule

offlinePushRule
public ZIMUserOfflinePushRule offlinePushRule

The user's current rule information.

ZIMSendingMessageCancelConfig

Details

(Empty Class) Configurations related to cancel sending messages.

Declared in entity/ZIMSendingMessageCancelConfig.java

ZIMSubscribedUserStatusQueryConfig

QuerySubscribedUserStatusList query subscription list interface configuration items.

Details

QuerySubscribedUserStatusList query subscription list interface configuration items.

Declared in ZIMSubscribedUserStatusQueryConfig.java

Properties

userIDs

userIDs
public ArrayList\<String\> userIDs

Pass this value if you need to check whether the specified user is in the subscription list of the current user, otherwise all users in the subscription list will be returned.

ZIMTextMessage

Normal text message object.

Details

Identifies the basic parameters of a message.

  • Caution: If the Type parameter of the base class is Text during callback, you can force the base class message object to be of this type.

Declared in entity/ZIMTextMessage.java

Properties

message

message
public String message

The content of the text message.

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

  • Use cases: Can be used to index other messages.
  • Caution: When the developer actively creates a message, there is no need to modify this parameter. This parameter only has a value during callback.

timestamp

timestamp
public long timestamp

Identifies the sending time of a message

  • Use cases: Used to present the sending time of a message, and can be used for message sorting.
  • Caution: This is a standard UNIX timestamp, in milliseconds.

senderUserID

senderUserID
public String senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public String conversationID

Conversation ID. Ids of the same conversation type are unique.

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public long conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

The larger the orderKey, the newer the message, and can be used for ordering messages.

localMessageID

localMessageID
public long localMessageID

SDK locally generated MessageID, developers do not need to pay attention to.

isUserInserted

isUserInserted
public boolean isUserInserted

Detail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

Business scenario: used to determine the status of the current message in the receipt message

extendedData

extendedData
public String extendedData

message extension field

  • Use cases: You can add extended fields to the message and send it to the peer
  • Required: no
  • Caution: the length is 1k, you can contact technical support for configuration
  • Available since: 2.6.0 or higher

localExtendedData

localExtendedData
public String localExtendedData

The expandable message field visible only on this end can store additional information locally, Through [updateMessageLocalExtendedData] change and currently has a length limit of 128K. If you have special requirements, please contact ZEGO technical support for configuration.

isBroadcastMessage

isBroadcastMessage
public boolean isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
private boolean isMentionAll

Whether to mention everyone. It can be presented as "@Everyone".

  • Use cases: For example, it can be used in groups or rooms.
  • Required: No.
  • Default value: false.
  • Recommended value: Set to true if you need to mention everyone.
  • Caution: This value does not add the "@Everyone" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

mentionedUserIDs

mentionedUserIDs
private ArrayList\<String> mentionedUserIDs

Whether to mention everyone. It can be presented as "@User".

  • Use cases: For example, it can be used in sending messages.
  • Required: No.
  • Caution: This value does not add the "@User" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

messageSeq

messageSeq
public long messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public int rootRepliedCount

The number of reply messages corresponding to the root message of the reply message tree.

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public String editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public long editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public boolean isGroupTargetedMessage

Identify if this message is group targeted message.

pinnedUserID

pinnedUserID
public String pinnedUserID

The last user who pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

pinnedTime

pinnedTime
public long pinnedTime

The last timestamp when pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

Methods

ZIMTextMessage

ZIMTextMessage
Declared in entity/ZIMTextMessage.java

ZIMTextMessageLiteInfo

Normal text message lite info object.

Details

Identifies the basic parameters of a message lite info.

  • Caution: If the Type parameter of the base class is Text during callback, you can force the base class message lite info object to be of this type.

Declared in entity/ZIMTextMessageLiteInfo.java

Properties

message

message
public String message

The content of the text message.

type

type
public ZIMMessageType type

Identifies the type of this message.

Methods

ZIMTextMessageLiteInfo

ZIMTextMessageLiteInfo
Declared in entity/ZIMTextMessageLiteInfo.java

ZIMTipsMessage

Tips message object.

Details

Identifies a tips info message.

  • Caution: If the Type parameter of the base class is Tips during callback, you can force the base class message object to be of this type.

Declared in entity/ZIMTipsMessage.java

Properties

event

event
public ZIMTipsMessageEvent event

The type of the tips message.

operatedUser

operatedUser
public ZIMUserInfo operatedUser

The initiator of the action corresponding to the tips message.

targetUserList

targetUserList
public ArrayList<ZIMUserInfo> targetUserList

The target user list for the operation corresponding to the tips message.

changeInfo

changeInfo
public ZIMTipsMessageChangeInfo changeInfo

Additional information for the operation corresponding to the tips message.

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

  • Use cases: Can be used to index other messages.
  • Caution: When the developer actively creates a message, there is no need to modify this parameter. This parameter only has a value during callback.

timestamp

timestamp
public long timestamp

Identifies the sending time of a message

  • Use cases: Used to present the sending time of a message, and can be used for message sorting.
  • Caution: This is a standard UNIX timestamp, in milliseconds.

senderUserID

senderUserID
public String senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public String conversationID

Conversation ID. Ids of the same conversation type are unique.

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public long conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

The larger the orderKey, the newer the message, and can be used for ordering messages.

localMessageID

localMessageID
public long localMessageID

SDK locally generated MessageID, developers do not need to pay attention to.

isUserInserted

isUserInserted
public boolean isUserInserted

Detail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

Business scenario: used to determine the status of the current message in the receipt message

extendedData

extendedData
public String extendedData

message extension field

  • Use cases: You can add extended fields to the message and send it to the peer
  • Required: no
  • Caution: the length is 1k, you can contact technical support for configuration
  • Available since: 2.6.0 or higher

localExtendedData

localExtendedData
public String localExtendedData

The expandable message field visible only on this end can store additional information locally, Through [updateMessageLocalExtendedData] change and currently has a length limit of 128K. If you have special requirements, please contact ZEGO technical support for configuration.

isBroadcastMessage

isBroadcastMessage
public boolean isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
private boolean isMentionAll

Whether to mention everyone. It can be presented as "@Everyone".

  • Use cases: For example, it can be used in groups or rooms.
  • Required: No.
  • Default value: false.
  • Recommended value: Set to true if you need to mention everyone.
  • Caution: This value does not add the "@Everyone" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

mentionedUserIDs

mentionedUserIDs
private ArrayList\<String> mentionedUserIDs

Whether to mention everyone. It can be presented as "@User".

  • Use cases: For example, it can be used in sending messages.
  • Required: No.
  • Caution: This value does not add the "@User" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

messageSeq

messageSeq
public long messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public int rootRepliedCount

The number of reply messages corresponding to the root message of the reply message tree.

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public String editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public long editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public boolean isGroupTargetedMessage

Identify if this message is group targeted message.

pinnedUserID

pinnedUserID
public String pinnedUserID

The last user who pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

pinnedTime

pinnedTime
public long pinnedTime

The last timestamp when pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

ZIMTipsMessageChangeInfo

Tips message additional information.

Details

Tips message additional information.

Declared in entity/ZIMTipsMessageChangeInfo.java

Properties

type

type

Tips message additional information type.

ZIMTipsMessageGroupChangeInfo

Tips Additional information about change events related to the message group.

Details

Tips Additional information about change events related to the message group.

Declared in entity/ZIMTipsMessageGroupChangeInfo.java

Properties

groupDataFlag

groupDataFlag
public int groupDataFlag

If there are multiple changes in the group name, group avatar, and group announcement, you need to know which ones have changed based on the value of this field. Among them, 0b0001 is the group name, 0b0010 is the group notice, and 0b0100 is the group avatar.

groupName

groupName
public String groupName

If the group name is changed, the changed value will be displayed here.

groupNotice

groupNotice
public String groupNotice

If the group notice is changed, the changed value will be displayed here.

groupAvatarUrl

groupAvatarUrl
public String groupAvatarUrl

If the group avatar url is changed, the changed value will be displayed here.

groupMutedInfo

groupMutedInfo
public ZIMGroupMuteInfo groupMutedInfo

If the group mute info is changed, the changed value will be displayed here.

type

type

Tips message additional information type.

ZIMTipsMessageGroupMemberChangeInfo

Tips Additional information about change events related to the message group member.

Details

Tips Additional information about change events related to the message group member.

Declared in entity/ZIMTipsMessageGroupMemberChangeInfo.java

Properties

memberRole

memberRole
public int memberRole

If a group member's role changes, the changed role will be displayed here.

muteExpiredTime

muteExpiredTime
public long muteExpiredTime

If the group member's muting expired time changes, the new muting expired time will be displayed here.

groupNewOwner

groupNewOwner
public ZIMGroupMemberSimpleInfo groupNewOwner

Displays information about the new group owner when the group owner leaves the group or is kicked from the group by the server.

  • Use cases: Used for UI display when the group owner leaves the group or is kicked from the group by the server.

type

type

Tips message additional information type.

ZIMTipsMessagePinStatusChangeInfo

Tips Additional information about change events related to the message pinned or unpined.

Details

Tips Additional information about change events related to the message pinned or unpined.

Declared in entity/ZIMTipsMessagePinStatusChangeInfo.java

Properties

isPinned

isPinned
public boolean isPinned

Describes whether the current operation is a pin operation or an unpin operation.

type

type

Tips message additional information type.

ZIMUserFullInfo

User full information object.

Details

Identifies a unique user.

  • Caution: that the userID must be unique under the same appID, otherwise mutual kicks out will occur. It is strongly recommended that userID corresponds to the user ID of the business APP, that is, a userID and a real user are fixed and unique, and should not be passed to the SDK in a random userID. Because the unique and fixed userID allows ZEGO technicians to quickly locate online problems.

Declared in entity/ZIMUserInfo.java

Properties

baseInfo

baseInfo
public ZIMUserInfo baseInfo

User basic information.

userAvatarUrl

userAvatarUrl
deprecated
public String userAvatarUrl
  • Required: not required.

Use restrictions: The value is a maximum of 500 bytes and contains no special characters.

Deprecated
Deprecated in version 2.13.0. To obtain the URL of a user's avatar, please refer to userAvatarUrl from the baseInfo.

extendedData

extendedData
public String extendedData
  • Required: not required.

Privacy Protection Statement: Do not pass in sensitive information involving personal privacy, including but not limited to mobile phone numbers, ID numbers, passport numbers, real names, etc.

ZIMUserInfo

User information object.

Details

Identifies a unique user.

  • Caution: that the userID must be unique under the same appID, otherwise mutual kicks out will occur. It is strongly recommended that userID corresponds to the user ID of the business APP, that is, a userID and a real user are fixed and unique, and should not be passed to the SDK in a random userID. Because the unique and fixed userID allows ZEGO technicians to quickly locate online problems.

Declared in entity/ZIMUserInfo.java

Properties

userID

userID
public String userID

User ID, a string with a maximum length of 32 bytes or less. It is customized by the developer. Only support numbers, English characters and '!', '#', '$', '%', '&', '(', ')', '+', '-', ':', ';', '<', '=', '.', '>', '?', '@', '[', ']', '^', '_', '{', '}', '|', '~'.

userName

userName
public String userName

User name, defined by you. For version 2.0.0 and onwards, the string has a maximum length of 256 bytes.

  • Required: Not required.
  • Privacy reminder: Please do not provide sensitive personal information, including but not limited to mobile phone numbers, ID card numbers, passport numbers, and real names.

userAvatarUrl

userAvatarUrl
public String userAvatarUrl

The user avatar, which is custom generated by the developer, is not restricted by special characters and has a maximum length of 500 bytes.

  • Required: Not required.
  • Privacy reminder: Please do not provide sensitive personal information, including but not limited to mobile phone numbers, ID card numbers, passport numbers, and real names.
  • Available since: 2.13.0 and above.

userExtendedData

userExtendedData
public String userExtendedData

Extended field information of the user.

  • Caution: This property has a value only for room users.

ZIMUserOfflinePushRule

Data class of the user's offline push rule.

Details

Data class of the user's offline push rule.

Declared in ZIMUserOfflinePushRule.java

Properties

onlinePlatforms

onlinePlatforms
public List\<int> onlinePlatforms

With the data in the class member variables notToReceiveOfflinePushPlatforms collocation is used. OnlinePlatforms specified platform, online notToReceiveOfflinePushPlatforms specified platform will not receive offline push.

  • Value range: Please enter the enumeration value corresponding to the platform in the ZIMPlatformType enumeration.

notToReceiveOfflinePushPlatforms

notToReceiveOfflinePushPlatforms
public List\<int> notToReceiveOfflinePushPlatforms

With the data in the class member variables onlinePlatforms collocation is used. OnlinePlatforms specified platform, online notToReceiveOfflinePushPlatforms specified platform will not receive offline push.

  • Value range: Please enter the enumeration value corresponding to the platform in the ZIMPlatformType enumeration.

ZIMUserStatus

User status data

Details

Contains data about the user's online status.

Declared in ZIMUserStatus.java

Properties

userID

userID
public String userID

A unique identifier for a single user.

onlineStatus

onlineStatus
public ZIMUserOnlineStatus onlineStatus

Enumeration that represents the current online status of the user.

onlinePlatforms

onlinePlatforms
public List\<Number> onlinePlatforms

The list of online platforms of the current user can be used to display the online platforms of the user, such as iPhone online and PC online. Please refer to ZIMPlatform for the meanings of the numbers.

lastUpdateTime

lastUpdateTime
public long lastUpdateTime

Timestamp when user onlineStatus or customStatus was last changed, whichever is the greater.

lastOnlineStatusUpdateTime

lastOnlineStatusUpdateTime
public long lastOnlineStatusUpdateTime

The timestamp of the last change of the user onlineStatus, which can be used to show that the user was offline/logged in before xxx minutes.

lastCustomStatusUpdateTime

lastCustomStatusUpdateTime
public long lastCustomStatusUpdateTime

The timestamp when User customStatus was last changed, which can be used to show when the custom status was last changed.

customStatus

customStatus
public String customStatus

User-defined status. The default maximum value is 64 bytes. The default expiration time is 1 day. At login, if the field is an empty string (which is the default), the current user's custom state is not modified.

ZIMUserStatusSubscribeConfig

subscribeUsersStatus Configuration items of the online status interface for subscribing users in batches.

Details

subscribeUsersStatus Configuration items of the online status interface for subscribing users in batches.

Declared in ZIMUserStatusSubscribeConfig.java

Properties

subscriptionDuration

subscriptionDuration
public int subscriptionDuration

Used to set the duration of this subscription.

  • Use cases: This field is required.
  • Value range: :1 to 43200 (30 days), and the unit is minute.
  • Caution: After the subscription is expired, the subscribed user will be deleted from the subscription list, and the status changes of the user will not be synchronized to the subscriber.

ZIMUserStatusSubscription

User status subscription information. Contains the user's online status, a list of online platforms, subscription expiration time stamps, and more.

Details

User status subscription information. Contains the user's online status, a list of online platforms, subscription expiration time stamps, and more.

  • Available since: 2.18.0

Declared in ZIMUserStatusSubscription.java

Properties

userStatus

userStatus
public ZIMUserStatus userStatus

The online status of the user.

subscribeExpiredTime

subscribeExpiredTime
public long subscribeExpiredTime

The timestamp when the user's subscription expired.

ZIMUsersInfoQueryConfig

User information query configuration.

Details

Detailed description: User information query configuration, you can choose to query from the local or from the server. Query the unlimited frequency constraints from the local, and query the limited frequency constraints from the server. You can only query the detailed configuration of 10 users within 10 s.

Declared in ZIMDefines.java

Properties

isQueryFromServer

isQueryFromServer
public boolean isQueryFromServer
  • Required: not required.

Default: false.

ZIMVideoMessage

Video message object.

Declared in entity/ZIMVideoMessage.java

Properties

videoDuration

videoDuration
public long videoDuration
  • Required: Required by the sender, if not filled, the video message will fail to be sent when sending local video messages.

videoFirstFrameLocalPath

videoFirstFrameLocalPath
public String videoFirstFrameLocalPath

Detailed description: The video first frame local path of the video file.

Required or not: The sender does not need to fill in it. After calling [downloadMediaFile] to download, the SDK will generate this value.

videoFirstFrameDownloadUrl

videoFirstFrameDownloadUrl
public String videoFirstFrameDownloadUrl

Detail description: Video first frame external download URL of the video file. When developers upload thumbnails to their own servers, the SDK can pass through this field to other users.

Required or not: optional on the sender side, this field will only take effect when fileDownloadUrl is filled in.

videoFirstFrameWidth

videoFirstFrameWidth
public int videoFirstFrameWidth

Detailed description: The width of the first frame of the video.

Business scenario: When the user needs to draw a picture UI, the parameter used to determine the width of the first frame of the video, the unit is pixel.

videoFirstFrameHeight

videoFirstFrameHeight
public int videoFirstFrameHeight

Detailed description: The height of the first frame of the video.

Business scenario: When the user needs to draw a picture UI, the parameter used to determine the height of the first frame of the video, the unit is pixel.

fileLocalPath

fileLocalPath
public String fileLocalPath
  • Required: If a local file is sent, this parameter must be set by the sender. Otherwise, the message fails to be sent.

fileDownloadUrl

fileDownloadUrl
public String fileDownloadUrl

Detail description: The external download url of the media message is used for the developer to transparently transmit the media file to other users by filling in this URL when the developer uploads the media file to his own server.

Required or not: If an external URL is sent, this parameter is mandatory on the sender end.

fileUID

fileUID
public String fileUID

Detail description: The unique ID of the media file.

Required or not: The sender does not need to fill in, this value is generated by the SDK.

fileName

fileName
public String fileName

Detail description: The filename of the media file.

Required or not: If you are sending an external URL, you need to fill in this value and include the file extension. If a local file is sent, the value is optional.

fileSize

fileSize
public long fileSize

Detail description: The size of the media file.

Required or not: The sender does not need to fill in, this value is generated by the SDK.

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

  • Use cases: Can be used to index other messages.
  • Caution: When the developer actively creates a message, there is no need to modify this parameter. This parameter only has a value during callback.

timestamp

timestamp
public long timestamp

Identifies the sending time of a message

  • Use cases: Used to present the sending time of a message, and can be used for message sorting.
  • Caution: This is a standard UNIX timestamp, in milliseconds.

senderUserID

senderUserID
public String senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public String conversationID

Conversation ID. Ids of the same conversation type are unique.

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public long conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

The larger the orderKey, the newer the message, and can be used for ordering messages.

localMessageID

localMessageID
public long localMessageID

SDK locally generated MessageID, developers do not need to pay attention to.

isUserInserted

isUserInserted
public boolean isUserInserted

Detail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

Business scenario: used to determine the status of the current message in the receipt message

extendedData

extendedData
public String extendedData

message extension field

  • Use cases: You can add extended fields to the message and send it to the peer
  • Required: no
  • Caution: the length is 1k, you can contact technical support for configuration
  • Available since: 2.6.0 or higher

localExtendedData

localExtendedData
public String localExtendedData

The expandable message field visible only on this end can store additional information locally, Through [updateMessageLocalExtendedData] change and currently has a length limit of 128K. If you have special requirements, please contact ZEGO technical support for configuration.

isBroadcastMessage

isBroadcastMessage
public boolean isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
private boolean isMentionAll

Whether to mention everyone. It can be presented as "@Everyone".

  • Use cases: For example, it can be used in groups or rooms.
  • Required: No.
  • Default value: false.
  • Recommended value: Set to true if you need to mention everyone.
  • Caution: This value does not add the "@Everyone" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

mentionedUserIDs

mentionedUserIDs
private ArrayList\<String> mentionedUserIDs

Whether to mention everyone. It can be presented as "@User".

  • Use cases: For example, it can be used in sending messages.
  • Required: No.
  • Caution: This value does not add the "@User" to the message text. Developers need to implement it themselves
  • Available since: 2.14.0 or above

messageSeq

messageSeq
public long messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public int rootRepliedCount

The number of reply messages corresponding to the root message of the reply message tree.

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public String editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public long editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public boolean isGroupTargetedMessage

Identify if this message is group targeted message.

pinnedUserID

pinnedUserID
public String pinnedUserID

The last user who pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

pinnedTime

pinnedTime
public long pinnedTime

The last timestamp when pinned this message.

  • Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].

ZIMVideoMessageLiteInfo

Video message lite info object.

Details

Identifies a video message.

Usage restrictions: Only supports video files with video encoding formats of H264 and H265. After the message is sent successfully, the width and height information of the first frame of the video can be obtained.

Declared in entity/ZIMVideoMessageLiteInfo.java

Properties

videoDuration

videoDuration
public long videoDuration
  • Required: Required by the sender, if not filled, the video message will fail to be sent when sending local video messages.

videoFirstFrameLocalPath

videoFirstFrameLocalPath
public String videoFirstFrameLocalPath

Detailed description: The video first frame local path of the video file.

Required or not: The sender does not need to fill in it. After calling [downloadMediaFile] to download, the SDK will generate this value.

videoFirstFrameDownloadUrl

videoFirstFrameDownloadUrl
public String videoFirstFrameDownloadUrl

Detail description: Video first frame external download URL of the video file. When developers upload thumbnails to their own servers, the SDK can pass through this field to other users.

Required or not: optional on the sender side, this field will only take effect when fileDownloadUrl is filled in.

videoFirstFrameWidth

videoFirstFrameWidth
public int videoFirstFrameWidth

Detailed description: The width of the first frame of the video.

Business scenario: When the user needs to draw a picture UI, the parameter used to determine the width of the first frame of the video, the unit is pixel.

videoFirstFrameHeight

videoFirstFrameHeight
public int videoFirstFrameHeight

Detailed description: The height of the first frame of the video.

Business scenario: When the user needs to draw a picture UI, the parameter used to determine the height of the first frame of the video, the unit is pixel.

fileLocalPath

fileLocalPath
public String fileLocalPath
  • Required: If a local file is sent, this parameter must be set by the sender. Otherwise, the message fails to be sent.

fileDownloadUrl

fileDownloadUrl
public String fileDownloadUrl

Detail description: The external download url of the media message is used for the developer to transparently transmit the media file to other users by filling in this URL when the developer uploads the media file to his own server.

Required or not: If an external URL is sent, this parameter is mandatory on the sender end.

fileName

fileName
public String fileName

Detail description: The filename of the media file.

Required or not: If you are sending an external URL, you need to fill in this value and include the file extension. If a local file is sent, the value is optional.

fileSize

fileSize
public long fileSize

Detail description: The size of the media file.

Required or not: The sender does not need to fill in, this value is generated by the SDK.

type

type
public ZIMMessageType type

Identifies the type of this message.

ZIMVoIPConfig

Provides information about the iOS VoIP offline push.

Details

Provides information about the iOS VoIP offline push.

Declared in entity/ZIMVoIPConfig.java

Properties

iOSVoIPHandleType

iOSVoIPHandleType
public ZIMCXHandleType iOSVoIPHandleType

The type of contact information for the VoIP caller, by default, is generic.

iOSVoIPHandleValue

iOSVoIPHandleValue
public String iOSVoIPHandleValue

The contact information of the VoIP caller. It is related to iOSVoIPHandleType. When iOSVoIPHandleType is PhoneNumber, the Value is a sequence of digits; when iOSVoIPHandleType is EmailAddress, the Value is an email address; when the contact information is of other types, the Value typically follows some domain-specific format, such as a username, numeric ID, or URL.

iOSVoIPHasVideo

iOSVoIPHasVideo
public boolean iOSVoIPHasVideo

Video call or not. The default value is audio

ZPNsConfig

ZPNs push configuration class.

Details

ZPNs push configuration class.

  • Use cases: Add the required configuration items pushed by each vendor and a Boolean value for whether to enable them.

Declared in ZPNs.java

Properties

enableHWPush

enableHWPush
public boolean enableHWPush

Whether to enable Huawei Boolean push.

enableMiPush

enableMiPush
public boolean enableMiPush

Whether to enable the Boolean value pushed by Xiaomi.

enableVivoPush

enableVivoPush
public boolean enableVivoPush

Whether to enable the Boolean value pushed by vivo.

miAppID

miAppID
public String miAppID

Xiaomi pushes the required AppID.

miAppKey

miAppKey
public String miAppKey

Xiaomi pushes the required AppKey.

oppoAppID

oppoAppID
public String oppoAppID

oppo pushes the required AppID.

oppoAppSecret

oppoAppSecret
public String oppoAppSecret

Oppo pushes the required AppSecret.

oppoAppKey

oppoAppKey
public String oppoAppKey

oppo pushes the required AppKey.

vivoAppID

vivoAppID
public String vivoAppID

Vivo pushes the desired AppID.

vivoAppKey

vivoAppKey
public String vivoAppKey

vivo pushes the required AppKey.

hwAppID

hwAppID
public String hwAppID

Huawei pushes the required AppID.

enableFCMPush

enableFCMPush
public boolean enableFCMPush

whether to enable Google Push Boolean

enableOppoPush

enableOppoPush
public boolean enableOppoPush

Whether to enable the Boolean value pushed by oppo.

enableHwBadge

enableHwBadge
public boolean enableHwBadge

Set this parameter to true when the device is a Huawei device and the receiver needs to enable the corner marking function.

  • Use cases: Please fill in before the registerPush call and pass ZPNs through the setPushConfig interface.
  • Required: This is not required.
  • Default value: The default is false.

apptype

apptype
private int apptype

Used to specify the number of offline push configurations for the current project corresponding to the ZEGO console, default to the first set.

  • Use cases: If you need to use the same App ID on different bundle IDs/packages.
  • Required: No.
  • Default value: 1.
  • Recommended value: It should be consistent with the 'App type' configured in the ZEGOCLOUD Console for the offline push certificate associated with the current bundle ID/package name.

Methods

enableHWPush

enableHWPush
public ZPNsConfig enableHWPush(String hwAppID)
This parameter is used to enable Huawei Push.
Declared in ZPNs.java

Parameters

NameTypeDescription
hwAppIDStringDetailed description: Huawei appID.

Details

This parameter is used to enable Huawei Push.

Return

Returns the ZPNsConfig.

enableMiPush

enableMiPush
public ZPNsConfig enableMiPush(String miAppID, String miAppKey)
This parameter is used to enable Xiaomi Push.
Declared in ZPNs.java

Parameters

NameTypeDescription
miAppIDStringDetailed description: Xiaomi AppID.
miAppKeyStringDetailed description: Xiaomi AppKey.

Details

This parameter is used to enable Xiaomi Push.

Return

Returns the ZPNsConfig.

enableVivoPush

enableVivoPush
public ZPNsConfig enableVivoPush(String vivoAppID, String vivoAppKey)
Used to enable Vivo Push.
Declared in ZPNs.java

Parameters

NameTypeDescription
vivoAppIDStringDetailed description: VIVO AppID.
vivoAppKeyStringDetailed description: VIVO AppKey.

Details

Used to enable Vivo Push.

Return

Returns the ZPNsConfig.

enableOppoPush

enableOppoPush
public ZPNsConfig enableOppoPush(String oppoAppID, String oppoAppKey, String oppoAppSecret)
Used to enable oppo Push.
Declared in ZPNs.java

Parameters

NameTypeDescription
oppoAppIDStringDescription: OPPO AppID.
oppoAppKeyStringDescription: OPPO AppKey.
oppoAppSecretStringDescription: OPPO AppSecret.

Details

Used to enable oppo Push.

Return

Returns the ZPNsConfig.

enableFCMPush

enableFCMPush
public ZPNsConfig enableFCMPush()
Used to enable Google FCM Push.
Declared in ZPNs.java

Used to enable Google FCM Push.

Returns the ZPNsConfig.

disableHWPush

disableHWPush
public ZPNsConfig disableHWPush()
Used to disable Huawei Push.
Declared in ZPNs.java

Detailed description: used to close Huawei Push.

Returns the ZPNsConfig.

disableMiPush

disableMiPush
public ZPNsConfig disableMiPush()
Used to close XiaoMi Push.
Declared in ZPNs.java

Detailed description: used to close XiaoMi Push.

Return ZPNsConfig.

disableVivoPush

disableVivoPush
public ZPNsConfig disableVivoPush()
Used to close VIVO Push.
Declared in ZPNs.java

Detailed description: used to close VIVO Push.

Return ZPNsConfig.

disableOppoPush

disableOppoPush
public ZPNsConfig disableOppoPush()
Used to close VIVO Push.
Declared in ZPNs.java

Detailed description: used to close VIVO Push.

Return ZPNsConfig.

disableFCMPush

disableFCMPush
public ZPNsConfig disableFCMPush()
Used to close Google FCM Push.
Declared in ZPNs.java

Detailed description: used to close Google FCM Push.

Return ZPNsConfig.

setAppType

setAppType
public void setAppType(int apptype)
Used to specify the number of offline push configurations for the current project corresponding to the ZEGO console, default to the first set. For details, refer to the description under apptype.
Declared in ZPNs.java
NameTypeDescription
apptypeintDescription: Used to specify the number of offline push configurations for the current project corresponding to the ZEGO console, default to the first set.

Use cases: Ignore if your same ZEGO appID is not used for different bundle ids/package names.

Required: This is not required.

Default value: If this value is not set, the default is the first set.

Recommended value: Where is the current bundle ID/ package name configured for offline push configuration in the ZEGO console? For example, 2 for the second set.

ZPNsMessage

ZPNs message class.

Details

ZPNs message class.

  • Use cases: Use the object of this data class to get the details of the push message.

Declared in ZPNs.java

Properties

title

title
public String title

Message title, or notification title if it is a notification message.

content

content
public String content

Message content: indicates the notification content of the message if the message is passed through. Indicates the body of the transparent message if the message is passed through.

  • Caution: oppo all key values add up to a maximum of 500 characters (note: each value is currently within 50 characters, later adjusted).

pushType

pushType
public ZPNsType pushType

Push message type.

pushSource

pushSource
public PushSource pushSource

Push the source.

extras

extras
public Object extras

Each platform passes the source object, need to determine the type conversion.

notifyId

notifyId
public int notifyId

Notification bar ID.

ZPNsRegisterMessage

Describes the message class that vendors push token information.

Details

Describes the message class that vendors push token information.

  • Use cases: When onRegister is triggered, an object of this data class is returned, carrying a message class about vendor push token information.

Declared in ZPNs.java

Properties

errorCode

errorCode
public ZPNsErrorCode errorCode

ZPNs Error code.

msg

msg
public String msg

Success and error messages returned by the request.

pushID

pushID
public String pushID

ZPNs Push ID generated.

commandResult

commandResult
public String commandResult

The parameter returned by the command.

extra

extra
public Object extra

Each platform passes the source object, need to determine the type conversion.

pushCmdType

pushCmdType
public PushCmdType pushCmdType

Push command type.

Previous

Interface

Next

Enum

On this page

Back to top