Struct
ZIMAppConfig
ZIM application configuration, including AppID and AppSign.
Declared in entity/ZIMAppConfig.java
Properties
appID
public long appID- Required: Required.
appSign
public String appSign- Required: Required.
ZIMAudioANSParam
ANS Parameter
Details
Includes noise suppression mode.
Declared in ZIMAudioANSParam.java
Properties
mode
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
public ZIMAudioErrorCode codeError code.
message
public String messageIt 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
public Number sampleRateThe audio sample rate.
channels
public Number channelsThe 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
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
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
public String fileDownloadUrlDetail 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
public String fileUIDDetail 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
public String fileNameDetail 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
public long fileSizeDetail 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
messageID
public long messageIDThe 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
public long timestampIdentifies 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
public String senderUserIDDisplays the userID of the sender of this message.
conversationID
public String conversationIDConversation ID. Ids of the same conversation type are unique.
direction
public ZIMMessageDirection directionUsed to describe whether a message is sent or received.
sentStatus
conversationType
public ZIMConversationType conversationTypeThe type of conversation to which the message belongs.
conversationSeq
public long conversationSeqIndicates the sequence number of the message in the conversation.
orderKey
public long orderKeyThe larger the orderKey, the newer the message, and can be used for ordering messages.
localMessageID
public long localMessageIDSDK locally generated MessageID, developers do not need to pay attention to.
isUserInserted
public boolean isUserInsertedDetail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].
Default: false.
receiptStatus
public ZIMMessageReceiptStatus receiptStatusDescribe the receipt status of the message
Business scenario: used to determine the status of the current message in the receipt message
extendedData
public String extendedDatamessage 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
public String localExtendedDataThe 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
public boolean isBroadcastMessageWhether the message is pushed by all employees.
- Required: Internal assignment.
isMentionAll
private boolean isMentionAllWhether 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
private ArrayList\<String> mentionedUserIDsWhether 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
public long messageSeqIndicates the sequence number of the message in the conversation.
rootRepliedCount
public int rootRepliedCountThe number of reply messages corresponding to the root message of the reply message tree.
repliedInfo
public ZIMMessageRepliedInfo repliedInfoInformation about the source message referenced by the reply message.
editorUserID
public String editorUserIDThe latest editor's userID for this message.
editedTime
public long editedTimeThe latest editing timestamp for this message.
isGroupTargetedMessage
public boolean isGroupTargetedMessageIdentify if this message is group targeted message.
pinnedUserID
public String pinnedUserIDThe last user who pinned this message.
- Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].
pinnedTime
public long pinnedTimeThe 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
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
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
public String fileDownloadUrlDetail 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
public String fileNameDetail 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
public long fileSizeDetail 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
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
public String filePathThe 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
ZIMAudioRecordConfig
Audio Recording Configuration
Details
Configure the recording file output path and maximum recording time during recording.
Declared in ZIMAudioRecordConfig.java
Properties
filePath
public String filePathThe 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
public number maxDurationThe 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
public String messageThe content of barrage message.
type
messageID
public long messageIDThe 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
public long timestampIdentifies 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
public String senderUserIDDisplays the userID of the sender of this message.
conversationID
public String conversationIDConversation ID. Ids of the same conversation type are unique.
direction
public ZIMMessageDirection directionUsed to describe whether a message is sent or received.
sentStatus
conversationType
public ZIMConversationType conversationTypeThe type of conversation to which the message belongs.
conversationSeq
public long conversationSeqIndicates the sequence number of the message in the conversation.
orderKey
public long orderKeyThe larger the orderKey, the newer the message, and can be used for ordering messages.
localMessageID
public long localMessageIDSDK locally generated MessageID, developers do not need to pay attention to.
isUserInserted
public boolean isUserInsertedDetail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].
Default: false.
receiptStatus
public ZIMMessageReceiptStatus receiptStatusDescribe the receipt status of the message
Business scenario: used to determine the status of the current message in the receipt message
extendedData
public String extendedDatamessage 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
public String localExtendedDataThe 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
public boolean isBroadcastMessageWhether the message is pushed by all employees.
- Required: Internal assignment.
isMentionAll
private boolean isMentionAllWhether 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
private ArrayList\<String> mentionedUserIDsWhether 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
public long messageSeqIndicates the sequence number of the message in the conversation.
rootRepliedCount
public int rootRepliedCountThe number of reply messages corresponding to the root message of the reply message tree.
repliedInfo
public ZIMMessageRepliedInfo repliedInfoInformation about the source message referenced by the reply message.
editorUserID
public String editorUserIDThe latest editor's userID for this message.
editedTime
public long editedTimeThe latest editing timestamp for this message.
isGroupTargetedMessage
public boolean isGroupTargetedMessageIdentify if this message is group targeted message.
pinnedUserID
public String pinnedUserIDThe last user who pinned this message.
- Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].
pinnedTime
public long pinnedTimeThe 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
public int countcount.
- Required: Required.
nextFlag
public int nextFlagnextFlag.
- 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
public String cachePathThe 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
public String extendedDataExtended 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
public String extendedDataExtended field, through which the inviter can carry information to the invitee.
- Required: not required.
- Default value: "".
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
public String extendedDataExtended field, through which the inviter can carry information to the invitee.
- Required: not required.
pushConfig
ZIMCallInfo
Call invitation information.
Details
Call invitation information.
Declared in entity/ZIMCallUserInfo.java
Properties
callID
public String callIDCall invite ID.
caller
public String callerCall invitation initiator ID.
mode
state
extendedData
public String extendedDataCreate a call invitation additional information.
createTime
public number createTimeCall invites to create a timestamp.
endTime
public number endTimeCall invitation end time.
callUserList
ZIMCallInvitationAcceptedInfo
Accept the call invitation message.
Details
Accept the call invitation message.
Declared in entity/ZIMCallInvitationAcceptedInfo.java
Properties
invitee
public String inviteeInvitee ID.
extendedData
public String extendedDataExtended 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
public String inviterThe inviter ID of the call invitation.
extendedData
public String extendedDataExtended 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
public int timeoutThe timeout setting of the call invitation, the unit is seconds.
extendedData
public String extendedDataExtended field, through which the inviter can carry information to the invitee.
mode
caller
public String callerThe creator of the call invitation is the same as the userID that calls callInvite.
createTime
public long createTimeThe event stamp when the call invitation was created on the server, accurate to milliseconds.
callUserList
ZIMCallInvitationEndedInfo
End the call operation information.
Details
End the call operation information.
Declared in ZIM.java
Properties
caller
public String callerThe calling party of the current call.
operatedUserID
public String operatedUserIDEnd the call operator.
extendedData
public String extendedDataThe pass-through field that comes with invoking the end of the call.
mode
endTime
public long endTimeTime 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
public int countThe query number is limited to up to 100.
- Required: required.
nextFlag
public long nextFlagThe 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
public int timeoutThe timeout setting of the call invitation, the unit is seconds.
inviter
public String inviterInviter ID.
extendedData
public String extendedDataExtended field, through which the inviter can carry information to the invitee.
mode
caller
public String callerThe creator of the call invitation is the same as the userID that calls callInvite.
createTime
public long createTimeThe event stamp when the call invitation was created on the server, accurate to milliseconds.
callUserList
ZIMCallInvitationRejectedInfo
Reject the call invitation message.
Details
Reject the call invitation message.
Declared in entity/ZIMCallInvitationRejectedInfo.java
Properties
invitee
public String inviteeInvitee ID.
extendedData
public String extendedDataExtended 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
public int timeoutThe timeout setting of the call invitation, the unit is seconds.
errorInvitees
public ArrayList<ZIMCallUserInfo> errorInviteesUser id that has not received a call invitation.
errorUserList
public ArrayList<ZIMErrorUserInfo> errorUserListUser 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
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
public int timeoutThe timeout setting of the call invitation, the unit is seconds. The range is [1, 600].
- Required: not required.
Default: 90.
extendedData
public String extendedDataExtended field, through which the inviter can carry information to the invitee.
pushConfig
mode
public ZIMCallInvitationMode modeCall invitation mode configuration. Supported Version: 2.9.0 or later.
- Required: required. default:GENERAL
enableNotReceivedCheck
public boolean enableNotReceivedCheckIf 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
public String extendedDataExtended 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
public long createTimeTimestamp of the time when the call invitation was created.
joinTime
public long joinTimeTime stamp of the person join the call invitation.
extendedData
public String extendedDataThe pass-through field that comes with invoking the end of the call.
callUserList
public ArrayList<ZIMCallUserInfo> callUserListList 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
public String extendedDataExtended field, through which the inviter can carry information to the invitee.
- Required: Required.
pushConfig
ZIMCallQuitSentInfo
Result of quit the call operation.
Details
Result of quit the call operation.
Declared in entity/ZIMCallQuitSentInfo.java
Properties
createTime
public long createTimeTimestamp of the time when the call invitation was created.
acceptTime
public long acceptTimeTime stamp of the person accepting the call invitation.
quitTime
public long quitTimeThe 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
public String extendedDataAdditional 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
public String userIDUser 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
extendedData
public String extendedDataCall the additional information in user information.
ZIMCallUserStateChangeInfo
Call member status change information.
Details
Call member status change information.
Declared in /ZIMCallUserStateChangeInfo.java
Properties
callUserList
public ArrayList<ZIMCallUserInfo> callUserListList of call members whose status changes.
ZIMCallingInvitationSentInfo
Information about callingInvite
Details
Information about callingInvite
Declared in entity/ZIMCallingInvitationSentInfo.java
Properties
errorUserList
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
ZIMCombineMessage
Base class for combine message objects.
- Available since: 2.14.0 and above.
Declared in entity/ZIMCombineMessage.java
Properties
title
public String titleThe title of combine message
summary
public String summaryThe summary of combine message
combineID
public String combineIDCombine ID, internal user
messageList
type
messageID
public long messageIDThe 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
public long timestampIdentifies 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
public String senderUserIDDisplays the userID of the sender of this message.
conversationID
public String conversationIDConversation ID. Ids of the same conversation type are unique.
direction
public ZIMMessageDirection directionUsed to describe whether a message is sent or received.
sentStatus
conversationType
public ZIMConversationType conversationTypeThe type of conversation to which the message belongs.
conversationSeq
public long conversationSeqIndicates the sequence number of the message in the conversation.
orderKey
public long orderKeyThe larger the orderKey, the newer the message, and can be used for ordering messages.
localMessageID
public long localMessageIDSDK locally generated MessageID, developers do not need to pay attention to.
isUserInserted
public boolean isUserInsertedDetail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].
Default: false.
receiptStatus
public ZIMMessageReceiptStatus receiptStatusDescribe the receipt status of the message
Business scenario: used to determine the status of the current message in the receipt message
extendedData
public String extendedDatamessage 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
public String localExtendedDataThe 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
public boolean isBroadcastMessageWhether the message is pushed by all employees.
- Required: Internal assignment.
isMentionAll
private boolean isMentionAllWhether 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
private ArrayList\<String> mentionedUserIDsWhether 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
public long messageSeqIndicates the sequence number of the message in the conversation.
rootRepliedCount
public int rootRepliedCountThe number of reply messages corresponding to the root message of the reply message tree.
repliedInfo
public ZIMMessageRepliedInfo repliedInfoInformation about the source message referenced by the reply message.
editorUserID
public String editorUserIDThe latest editor's userID for this message.
editedTime
public long editedTimeThe latest editing timestamp for this message.
isGroupTargetedMessage
public boolean isGroupTargetedMessageIdentify if this message is group targeted message.
pinnedUserID
public String pinnedUserIDThe last user who pinned this message.
- Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].
pinnedTime
public long pinnedTimeThe 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
public String titleThe title of combine message
summary
public String summaryThe summary of combine message
type
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
public byte[] messageThe content of the custom message.
type
messageID
public long messageIDThe 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
public long timestampIdentifies 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
public String senderUserIDDisplays the userID of the sender of this message.
conversationID
public String conversationIDConversation ID. Ids of the same conversation type are unique.
direction
public ZIMMessageDirection directionUsed to describe whether a message is sent or received.
sentStatus
conversationType
public ZIMConversationType conversationTypeThe type of conversation to which the message belongs.
conversationSeq
public long conversationSeqIndicates the sequence number of the message in the conversation.
orderKey
public long orderKeyThe larger the orderKey, the newer the message, and can be used for ordering messages.
localMessageID
public long localMessageIDSDK locally generated MessageID, developers do not need to pay attention to.
isUserInserted
public boolean isUserInsertedDetail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].
Default: false.
receiptStatus
public ZIMMessageReceiptStatus receiptStatusDescribe the receipt status of the message
Business scenario: used to determine the status of the current message in the receipt message
extendedData
public String extendedDatamessage 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
public String localExtendedDataThe 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
public boolean isBroadcastMessageWhether the message is pushed by all employees.
- Required: Internal assignment.
isMentionAll
private boolean isMentionAllWhether 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
private ArrayList\<String> mentionedUserIDsWhether 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
public long messageSeqIndicates the sequence number of the message in the conversation.
rootRepliedCount
public int rootRepliedCountThe number of reply messages corresponding to the root message of the reply message tree.
repliedInfo
public ZIMMessageRepliedInfo repliedInfoInformation about the source message referenced by the reply message.
editorUserID
public String editorUserIDThe latest editor's userID for this message.
editedTime
public long editedTimeThe latest editing timestamp for this message.
isGroupTargetedMessage
public boolean isGroupTargetedMessageIdentify if this message is group targeted message.
pinnedUserID
public String pinnedUserIDThe last user who pinned this message.
- Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].
pinnedTime
public long pinnedTimeThe last timestamp when pinned this message.
- Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].
Methods
ZIMCommandMessage
ZIMConversation
Session specific content.
Details
The specific content of the session.
Declared in entity/ZIMConversation.java
Properties
conversationID
public String conversationIDconversationID.
conversationName
public String conversationNameconversationName is the same as the groupName/userName value corresponding to the session.
type
unreadMessageCount
public int unreadMessageCountSession unread.
lastMessage
orderKey
public long orderKeyOrderKey is used to describe the order of messages in the session. The larger orderKey is, the newer it is.
notificationStatus
public ZIMConversationNotificationStatus notificationStatussession notification status.
conversationAvatarUrl
public String conversationAvatarUrlDetail 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
public boolean isPinnedWhether the conversation is pinned.
mentionedInfoList
public ArrayList<ZIMMessageMentionedInfo> mentionedInfoListWhen 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
public String conversationAliasAfter 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
public ArrayList\<Integer> marksDescribes all the existing marks for the conversation.
- Use cases: The business layer can group logic, etc., according to different conversations with different marks.
draft
public String draftConversation 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
public String conversationIDconversationID.
conversationType
ZIMConversationChangeInfo
Session change information.
Details
Contains information after session changes.
Declared in callback/ZIMConversationChangeInfo.java
Properties
event
conversation
ZIMConversationDeleteConfig
Delete session configuration.
Details
Delete the related configuration of the session.
Declared in entity/ZIMConversationDeleteConfig.java
Properties
isAlsoDeleteServerConversation
public boolean isAlsoDeleteServerConversationWhether 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
public ArrayList\<Integer> marksConversation 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
public ArrayList<ZIMConversationType> conversationTypesConversation 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
public boolean isOnlyUnreadConversationWhether 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
public ZIMConversation nextConversationSession that needs to be queried.
- Required: Not required.
count
public int countThe number of sessions to query.
- Required: Required.
ZIMConversationSearchConfig
Conversation search configuration.
Details
Conversation search configuration.
Declared in entity/ZIMConversationSearchConfig.java
Properties
nextFlag
public int nextFlagPagination token, fill in 0 initially, and then fill in the nextFlag returned from the callback to retrieve data for the next page.
totalConversationCount
public int totalConversationCountThe 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
public int conversationMessageCountThe 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
public ArrayList\<String> keywordsSearch 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
public ArrayList<ZIMMessageType> messageTypesMessage types, can be used to specify message types. Support passing in multiple types.
subMessageTypes
public ArrayList\<Integer> subMessageTypesThe subtypes of custom messages have a value range of [0,200]. Developers can use this range to search for specific custom types.
senderUserIDs
public ArrayList\<String> senderUserIDsSend 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
public long startTimeThe starting point of the search, in milliseconds, with a default value of 0. The format is UTC timestamp.
endTime
public long endTimeThe 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
public String conversationIDThe conversation ID of the local message to be search.
conversationType
totalMessageCount
public int totalMessageCountTotal message count
messageList
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
public ArrayList\<Integer> marksConversation 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
public ArrayList<ZIMConversationType> conversationTypesConversation 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
public int countNumber 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
public String messageThe text content of the message.
subType
public int subTypeThe 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
public String searchedContentSearch 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
messageID
public long messageIDThe 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
public long timestampIdentifies 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
public String senderUserIDDisplays the userID of the sender of this message.
conversationID
public String conversationIDConversation ID. Ids of the same conversation type are unique.
direction
public ZIMMessageDirection directionUsed to describe whether a message is sent or received.
sentStatus
conversationType
public ZIMConversationType conversationTypeThe type of conversation to which the message belongs.
conversationSeq
public long conversationSeqIndicates the sequence number of the message in the conversation.
orderKey
public long orderKeyThe larger the orderKey, the newer the message, and can be used for ordering messages.
localMessageID
public long localMessageIDSDK locally generated MessageID, developers do not need to pay attention to.
isUserInserted
public boolean isUserInsertedDetail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].
Default: false.
receiptStatus
public ZIMMessageReceiptStatus receiptStatusDescribe the receipt status of the message
Business scenario: used to determine the status of the current message in the receipt message
extendedData
public String extendedDatamessage 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
public String localExtendedDataThe 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
public boolean isBroadcastMessageWhether the message is pushed by all employees.
- Required: Internal assignment.
isMentionAll
private boolean isMentionAllWhether 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
private ArrayList\<String> mentionedUserIDsWhether 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
public long messageSeqIndicates the sequence number of the message in the conversation.
rootRepliedCount
public int rootRepliedCountThe number of reply messages corresponding to the root message of the reply message tree.
repliedInfo
public ZIMMessageRepliedInfo repliedInfoInformation about the source message referenced by the reply message.
editorUserID
public String editorUserIDThe latest editor's userID for this message.
editedTime
public long editedTimeThe latest editing timestamp for this message.
isGroupTargetedMessage
public boolean isGroupTargetedMessageIdentify if this message is group targeted message.
pinnedUserID
public String pinnedUserIDThe last user who pinned this message.
- Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].
pinnedTime
public long pinnedTimeThe 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
public String messageThe text content of the message.
subType
public int subTypeThe 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
public String searchedContentSearch 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
ZIMError
Error infomation
Details
Error infomation.
Declared in entity/ZIMError.java
Properties
code
public ZIMErrorCode codeThe storage path of the log files. Refer to the official website document for the default path.
message
public String messageError 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
public String userIDUser 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
public int reasonDescription Reason for the query failure.
ZIMFileCacheClearConfig
Clear cache configuration.
Details
Clear cache configuration.
Declared in entity/ZIMFileCacheClearConfig.java
Properties
endTime
public long endTimeExpiration stamp of cache cleanup.
- Required: Not required.
ZIMFileCacheInfo
File cache information.
Details
Detailed description: File cache information.
Declared in entity/ZIMFileCacheInfo.java
Properties
totalFileSize
public long totalFileSizeTotal file size in bytes (B).
ZIMFileCacheQueryConfig
Query cache configuration.
Details
Query cache configuration.
Declared in entity/ZIMFileCacheQueryConfig.java
Properties
endTime
public long endTimeExample 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
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
public String fileDownloadUrlDetail 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
public String fileUIDDetail 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
public String fileNameDetail 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
public long fileSizeDetail 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
messageID
public long messageIDThe 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
public long timestampIdentifies 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
public String senderUserIDDisplays the userID of the sender of this message.
conversationID
public String conversationIDConversation ID. Ids of the same conversation type are unique.
direction
public ZIMMessageDirection directionUsed to describe whether a message is sent or received.
sentStatus
conversationType
public ZIMConversationType conversationTypeThe type of conversation to which the message belongs.
conversationSeq
public long conversationSeqIndicates the sequence number of the message in the conversation.
orderKey
public long orderKeyThe larger the orderKey, the newer the message, and can be used for ordering messages.
localMessageID
public long localMessageIDSDK locally generated MessageID, developers do not need to pay attention to.
isUserInserted
public boolean isUserInsertedDetail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].
Default: false.
receiptStatus
public ZIMMessageReceiptStatus receiptStatusDescribe the receipt status of the message
Business scenario: used to determine the status of the current message in the receipt message
extendedData
public String extendedDatamessage 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
public String localExtendedDataThe 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
public boolean isBroadcastMessageWhether the message is pushed by all employees.
- Required: Internal assignment.
isMentionAll
private boolean isMentionAllWhether 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
private ArrayList\<String> mentionedUserIDsWhether 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
public long messageSeqIndicates the sequence number of the message in the conversation.
rootRepliedCount
public int rootRepliedCountThe number of reply messages corresponding to the root message of the reply message tree.
repliedInfo
public ZIMMessageRepliedInfo repliedInfoInformation about the source message referenced by the reply message.
editorUserID
public String editorUserIDThe latest editor's userID for this message.
editedTime
public long editedTimeThe latest editing timestamp for this message.
isGroupTargetedMessage
public boolean isGroupTargetedMessageIdentify if this message is group targeted message.
pinnedUserID
public String pinnedUserIDThe last user who pinned this message.
- Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].
pinnedTime
public long pinnedTimeThe 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
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
public String fileDownloadUrlDetail 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
public String fileNameDetail 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
public long fileSizeDetail 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
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
public String wordingAdd a friend postscript.
friendAlias
public String friendAliasAlias of friend.
friendAttributes
public HashMap<String, String> friendAttributesFriend 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
public String friendAliasfriend alias.
friendAttributes
public HashMap<String, String> friendAttributesfriend attributes.
pushConfig
ZIMFriendApplicationInfo
Friend application information.
Details
Detailed description: Friend application information.
Declared in entity/ZIMFriendApplicationInfo.java
Properties
applyUser
public ZIMUserInfo applyUserDetail description: If you are the applicant, here is the respondent information; if you are the respondent, here is the applicant information;
wording
public String wordingThe wording of friend application information.
createTime
public int createTimeFriend add time.
updateTime
public int updateTimeFriend application status update time.
type
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
public int countTotal number of current queries.
nextFlag
public int nextFlagThe 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
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
public String wordingAdd a friend postscript.
friendAlias
public String friendAliasAlias of friend.
friendAttributes
public HashMap<String, String> friendAttributesFriend attributes. Up to 5 can be set. The key of the attribute can only be selected from k0 to k4.
pushConfig
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
ZIMFriendInfo
Friend information.
Details
Detailed description: Friend information.
Declared in entity/ZIMFriendInfo.java
Properties
userID
public String userIDDetail description: UserID of the operator.
friendAlias
public String friendAliasThe alias of friend.
friendAttributes
public HashMap<String, String> friendAttributesFriend attributes. Up to 5 can be set. The key of the attribute can only be selected from k0 to k4.
createTime
public int createTimeFriend add time.
userName
public String userNameUser 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
public String userAvatarUrlThe 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
public String userExtendedDataExtended 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
public int countTotal number of current queries.
nextFlag
public int nextFlagThe 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
ZIMFriendRelationInfo
Friend relationship information.
Details
Detailed description: Friend relationship information.
Declared in entity/ZIMFriendRelationInfo.java
Properties
userID
public String userIDuser ID.
type
ZIMFriendsSearchConfig
Search local friend configuration.
Details
Search local friend configuration.
Declared in entity/ZIMCallInviteConfig.java
Properties
keywords
public ArrayList\<String> keywordsSearch keyword list.
isAlsoMatchFriendAlias
public boolean isAlsoMatchFriendAliasWhether to match friend aliases.
count
public int countCurrent total number of searches.
nextFlag
public int nextFlagThe 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
notificationStatus
public ZIMGroupMessageNotificationStatus notificationStatusgroup message notification status.
groupAlias
public String groupAliasthe 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
public HashMap<String, String> groupAttributesGroup properties, up to 10 can be configured..
- Required: Optional.
groupNotice
public String groupNoticegroup notice.
- Required: Optional.
maxMemberCount
public int maxMemberCountThe 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
public ZIMGroupJoinMode joinModeVerification mode for joining the group.
- Required: Optional.
- Caution: Supports version 2.15 and above.
inviteMode
public ZIMGroupInviteMode inviteModeVerification mode for invite to the group.
- Required: Optional.
- Caution: Supports version 2.15 and above.
beInviteMode
public ZIMGroupBeInviteMode beInviteModeVerification 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
public ZIMUserInfo applyUserDetail description: The applicant is the applicant when applying to join, the invitee when applying to invite, and the inviter when applying by invitation.
wording
public String wordingThe wording of group application information.
createTime
public long createTimeGroup application create time.
updateTime
public long updateTimeGroup application status update time.
type
state
groupInfo
operatedUser
public ZIMGroupMemberSimpleInfo operatedUserThe 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
public int countcount. It is advised to be no more than 30.
- Required: Yes.
nextFlag
public int nextFlagnextFlag.
- 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
groupAttributes
public HashMap<String, String> groupAttributesgroup properties.
ZIMGroupConversation
Group session object, extend from ZIMGroupConversation.
Details
Group session object, extend from ZIMGroupConversation.
Declared in ZIMGroupConversation.java
Properties
mutedExpiredTime
public long long mutedExpiredTimeThe expiration date of the group gag.
isDisabled
public boolean isDisabledWhether the group session is unavailable.
conversationID
public String conversationIDconversationID.
conversationName
public String conversationNameconversationName is the same as the groupName/userName value corresponding to the session.
type
unreadMessageCount
public int unreadMessageCountSession unread.
lastMessage
orderKey
public long orderKeyOrderKey is used to describe the order of messages in the session. The larger orderKey is, the newer it is.
notificationStatus
public ZIMConversationNotificationStatus notificationStatussession notification status.
conversationAvatarUrl
public String conversationAvatarUrlDetail 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
public boolean isPinnedWhether the conversation is pinned.
mentionedInfoList
public ArrayList<ZIMMessageMentionedInfo> mentionedInfoListWhen 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
public String conversationAliasAfter 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
public ArrayList\<Integer> marksDescribes all the existing marks for the conversation.
- Use cases: The business layer can group logic, etc., according to different conversations with different marks.
draft
public String draftConversation 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
enterTime
public long enterTimeThe timestamp of the server when joining the group.
operatedUser
public ZIMGroupMemberSimpleInfo operatedUserThe 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
groupAttributes
public HashMap<String, String> groupAttributesgroup properties.
groupNotice
public String groupNoticeGroup of announcement.
notificationStatus
public ZIMGroupMessageNotificationStatus notificationStatusgroup message notification status.
mutedInfo
createTime
public long createTimeThe timestamp of the server when the group was created.
- Caution: Supports version 2.15 and above.
maxMemberCount
public int maxMemberCountThe maximum number of group members.
- Caution: Supports version 2.15 and above.
verifyInfo
public ZIMGroupVerifyInfo verifyInfoVerification mode for joining the group.
- Caution: Supports version 2.15 and above.
groupAlias
public String groupAliasthe 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
public String groupIDgroupID.
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
public String groupNameGroup name.
- Required: Optional.
Value: A string of up to 50 bytes.
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
ZIMGroupInviteApplicationRejectConfig
The behavior property of the reject group invite application setting.
Declared in entity/ZIMGroupInviteApplicationRejectConfig.java
Properties
pushConfig
ZIMGroupInviteApplicationSendConfig
The behavior property of the send group invite application setting.
Declared in entity/ZIMGroupInviteApplicationSendConfig.java
Properties
wording
public String wordingPostscript to the application operation.
pushConfig
ZIMGroupJoinApplicationAcceptConfig
The behavior property of the accept group join application setting.
Declared in entity/ZIMGroupJoinApplicationAcceptConfig.java
Properties
pushConfig
ZIMGroupJoinApplicationRejectConfig
The behavior property of the reject group join application setting.
Declared in entity/ZIMGroupJoinApplicationRejectConfig.java
Properties
pushConfig
ZIMGroupJoinApplicationSendConfig
The behavior property of the send group join application setting.
Declared in entity/ZIMGroupJoinApplicationSendConfig.java
Properties
wording
public String wordingPostscript to the application operation.
pushConfig
ZIMGroupMemberInfo
Group member information.
Details
Group member information.
Declared in entity/ZIMGroupMemberInfo.java
Properties
memberNickname
public String memberNicknameGroup member nickname.
memberRole
public int memberRolegroup role.
memberAvatarUrl
public String memberAvatarUrlDetailed description: group member avatar URL.
User Limit: the maximum number of characters is 500 bytes. There is no limit on special characters.
muteExpiredTime
public long muteExpiredTimeGroup member's mute expiration time. When it's 0, it means no mute; when it's -1, it means permanent mute.
groupEnterInfo
public ZIMGroupEnterInfo groupEnterInfoInformation about group members when they join the group.
- Caution: Supports version 2.15 and above.
userID
public String userIDUser 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
public String userNameUser 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
public String userAvatarUrlThe 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
public String userExtendedDataExtended 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
public int durationGroup 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
public int countcount.
- Required: Required.
nextFlag
public long nextFlagnextFlag.
- 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
public int countcount. Quantity, upper limit is 100, over 100 will be treated as 100.
- Required: Required.
nextFlag
public int nextFlagnextFlag.
- 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
public int countcount.
- Required: Required.
nextFlag
public int nextFlagThe 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
public ArrayList\<String> keywordsSearch 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
public boolean isAlsoMatchGroupMemberNicknameWhether 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
public String memberNicknameGroup member nickname.
memberRole
public int memberRolegroup role.
userID
public String userIDUser 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
public String userNameUser 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
public String userAvatarUrlThe 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
public String userExtendedDataExtended 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
public int count- Required: Required.
nextFlag
public int nextFlagDetailed 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
duration
public int durationGroup 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
public ArrayList<Integer> rolesGroup 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
expiredTime
public long expiredTimeGroup mute expiration time, measured in seconds. When it's 0, there is no mute; when it's -1, it means permanent mute.
roles
public ArrayList\<Integer> rolesDetail 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
public ZIMGroupMemberInfo operatedUserInfoGroup member information.
userID
public String userIDThe operator's user ID.
userName
public String userNameThe operator's username.
memberNickname
public String memberNicknameThe operator's group member nickname.
memberRole
public int memberRoleThe operator's group member role.
ZIMGroupSearchConfig
Group search configuration.
Details
Group search configuration.
Declared in entity/ZIMGroupSearchConfig.java
Properties
count
public int countcount.
- Required: Required.
nextFlag
public int nextFlagThe 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
public ArrayList\<String> keywordsSearch 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
public boolean isAlsoMatchGroupMemberNicknameWhether the search scope includes group member user nicknames. Default is false.
- Required: No.
- Default value: false
isAlsoMatchGroupMemberUserName
public boolean isAlsoMatchGroupMemberUserNameWhether 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
userList
ZIMGroupVerifyInfo
Verification mode for joining the group.
Declared in entity/ZIMGroupVerifyInfo.java
Properties
joinMode
inviteMode
beInviteMode
public ZIMGroupBeInviteMode beInviteModeVerification 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
public String thumbnailLocalPathDetailed 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
public String thumbnailDownloadUrlDetail 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
public String largeImageLocalPathDetailed 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
public String largeImageDownloadUrlDetail 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
public int originalImageWidthOriginal 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
public int originalImageHeightOriginal 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
public int largeImageWidthLarge 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
public int largeImageHeightLarge 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
public int thumbnailWidthThumbnail 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
public int thumbnailHeightThumbnail 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
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
public String fileDownloadUrlDetail 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
public String fileUIDDetail 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
public String fileNameDetail 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
public long fileSizeDetail 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
messageID
public long messageIDThe 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
public long timestampIdentifies 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
public String senderUserIDDisplays the userID of the sender of this message.
conversationID
public String conversationIDConversation ID. Ids of the same conversation type are unique.
direction
public ZIMMessageDirection directionUsed to describe whether a message is sent or received.
sentStatus
conversationType
public ZIMConversationType conversationTypeThe type of conversation to which the message belongs.
conversationSeq
public long conversationSeqIndicates the sequence number of the message in the conversation.
orderKey
public long orderKeyThe larger the orderKey, the newer the message, and can be used for ordering messages.
localMessageID
public long localMessageIDSDK locally generated MessageID, developers do not need to pay attention to.
isUserInserted
public boolean isUserInsertedDetail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].
Default: false.
receiptStatus
public ZIMMessageReceiptStatus receiptStatusDescribe the receipt status of the message
Business scenario: used to determine the status of the current message in the receipt message
extendedData
public String extendedDatamessage 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
public String localExtendedDataThe 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
public boolean isBroadcastMessageWhether the message is pushed by all employees.
- Required: Internal assignment.
isMentionAll
private boolean isMentionAllWhether 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
private ArrayList\<String> mentionedUserIDsWhether 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
public long messageSeqIndicates the sequence number of the message in the conversation.
rootRepliedCount
public int rootRepliedCountThe number of reply messages corresponding to the root message of the reply message tree.
repliedInfo
public ZIMMessageRepliedInfo repliedInfoInformation about the source message referenced by the reply message.
editorUserID
public String editorUserIDThe latest editor's userID for this message.
editedTime
public long editedTimeThe latest editing timestamp for this message.
isGroupTargetedMessage
public boolean isGroupTargetedMessageIdentify if this message is group targeted message.
pinnedUserID
public String pinnedUserIDThe last user who pinned this message.
- Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].
pinnedTime
public long pinnedTimeThe 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
public String thumbnailLocalPathDetailed 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
public String thumbnailDownloadUrlDetail 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
public String largeImageLocalPathDetailed 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
public String largeImageDownloadUrlDetail 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
public int originalImageWidthOriginal 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
public int originalImageHeightOriginal 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
public int largeImageWidthLarge 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
public int largeImageHeightLarge 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
public int thumbnailWidthThumbnail 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
public int thumbnailHeightThumbnail 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
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
public String fileDownloadUrlDetail 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
public String fileNameDetail 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
public long fileSizeDetail 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
ZIMLogConfig
Log configuration
Details
Configure the storage path of log files and the maximum log file size.
Declared in entity/ZIMLogConfig.java
Properties
logPath
public String logPathThe storage path of the log files. Refer to the official website document for the default path.
logSize
public long logSizeThe 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
public String userNameUser 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
public String tokenToken carried during login.
- Use cases: Only pass this parameter in the scenario where token is used for authentication.
- Required: No.
isOfflineLogin
public boolean isOfflineLoginWhether it is offline login.
- Use cases: Set this parameter to true when performing offline login.
- Required: No.
- Default value: false.
customStatus
public String customStatusUser-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
public int messageInfoIndexDetailed 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
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
public String fileDownloadUrlDetail 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
public String fileUIDDetail 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
public String fileNameDetail 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
public long fileSizeDetail 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
messageID
public long messageIDThe 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
public long timestampIdentifies 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
public String senderUserIDDisplays the userID of the sender of this message.
conversationID
public String conversationIDConversation ID. Ids of the same conversation type are unique.
direction
public ZIMMessageDirection directionUsed to describe whether a message is sent or received.
sentStatus
conversationType
public ZIMConversationType conversationTypeThe type of conversation to which the message belongs.
conversationSeq
public long conversationSeqIndicates the sequence number of the message in the conversation.
orderKey
public long orderKeyThe larger the orderKey, the newer the message, and can be used for ordering messages.
localMessageID
public long localMessageIDSDK locally generated MessageID, developers do not need to pay attention to.
isUserInserted
public boolean isUserInsertedDetail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].
Default: false.
receiptStatus
public ZIMMessageReceiptStatus receiptStatusDescribe the receipt status of the message
Business scenario: used to determine the status of the current message in the receipt message
extendedData
public String extendedDatamessage 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
public String localExtendedDataThe 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
public boolean isBroadcastMessageWhether the message is pushed by all employees.
- Required: Internal assignment.
isMentionAll
private boolean isMentionAllWhether 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
private ArrayList\<String> mentionedUserIDsWhether 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
public long messageSeqIndicates the sequence number of the message in the conversation.
rootRepliedCount
public int rootRepliedCountThe number of reply messages corresponding to the root message of the reply message tree.
repliedInfo
public ZIMMessageRepliedInfo repliedInfoInformation about the source message referenced by the reply message.
editorUserID
public String editorUserIDThe latest editor's userID for this message.
editedTime
public long editedTimeThe latest editing timestamp for this message.
isGroupTargetedMessage
public boolean isGroupTargetedMessageIdentify if this message is group targeted message.
pinnedUserID
public String pinnedUserIDThe last user who pinned this message.
- Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].
pinnedTime
public long pinnedTimeThe 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
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
public String fileDownloadUrlDetail 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
public String fileNameDetail 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
public long fileSizeDetail 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
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
messageID
public long messageIDThe 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
public long timestampIdentifies 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
public String senderUserIDDisplays the userID of the sender of this message.
conversationID
public String conversationIDConversation ID. Ids of the same conversation type are unique.
direction
public ZIMMessageDirection directionUsed to describe whether a message is sent or received.
sentStatus
conversationType
public ZIMConversationType conversationTypeThe type of conversation to which the message belongs.
conversationSeq
public long conversationSeqIndicates the sequence number of the message in the conversation.
orderKey
public long orderKeyThe larger the orderKey, the newer the message, and can be used for ordering messages.
localMessageID
public long localMessageIDSDK locally generated MessageID, developers do not need to pay attention to.
isUserInserted
public boolean isUserInsertedDetail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].
Default: false.
receiptStatus
public ZIMMessageReceiptStatus receiptStatusDescribe the receipt status of the message
Business scenario: used to determine the status of the current message in the receipt message
extendedData
public String extendedDatamessage 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
public String localExtendedDataThe 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
public boolean isBroadcastMessageWhether the message is pushed by all employees.
- Required: Internal assignment.
isMentionAll
private boolean isMentionAllWhether 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
private ArrayList\<String> mentionedUserIDsWhether 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
public long messageSeqIndicates the sequence number of the message in the conversation.
rootRepliedCount
public int rootRepliedCountThe number of reply messages corresponding to the root message of the reply message tree.
repliedInfo
public ZIMMessageRepliedInfo repliedInfoInformation about the source message referenced by the reply message.
editorUserID
public String editorUserIDThe latest editor's userID for this message.
editedTime
public long editedTimeThe latest editing timestamp for this message.
isGroupTargetedMessage
public boolean isGroupTargetedMessageIdentify if this message is group targeted message.
pinnedUserID
public String pinnedUserIDThe last user who pinned this message.
- Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].
pinnedTime
public long pinnedTimeThe 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
public boolean isAlsoDeleteServerMessageWhether to remove flags for server messages.
- Required: not required.
- Default value: false.
ZIMMessageDeletedInfo
Deleted message information.
Declared in entity/ZIMMessageDeletedInfo.java
Properties
conversationID
public String conversationIDConversation ID.
conversationType
messageList
isDeleteConversationAllMessage
public boolean isDeleteConversationAllMessageWhether to delete all current messages in the conversation.
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
ZIMMessageMentionedInfo
message mention information.
Details
message mention information.
Declared in entity/ZIMMessageMentionedInfo.java
Properties
messageID
public long messageIDMessage ID, used to match the notification information to which message it belongs to
Required or not: Developers do not need to fill in.'‘’
fromUserID
public String fromUserIDFrom which user.
- Required: Developers do not need to fill in."
type
public ZIMMessageMentionedType typeType of notification, used to distinguish between reminding oneself and reminding everyone.
- Required: Developers do not need to fill in.
messageSeq
public long messageSeqmessage 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
message
ZIMMessageQueryConfig
Example Query message configuration.
Details
Example Query the configurations of messages.
Declared in entity/ZIMConversationDeleteConfig.java
Properties
nextMessage
public ZIMMessage nextMessageQuery the anchor point of the message.
- Required: This parameter is not required for the first query but is required for subsequent paging queries.
count
public int countNumber of query messages.
- Required: Yes.
reverse
public Boolean reverseIndicates 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
public String conversationIDconversationID.
conversationType
messageID
public long messageIDDetail description: reaction message ID.
reactionType
public String reactionTypeType of reaction, defined by you, with a maximum length of 32 bytes.
isSelfIncluded
public boolean isSelfIncludedThe reaciton users if included myself.
totalCount
public int totalCountThe reaction users number.
userList
ZIMMessageReactionUserInfo
reaction user information.
Details
Detail description: A class describing reaction user.
Declared in entity/ZIMMessageReactionUserInfo.java
Properties
userID
public String userIDuser 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
public long nextFlagThe 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
public int countHow 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
public String reactionTypereaction type, defined by you.
ZIMMessageReceiptInfo
receipt information.
Details
Detailed description: receipt information.
Declared in entity/ZIMMessageReceiptInfo.java
Properties
status
messageID
public long messageIDMessage ID.
Business scenario: Developers can match the loaded message list according to this ID.
Is it required: No, SDK fills in.
conversationID
public String conversationIDSession ID.
Business scenario: Receipt information used to indicate which session this belongs to.
Is it required: No, SDK fills in.
conversationType
public ZIMConversationType conversationTypeSession type.
Business scenario: Indicates the type of the session.
Is it required: If no, the SDK is filled.
readMemberCount
public int readMemberCountDetailed 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
public int unreadMemberCountDetailed 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
public boolean isSelfOperatedIn 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
public long readTimeServer-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
public boolean isOfflineMessageWhether 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
sentTime
public long sentTimeThe send timestamp of the source message (in UTC).
senderUserID
public String senderUserIDThe sender user ID of the source message.
messageSeq
public long messageSeqThe seq of the source message.
messageInfo
messageID
public long messageIDThe ID of the source message.
ZIMMessageRepliedListQueryConfig
Configuration for querying reply message list.
Declared in entity/ZIMMessageRepliedListQueryConfig.java
Properties
nextFlag
public long nextFlagThe 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
public int countThe 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
public String revokeExtendedDatarevoking additional messages.
- Required: Not required.
pushConfig
public ZIMPushConfig pushConfigConfigures 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
public String conversationIDConversation ID.
conversationType
messageID
public long messageIDroot message id.
count
public int countThe 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
sentTime
public long sentTimeThe send timestamp of the root message.
senderUserID
public String senderUserIDThe sender user ID of the root message.
repliedCount
public int repliedCountThe number of replies for the reply message tree.
message
ZIMMessageSearchConfig
Message search configuration.
Details
Message search configuration.
Declared in entity/ZIMMessageSearchConfig.java
Properties
nextMessage
public ZIMMessage nextMessagePaging 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
public int countcount It is recommended to keep the number of items less than 20 to reduce performance overhead.
- Required: Required.
order
public ZIMMessageOrder orderWhen 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
public ArrayList\<String> keywordsSearch 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
public ArrayList<ZIMMessageType> messageTypesMessage types, can be used to specify message types. Support passing in multiple types.
subMessageTypes
public ArrayList\<Integer> subMessageTypesThe subtypes of custom messages have a value range of [0,200]. Developers can use this range to search for specific custom types.
senderUserIDs
public ArrayList\<String> senderUserIDsThe 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
public long startTimeThe starting point of the search, in milliseconds, with a default value of 0. The format is UTC timestamp.
endTime
public long endTimeThe 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
public ZIMPushConfig pushConfigConfigures the offline push function, If Android or iOS platform is integrated, it is strongly recommended to configure this.
- Required: Not mandatory.
priority
hasReceipt
public boolean hasReceipt- Required: not required.
- Default value: false.
isNotifyMentionedUsers
public boolean isNotifyMentionedUsers- Required: not required.
- Default value: true.
isRetrySend
public boolean isRetrySendWhether to resend the failed message.
- Required: No.
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
status
reason
public String reasonThis 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
public ArrayList<ZIMMessageLiteInfo> messageInfoListIt 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
messageID
public long messageIDThe 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
public long timestampIdentifies 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
public String senderUserIDDisplays the userID of the sender of this message.
conversationID
public String conversationIDConversation ID. Ids of the same conversation type are unique.
direction
public ZIMMessageDirection directionUsed to describe whether a message is sent or received.
sentStatus
conversationType
public ZIMConversationType conversationTypeThe type of conversation to which the message belongs.
conversationSeq
public long conversationSeqIndicates the sequence number of the message in the conversation.
orderKey
public long orderKeyThe larger the orderKey, the newer the message, and can be used for ordering messages.
localMessageID
public long localMessageIDSDK locally generated MessageID, developers do not need to pay attention to.
isUserInserted
public boolean isUserInsertedDetail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].
Default: false.
receiptStatus
public ZIMMessageReceiptStatus receiptStatusDescribe the receipt status of the message
Business scenario: used to determine the status of the current message in the receipt message
extendedData
public String extendedDatamessage 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
public String localExtendedDataThe 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
public boolean isBroadcastMessageWhether the message is pushed by all employees.
- Required: Internal assignment.
isMentionAll
private boolean isMentionAllWhether 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
private ArrayList\<String> mentionedUserIDsWhether 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
public long messageSeqIndicates the sequence number of the message in the conversation.
rootRepliedCount
public int rootRepliedCountThe number of reply messages corresponding to the root message of the reply message tree.
repliedInfo
public ZIMMessageRepliedInfo repliedInfoInformation about the source message referenced by the reply message.
editorUserID
public String editorUserIDThe latest editor's userID for this message.
editedTime
public long editedTimeThe latest editing timestamp for this message.
isGroupTargetedMessage
public boolean isGroupTargetedMessageIdentify if this message is group targeted message.
pinnedUserID
public String pinnedUserIDThe last user who pinned this message.
- Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].
pinnedTime
public long pinnedTimeThe 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
public ArrayList<ZIMMessageLiteInfo> messageInfoListDetail description: A list of elements that compose the message.
type
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
public String templateIDThe 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
public String titleParametersjson string, OPPO push title template filling parameters. For example, the private message template ID title template is: Welcome to , Welcome you. The content of this parameter is :" {"city":" Beijing}".
contentParameters
public String contentParametersjson string, OPPO push content template filling parameter. Example: The content template corresponding to the private message template ID is: Welcome to . 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
public String titleUsed to set the push title.
- Required: Not required.
content
public String contentUsed to set offline push content.
- Required: Not required.
payload
public String payloadThis parameter is used to set the pass-through field of offline push.
- Required: Not required.
resourcesID
public String resourcesIDA 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
public boolean enableBadgePush whether to carry corner information switch.
badgeIncrement
public int badgeIncrementThe incremental index number carried by the push.
voIPConfig
public ZIMVoIPConfig voIPConfigIf 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
public ZIMOfflinePushPrivateMessageTemplate privateMessageTemplateIf 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
revokeStatus
revokeTimestamp
public int revokeTimestampDetail description: revoke timestamp.
operatedUserID
public String operatedUserIDDetail description: operated user ID.
revokeExtendedData
public String revokeExtendedDataDetail description: revoke extended data.
originalMessageType
originalTextMessageContent
public String originalTextMessageContentoriginal text message content
type
messageID
public long messageIDThe 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
public long timestampIdentifies 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
public String senderUserIDDisplays the userID of the sender of this message.
conversationID
public String conversationIDConversation ID. Ids of the same conversation type are unique.
direction
public ZIMMessageDirection directionUsed to describe whether a message is sent or received.
sentStatus
conversationType
public ZIMConversationType conversationTypeThe type of conversation to which the message belongs.
conversationSeq
public long conversationSeqIndicates the sequence number of the message in the conversation.
orderKey
public long orderKeyThe larger the orderKey, the newer the message, and can be used for ordering messages.
localMessageID
public long localMessageIDSDK locally generated MessageID, developers do not need to pay attention to.
isUserInserted
public boolean isUserInsertedDetail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].
Default: false.
receiptStatus
public ZIMMessageReceiptStatus receiptStatusDescribe the receipt status of the message
Business scenario: used to determine the status of the current message in the receipt message
extendedData
public String extendedDatamessage 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
public String localExtendedDataThe 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
public boolean isBroadcastMessageWhether the message is pushed by all employees.
- Required: Internal assignment.
isMentionAll
private boolean isMentionAllWhether 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
private ArrayList\<String> mentionedUserIDsWhether 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
public long messageSeqIndicates the sequence number of the message in the conversation.
rootRepliedCount
public int rootRepliedCountThe number of reply messages corresponding to the root message of the reply message tree.
repliedInfo
public ZIMMessageRepliedInfo repliedInfoInformation about the source message referenced by the reply message.
editorUserID
public String editorUserIDThe latest editor's userID for this message.
editedTime
public long editedTimeThe latest editing timestamp for this message.
isGroupTargetedMessage
public boolean isGroupTargetedMessageIdentify if this message is group targeted message.
pinnedUserID
public String pinnedUserIDThe last user who pinned this message.
- Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].
pinnedTime
public long pinnedTimeThe 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
ZIMRoomAdvancedConfig
Room advanced config.
Details
Room‘s advanced config.
Declared in entity/ZIMRoomAdvancedConfig.java
Properties
roomAttributes
public public HashMap<String, String> roomAttributesRoom attributes of a room.
roomDestroyDelayTime
public int roomDestroyDelayTimeRoom 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
public boolean isDeleteAfterOwnerLeftRoom attributes are automatically deleted after the owner leaves the room.
- Required: Not required.
isForce
public boolean isForceWhether the operation is mandatory, that is, the property of the room whose owner is another user can be modified.
- Required: Not required.
isUpdateOwner
public boolean isUpdateOwnerWhether 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
public boolean isForceWhether 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
public boolean isDeleteAfterOwnerLeftRoom attributes are automatically deleted after the owner leaves the room.
- Required: Not required.
isForce
public boolean isForceWhether the operation is mandatory, that is, the property of the room whose owner is another user can be modified.
- Required: Not required.
isUpdateOwner
public boolean isUpdateOwnerWhether 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
public ZIMRoomAttributesUpdateAction actionBehavioral information of room attribute change notification.
roomAttributes
public HashMap<String, String> roomAttributesRoom 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
ZIMRoomInfo
Room information object.
Details
Identifies a unique room.
Declared in entity/ZIMRoomInfo.java
Properties
roomID
public String roomIDRoom ID. a string with a maximum length of 128 bytes. It is customized by the developer and supports only digits, English characters, , and '!', '#', '$', '%', '&', '(', ')', '+', '-', ':', ';', '<', '=', '.', '>', '?', '@', '[', ']', '^', '_', '{', '}', '|', ''.
roomName
public String roomNameRoom 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
public String userIDDetail description: User ID.
attributes
public HashMap<String, String> attributesDetailed 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
public ZIMRoomMemberAttributesInfo attributesInfoDetailed description: room user attribute information.
errorKeys
public ArrayList<String> errorKeysDetail 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
public String nextFlagDetail 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
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
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
public ZIMRoomMemberAttributesInfo attributesInfoDetailed description: room user attributes.
ZIMRoomMemberInfo
Room user information.
Details
Detail description: A class describing room user.
Declared in entity/ZIMRoomMemberInfo.java
Properties
userID
public String userIDUser 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
public String userNameUser 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
public String userAvatarUrlThe 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
public String userExtendedDataExtended 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
public String nextFlagThe 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
public int countHow 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
public String userIDDetail 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
public ZIMUserRule userRuleRules for the current user, setting information.
userFullInfo
ZIMSelfUserRule
User's own rule class.
Declared in entity/ZIMSelfUserRule.java
Properties
offlinePushRule
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
public ArrayList\<String\> userIDsPass 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
public String messageThe content of the text message.
type
messageID
public long messageIDThe 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
public long timestampIdentifies 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
public String senderUserIDDisplays the userID of the sender of this message.
conversationID
public String conversationIDConversation ID. Ids of the same conversation type are unique.
direction
public ZIMMessageDirection directionUsed to describe whether a message is sent or received.
sentStatus
conversationType
public ZIMConversationType conversationTypeThe type of conversation to which the message belongs.
conversationSeq
public long conversationSeqIndicates the sequence number of the message in the conversation.
orderKey
public long orderKeyThe larger the orderKey, the newer the message, and can be used for ordering messages.
localMessageID
public long localMessageIDSDK locally generated MessageID, developers do not need to pay attention to.
isUserInserted
public boolean isUserInsertedDetail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].
Default: false.
receiptStatus
public ZIMMessageReceiptStatus receiptStatusDescribe the receipt status of the message
Business scenario: used to determine the status of the current message in the receipt message
extendedData
public String extendedDatamessage 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
public String localExtendedDataThe 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
public boolean isBroadcastMessageWhether the message is pushed by all employees.
- Required: Internal assignment.
isMentionAll
private boolean isMentionAllWhether 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
private ArrayList\<String> mentionedUserIDsWhether 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
public long messageSeqIndicates the sequence number of the message in the conversation.
rootRepliedCount
public int rootRepliedCountThe number of reply messages corresponding to the root message of the reply message tree.
repliedInfo
public ZIMMessageRepliedInfo repliedInfoInformation about the source message referenced by the reply message.
editorUserID
public String editorUserIDThe latest editor's userID for this message.
editedTime
public long editedTimeThe latest editing timestamp for this message.
isGroupTargetedMessage
public boolean isGroupTargetedMessageIdentify if this message is group targeted message.
pinnedUserID
public String pinnedUserIDThe last user who pinned this message.
- Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].
pinnedTime
public long pinnedTimeThe last timestamp when pinned this message.
- Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].
Methods
ZIMTextMessage
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
public String messageThe content of the text message.
type
Methods
ZIMTextMessageLiteInfo
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
operatedUser
public ZIMUserInfo operatedUserThe initiator of the action corresponding to the tips message.
targetUserList
public ArrayList<ZIMUserInfo> targetUserListThe target user list for the operation corresponding to the tips message.
changeInfo
public ZIMTipsMessageChangeInfo changeInfoAdditional information for the operation corresponding to the tips message.
type
messageID
public long messageIDThe 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
public long timestampIdentifies 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
public String senderUserIDDisplays the userID of the sender of this message.
conversationID
public String conversationIDConversation ID. Ids of the same conversation type are unique.
direction
public ZIMMessageDirection directionUsed to describe whether a message is sent or received.
sentStatus
conversationType
public ZIMConversationType conversationTypeThe type of conversation to which the message belongs.
conversationSeq
public long conversationSeqIndicates the sequence number of the message in the conversation.
orderKey
public long orderKeyThe larger the orderKey, the newer the message, and can be used for ordering messages.
localMessageID
public long localMessageIDSDK locally generated MessageID, developers do not need to pay attention to.
isUserInserted
public boolean isUserInsertedDetail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].
Default: false.
receiptStatus
public ZIMMessageReceiptStatus receiptStatusDescribe the receipt status of the message
Business scenario: used to determine the status of the current message in the receipt message
extendedData
public String extendedDatamessage 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
public String localExtendedDataThe 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
public boolean isBroadcastMessageWhether the message is pushed by all employees.
- Required: Internal assignment.
isMentionAll
private boolean isMentionAllWhether 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
private ArrayList\<String> mentionedUserIDsWhether 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
public long messageSeqIndicates the sequence number of the message in the conversation.
rootRepliedCount
public int rootRepliedCountThe number of reply messages corresponding to the root message of the reply message tree.
repliedInfo
public ZIMMessageRepliedInfo repliedInfoInformation about the source message referenced by the reply message.
editorUserID
public String editorUserIDThe latest editor's userID for this message.
editedTime
public long editedTimeThe latest editing timestamp for this message.
isGroupTargetedMessage
public boolean isGroupTargetedMessageIdentify if this message is group targeted message.
pinnedUserID
public String pinnedUserIDThe last user who pinned this message.
- Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].
pinnedTime
public long pinnedTimeThe 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
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
public int groupDataFlagIf 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
public String groupNameIf the group name is changed, the changed value will be displayed here.
groupNotice
public String groupNoticeIf the group notice is changed, the changed value will be displayed here.
groupAvatarUrl
public String groupAvatarUrlIf the group avatar url is changed, the changed value will be displayed here.
groupMutedInfo
public ZIMGroupMuteInfo groupMutedInfoIf the group mute info is changed, the changed value will be displayed here.
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
public int memberRoleIf a group member's role changes, the changed role will be displayed here.
muteExpiredTime
public long muteExpiredTimeIf the group member's muting expired time changes, the new muting expired time will be displayed here.
groupNewOwner
public ZIMGroupMemberSimpleInfo groupNewOwnerDisplays 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
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
public boolean isPinnedDescribes whether the current operation is a pin operation or an unpin operation.
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
userAvatarUrl
public String userAvatarUrl- Required: not required.
Use restrictions: The value is a maximum of 500 bytes and contains no special characters.
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
public String userIDUser 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
public String userNameUser 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
public String userAvatarUrlThe 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
public String userExtendedDataExtended 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
public List\<int> onlinePlatformsWith 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
public List\<int> notToReceiveOfflinePushPlatformsWith 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
public String userIDA unique identifier for a single user.
onlineStatus
public ZIMUserOnlineStatus onlineStatusEnumeration that represents the current online status of the user.
onlinePlatforms
public List\<Number> onlinePlatformsThe 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
public long lastUpdateTimeTimestamp when user onlineStatus or customStatus was last changed, whichever is the greater.
lastOnlineStatusUpdateTime
public long lastOnlineStatusUpdateTimeThe 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
public long lastCustomStatusUpdateTimeThe timestamp when User customStatus was last changed, which can be used to show when the custom status was last changed.
customStatus
public String customStatusUser-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
public int subscriptionDurationUsed 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
subscribeExpiredTime
public long subscribeExpiredTimeThe 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
public boolean isQueryFromServer- Required: not required.
Default: false.
ZIMVideoMessage
Video message object.
Declared in entity/ZIMVideoMessage.java
Properties
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
public String videoFirstFrameLocalPathDetailed 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
public String videoFirstFrameDownloadUrlDetail 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
public int videoFirstFrameWidthDetailed 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
public int videoFirstFrameHeightDetailed 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
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
public String fileDownloadUrlDetail 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
public String fileUIDDetail 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
public String fileNameDetail 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
public long fileSizeDetail 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
messageID
public long messageIDThe 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
public long timestampIdentifies 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
public String senderUserIDDisplays the userID of the sender of this message.
conversationID
public String conversationIDConversation ID. Ids of the same conversation type are unique.
direction
public ZIMMessageDirection directionUsed to describe whether a message is sent or received.
sentStatus
conversationType
public ZIMConversationType conversationTypeThe type of conversation to which the message belongs.
conversationSeq
public long conversationSeqIndicates the sequence number of the message in the conversation.
orderKey
public long orderKeyThe larger the orderKey, the newer the message, and can be used for ordering messages.
localMessageID
public long localMessageIDSDK locally generated MessageID, developers do not need to pay attention to.
isUserInserted
public boolean isUserInsertedDetail description: Describes whether the message is a message inserted by the developer through [insertMessageToLocalDB].
Default: false.
receiptStatus
public ZIMMessageReceiptStatus receiptStatusDescribe the receipt status of the message
Business scenario: used to determine the status of the current message in the receipt message
extendedData
public String extendedDatamessage 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
public String localExtendedDataThe 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
public boolean isBroadcastMessageWhether the message is pushed by all employees.
- Required: Internal assignment.
isMentionAll
private boolean isMentionAllWhether 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
private ArrayList\<String> mentionedUserIDsWhether 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
public long messageSeqIndicates the sequence number of the message in the conversation.
rootRepliedCount
public int rootRepliedCountThe number of reply messages corresponding to the root message of the reply message tree.
repliedInfo
public ZIMMessageRepliedInfo repliedInfoInformation about the source message referenced by the reply message.
editorUserID
public String editorUserIDThe latest editor's userID for this message.
editedTime
public long editedTimeThe latest editing timestamp for this message.
isGroupTargetedMessage
public boolean isGroupTargetedMessageIdentify if this message is group targeted message.
pinnedUserID
public String pinnedUserIDThe last user who pinned this message.
- Use cases: This parameter is only assigned in [queryPinnedMessageList] or [onMessagePinStatusChanged].
pinnedTime
public long pinnedTimeThe 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
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
public String videoFirstFrameLocalPathDetailed 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
public String videoFirstFrameDownloadUrlDetail 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
public int videoFirstFrameWidthDetailed 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
public int videoFirstFrameHeightDetailed 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
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
public String fileDownloadUrlDetail 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
public String fileNameDetail 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
public long fileSizeDetail 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
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
public ZIMCXHandleType iOSVoIPHandleTypeThe type of contact information for the VoIP caller, by default, is generic.
iOSVoIPHandleValue
public String iOSVoIPHandleValueThe 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
public boolean iOSVoIPHasVideoVideo 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
public boolean enableHWPushWhether to enable Huawei Boolean push.
enableMiPush
public boolean enableMiPushWhether to enable the Boolean value pushed by Xiaomi.
enableVivoPush
public boolean enableVivoPushWhether to enable the Boolean value pushed by vivo.
miAppID
public String miAppIDXiaomi pushes the required AppID.
miAppKey
public String miAppKeyXiaomi pushes the required AppKey.
oppoAppID
public String oppoAppIDoppo pushes the required AppID.
oppoAppSecret
public String oppoAppSecretOppo pushes the required AppSecret.
oppoAppKey
public String oppoAppKeyoppo pushes the required AppKey.
vivoAppID
public String vivoAppIDVivo pushes the desired AppID.
vivoAppKey
public String vivoAppKeyvivo pushes the required AppKey.
hwAppID
public String hwAppIDHuawei pushes the required AppID.
enableFCMPush
public boolean enableFCMPushwhether to enable Google Push Boolean
enableOppoPush
public boolean enableOppoPushWhether to enable the Boolean value pushed by oppo.
enableHwBadge
public boolean enableHwBadgeSet 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
private int apptypeUsed 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
public ZPNsConfig enableHWPush(String hwAppID)ZPNs.javaParameters
| Name | Type | Description |
|---|---|---|
| hwAppID | String | Detailed description: Huawei appID. |
Details
This parameter is used to enable Huawei Push.
Return
Returns the ZPNsConfig.
enableMiPush
public ZPNsConfig enableMiPush(String miAppID, String miAppKey)ZPNs.javaParameters
| Name | Type | Description |
|---|---|---|
| miAppID | String | Detailed description: Xiaomi AppID. |
| miAppKey | String | Detailed description: Xiaomi AppKey. |
Details
This parameter is used to enable Xiaomi Push.
Return
Returns the ZPNsConfig.
enableVivoPush
public ZPNsConfig enableVivoPush(String vivoAppID, String vivoAppKey)ZPNs.javaParameters
| Name | Type | Description |
|---|---|---|
| vivoAppID | String | Detailed description: VIVO AppID. |
| vivoAppKey | String | Detailed description: VIVO AppKey. |
Details
Used to enable Vivo Push.
Return
Returns the ZPNsConfig.
enableOppoPush
public ZPNsConfig enableOppoPush(String oppoAppID, String oppoAppKey, String oppoAppSecret)ZPNs.javaParameters
| Name | Type | Description |
|---|---|---|
| oppoAppID | String | Description: OPPO AppID. |
| oppoAppKey | String | Description: OPPO AppKey. |
| oppoAppSecret | String | Description: OPPO AppSecret. |
Details
Used to enable oppo Push.
Return
Returns the ZPNsConfig.
enableFCMPush
public ZPNsConfig enableFCMPush()ZPNs.javaUsed to enable Google FCM Push.
Returns the ZPNsConfig.
disableHWPush
public ZPNsConfig disableHWPush()ZPNs.javaDetailed description: used to close Huawei Push.
Returns the ZPNsConfig.
disableMiPush
public ZPNsConfig disableMiPush()ZPNs.javaDetailed description: used to close XiaoMi Push.
Return ZPNsConfig.
disableVivoPush
public ZPNsConfig disableVivoPush()ZPNs.javaDetailed description: used to close VIVO Push.
Return ZPNsConfig.
disableOppoPush
public ZPNsConfig disableOppoPush()ZPNs.javaDetailed description: used to close VIVO Push.
Return ZPNsConfig.
disableFCMPush
public ZPNsConfig disableFCMPush()ZPNs.javaDetailed description: used to close Google FCM Push.
Return ZPNsConfig.
setAppType
public void setAppType(int apptype)ZPNs.java| Name | Type | Description |
|---|---|---|
| apptype | int | Description: 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
public String titleMessage title, or notification title if it is a notification message.
content
public String contentMessage 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
pushSource
extras
public Object extrasEach platform passes the source object, need to determine the type conversion.
notifyId
public int notifyIdNotification 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
msg
public String msgSuccess and error messages returned by the request.
pushID
public String pushIDZPNs Push ID generated.
commandResult
public String commandResultThe parameter returned by the command.
extra
public Object extraEach platform passes the source object, need to determine the type conversion.
pushCmdType
public PushCmdType pushCmdTypePush command type.
