In-app Chat
On this page

Struct

2026-04-29
ZIMAppConfigZIMBarrageMessage
ZIMCacheConfigZIMCallingInvitationSentInfo
ZIMCallInvitationEndedInfoZIMCallInvitationTimeoutInfo
ZIMCallJoinSentInfoZIMCallQuitSentInfo
ZIMCallUserStateChangeInfoZIMCommandMessage
ZIMConversationZIMConversationChangeInfo
ZIMConversationDeleteConfigZIMConversationQueryConfig
ZIMConversationsAllDeletedInfoZIMCustomMessage
ZIMCustomMessageLiteInfoZIMError
ZIMErrorUserInfoZIMFileCacheInfo
ZIMFriendApplicationInfoZIMFriendInfo
ZIMFriendRelationInfoZIMGroupApplicationInfo
ZIMGroupConversationZIMGroupInviteApplicationAcceptConfig
ZIMGroupInviteApplicationRejectConfigZIMGroupInviteApplicationSendConfig
ZIMGroupJoinApplicationAcceptConfigZIMGroupJoinApplicationRejectConfig
ZIMGroupJoinApplicationSendConfigZIMLogConfig
ZIMMessageZIMMessageDeletedInfo
ZIMMessagePinConfigZIMMessageReaction
ZIMMessageReactionsChangedEventResultZIMMessageReactionSimpleInfo
ZIMMessageReactionUserChangeInfoZIMMessageReactionUserFullInfo
ZIMMessageReactionUserInfoZIMMessageReactionUserQueryConfig
ZIMMessageReceiptInfoZIMMessageRepliedInfo
ZIMMessageRepliedListQueryConfigZIMMessageRootRepliedCountInfo
ZIMMessageRootRepliedInfoZIMRoomFullInfo
ZIMRoomInfoZIMRoomMemberAttributesInfo
ZIMRoomMemberAttributesOperatedInfoZIMRoomMemberAttributesQueryConfig
ZIMRoomMemberAttributesSetConfigZIMRoomMemberAttributesUpdateInfo
ZIMRoomMemberInfoZIMRoomMemberQueryConfig
ZIMRoomOperatedInfoZIMSelfUserInfo
ZIMSelfUserRuleZIMTextMessage
ZIMTextMessageLiteInfoZIMUserFullInfo
ZIMUserInfoZIMUserOfflinePushRule
ZIMVideoMessageZIMVideoMessageLiteInfo
ZIMVoIPConfig

ZIMAppConfig

ZIM application configuration, including AppID and AppSign.

Declared in ZIMDefines.cs

Properties

appID

appID
public uint appID
  • Required: Required.

appSign

appSign
public string appSign
  • Required: Required.

ZIMBarrageMessage

Barrage message class.

Details

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

Declared in ZIMDefines.cs

Properties

message

message
public string message

The content of barrage message.

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

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

timestamp

timestamp
public ulong timestamp

Identifies the sending time of a message

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

message_length

message_length
public uint message_length

The length of the message. If the message type is text, it should be the length of the string.

senderUserID

senderUserID
public string senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public string conversationID

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

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public ulong conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

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

localMessageID

localMessageID
public long localMessageID

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

isUserInserted

isUserInserted
public bool isUserInserted

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

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

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

extendedData

extendedData
public string extendedData

message extension field

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

localExtendedData

localExtendedData
public string localExtendedData

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

isBroadcastMessage

isBroadcastMessage
public bool isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
public bool isMentionAll

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

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

mentionedUserIDs

mentionedUserIDs
public ArrayList<String> mentionedUserIDs

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

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

messageSeq

messageSeq
public ulong messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public uint rootRepliedCount

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

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public string editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public ulong editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public bool isGroupTargetedMessage

Identify if this message is group targeted message.

ZIMCacheConfig

Cache configuration

Details

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

Declared in ZIMDefines.cs

Properties

cachePath

cachePath
public string cachePath

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

ZIMCallInvitationEndedInfo

End the call operation information.

Details

End the call operation information.

Declared in ZIM.cs

Properties

caller

caller
public string caller

The calling party of the current call.

operatedUserID

operatedUserID
public string operatedUserID

End the call operator.

extendedData

extendedData
public string extendedData

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

mode

mode

The mode of the call invitation.

endTime

endTime
public long endTime

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

ZIMCallInvitationTimeoutInfo

Information class about timeout notifications.

Details

Information class about timeout notifications.

Declared in ZIMDefines.cs

Properties

mode

mode

Call invitation type.

ZIMCallJoinSentInfo

Result of join the call operation.

Details

Result of join the call operation.

Declared in ZIMDefines.cs

Properties

createTime

createTime
public long createTime

Timestamp of the time when the call invitation was created.

joinTime

joinTime
public long joinTime

Time stamp of the person join the call invitation.

extendedData

extendedData
public string extendedData

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

callUserList

callUserList
public List<ZIMCallUserInfo> callUserList

List of user information in the current call invitation.

ZIMCallQuitSentInfo

Result of quit the call operation.

Details

Result of quit the call operation.

Declared in ZIMDefines.cs

Properties

createTime

createTime
public long createTime

Timestamp of the time when the call invitation was created.

acceptTime

acceptTime
public long acceptTime

Time stamp of the person accepting the call invitation.

quitTime

quitTime
public long quitTime

The time stamp for me to exit the call.

ZIMCallUserStateChangeInfo

Call member status change information.

Details

Call member status change information.

Declared in ZIM.cs

Properties

callUserList

callUserList
public List<ZIMCallUserInfo> callUserList

List of call members whose status changes.

ZIMCallingInvitationSentInfo

Information about callingInvite

Details

Information about callingInvite

Declared in ZIMDefines.cs

Properties

errorUserList

errorUserList
public List<ZIMErrorUserInfo> errorUserList

Error user list.

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 ZIMDefines.cs

Properties

message

message
public char * message

The content of the custom message.

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

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

timestamp

timestamp
public ulong timestamp

Identifies the sending time of a message

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

message_length

message_length
public uint message_length

The length of the message. If the message type is text, it should be the length of the string.

senderUserID

senderUserID
public string senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public string conversationID

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

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public ulong conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

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

localMessageID

localMessageID
public long localMessageID

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

isUserInserted

isUserInserted
public bool isUserInserted

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

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

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

extendedData

extendedData
public string extendedData

message extension field

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

localExtendedData

localExtendedData
public string localExtendedData

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

isBroadcastMessage

isBroadcastMessage
public bool isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
public bool isMentionAll

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

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

mentionedUserIDs

mentionedUserIDs
public ArrayList<String> mentionedUserIDs

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

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

messageSeq

messageSeq
public ulong messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public uint rootRepliedCount

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

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public string editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public ulong editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public bool isGroupTargetedMessage

Identify if this message is group targeted message.

Methods

ZIMCommandMessage

ZIMCommandMessage
public void ZIMCommandMessage()
Declared in ZIMDefines.cs

ZIMConversation

Session specific content.

Details

The specific content of the session.

Declared in ZIMDefines.cs

Properties

conversationID

conversationID
public string conversationID

conversationID.

conversationName

conversationName
public string conversationName

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

type

type

conversation type.

unreadMessageCount

unreadMessageCount
public int unreadMessageCount

Session unread.

lastMessage

lastMessage
public ZIMMessage lastMessage

last message.

orderKey

orderKey
public long orderKey

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

notificationStatus

notificationStatus
public ZIMConversationNotificationStatus notificationStatus

session notification status.

conversationAvatarUrl

conversationAvatarUrl
public string conversationAvatarUrl

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

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

isPinned

isPinned
public bool isPinned

Whether the conversation is pinned.

mentionedInfoList

mentionedInfoList
public ArrayList<ZIMMessageMentionedInfo> mentionedInfoList

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

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

conversationAlias

conversationAlias
public string conversationAlias

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

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

marks

marks
public std::vector<int> marks

Describes all the existing marks for the conversation.

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

draft

draft
public string draft

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

pinnedTime

pinnedTime
public long pinnedTime

The timestamp at the top of the session

  • Use cases: It can be used to sort the pinned sessions by the pinning time.
  • Default value: This value is 0 when a session is unpinned or has never been pinned.

readMessageSeq

readMessageSeq
public long readMessageSeq

Conversation read message sequence number.

ZIMConversationChangeInfo

Session change information.

Details

Contains information after session changes.

Declared in ZIMDefines.cs

Properties

event

event

session events.

conversation

conversation
public ZIMConversation conversation

Session specific information.

ZIMConversationDeleteConfig

Delete session configuration.

Details

Delete the related configuration of the session.

Declared in ZIMDefines.cs

Properties

isAlsoDeleteServerConversation

isAlsoDeleteServerConversation
public bool isAlsoDeleteServerConversation

Whether to delete the conversation on the server

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

ZIMConversationQueryConfig

Query the relevant configuration of the session.

Details

Configurable information when querying a session.

Declared in ZIMDefines.cs

Properties

nextConversation

nextConversation
public ZIMConversation nextConversation

Session that needs to be queried.

  • Required: Not required.

count

count
public uint count

The number of sessions to query.

  • Required: Required.

ZIMConversationsAllDeletedInfo

Delete all session notification information.

Details

Delete all session notification information.

Declared in ZIMDefine.cs

Properties

count

count
public uint count

Number of sessions that were deleted.

ZIMCustomMessage

Custom message object.

Details

Identifies a custom message.

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

Declared in ZIMDefines.cs

Properties

message

message
public string message

The text content of the message.

subType

subType
public uint subType

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

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

searchedContent

searchedContent
public string searchedContent

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

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

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

timestamp

timestamp
public ulong timestamp

Identifies the sending time of a message

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

message_length

message_length
public uint message_length

The length of the message. If the message type is text, it should be the length of the string.

senderUserID

senderUserID
public string senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public string conversationID

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

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public ulong conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

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

localMessageID

localMessageID
public long localMessageID

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

isUserInserted

isUserInserted
public bool isUserInserted

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

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

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

extendedData

extendedData
public string extendedData

message extension field

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

localExtendedData

localExtendedData
public string localExtendedData

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

isBroadcastMessage

isBroadcastMessage
public bool isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
public bool isMentionAll

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

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

mentionedUserIDs

mentionedUserIDs
public ArrayList<String> mentionedUserIDs

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

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

messageSeq

messageSeq
public ulong messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public uint rootRepliedCount

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

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public string editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public ulong editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public bool isGroupTargetedMessage

Identify if this message is group targeted message.

ZIMCustomMessageLiteInfo

Custom message lite info object.

Details

Identifies a custom message.

Declared in ZIMDefines.cs

Properties

message

message
public string message

The text content of the message.

subType

subType
public uint subType

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

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

searchedContent

searchedContent
public string searchedContent

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

ZIMError

Error infomation

Details

Error infomation.

Declared in ZIMDefines.cs

Properties

code

code
public ZIMErrorCode code

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

message

message
public string message

Error infomation description.

ZIMErrorUserInfo

Error user information class.

Details

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

Declared in ZIMDefines.cs

Properties

userID

userID
public string userID

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

reason

reason
public uint reason

Description Reason for the query failure.

ZIMFileCacheInfo

File cache information.

Details

Detailed description: File cache information.

Declared in ZIMDefines.cs

Properties

totalFileSize

totalFileSize
public ulong totalFileSize

Total file size in bytes (B).

ZIMFriendApplicationInfo

Friend application information.

Details

Detailed description: Friend application information.

Declared in ZIMDefines.cs

Properties

applyUser

applyUser
public ZIMUserInfo applyUser

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

wording

wording
public string wording

The wording of friend application information.

createTime

createTime
public int createTime

Friend add time.

updateTime

updateTime
public int updateTime

Friend application status update time.

type

type

Friend application type.

state

state

Friend application state.

ZIMFriendInfo

Friend information.

Details

Detailed description: Friend information.

Declared in ZIMDefines.cs

Properties

userID

userID
public string userID

Detail description: UserID of the operator.

friendAlias

friendAlias
public string friendAlias

The alias of friend.

friendAttributes

friendAttributes
public Record<string, string> friendAttributes

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

createTime

createTime
public int createTime

Friend add time.

userName

userName
public string userName

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

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

userAvatarUrl

userAvatarUrl
public string userAvatarUrl

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

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

userExtendedData

userExtendedData
public string userExtendedData

Extended field information of the user.

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

ZIMFriendRelationInfo

Friend relationship information.

Details

Detailed description: Friend relationship information.

Declared in ZIMDefines.cs

Properties

userID

userID
public string userID

user ID.

type

type

Friend relationship type.

ZIMGroupApplicationInfo

Group application information.

Declared in ZIMDefines.cs

Properties

applyUser

applyUser
public ZIMUserInfo applyUser

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

wording

wording
public string wording

The wording of group application information.

createTime

createTime
public ulong createTime

Group application create time.

updateTime

updateTime
public ulong updateTime

Group application status update time.

type

type
public ZIMGroupApplicationType type

Group application type.

state

state
public ZIMGroupApplicationState state

Group application state.

groupInfo

groupInfo
public ZIMGroupInfo groupInfo

Group information for applying to join the group.

operatedUser

operatedUser
public ZIMGroupMemberSimpleInfo operatedUser

The operator who agrees to join the group application.

ZIMGroupConversation

Group session object, extend from ZIMGroupConversation.

Details

Group session object, extend from ZIMGroupConversation.

Declared in ZIMDefines.cs

Properties

mutedExpiredTime

mutedExpiredTime
public long long mutedExpiredTime

The expiration date of the group gag.

isDisabled

isDisabled
public bool isDisabled

Whether the group session is unavailable.

conversationID

conversationID
public string conversationID

conversationID.

conversationName

conversationName
public string conversationName

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

type

type

conversation type.

unreadMessageCount

unreadMessageCount
public int unreadMessageCount

Session unread.

lastMessage

lastMessage
public ZIMMessage lastMessage

last message.

orderKey

orderKey
public long orderKey

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

notificationStatus

notificationStatus
public ZIMConversationNotificationStatus notificationStatus

session notification status.

conversationAvatarUrl

conversationAvatarUrl
public string conversationAvatarUrl

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

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

isPinned

isPinned
public bool isPinned

Whether the conversation is pinned.

mentionedInfoList

mentionedInfoList
public ArrayList<ZIMMessageMentionedInfo> mentionedInfoList

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

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

conversationAlias

conversationAlias
public string conversationAlias

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

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

marks

marks
public std::vector<int> marks

Describes all the existing marks for the conversation.

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

draft

draft
public string draft

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

pinnedTime

pinnedTime
public long pinnedTime

The timestamp at the top of the session

  • Use cases: It can be used to sort the pinned sessions by the pinning time.
  • Default value: This value is 0 when a session is unpinned or has never been pinned.

readMessageSeq

readMessageSeq
public long readMessageSeq

Conversation read message sequence number.

ZIMGroupInviteApplicationAcceptConfig

The behavior property of the accept group invite application setting.

Declared in ZIMDefines.cs

Properties

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Offline push configuration.

ZIMGroupInviteApplicationRejectConfig

The behavior property of the reject group invite application setting.

Declared in ZIMDefines.cs

Properties

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Offline push configuration.

ZIMGroupInviteApplicationSendConfig

The behavior property of the send group invite application setting.

Declared in ZIMDefines.cs

Properties

wording

wording
public string wording

Postscript to the application operation.

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Offline push configuration.

ZIMGroupJoinApplicationAcceptConfig

The behavior property of the accept group join application setting.

Declared in ZIMDefines.cs

Properties

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Offline push configuration.

ZIMGroupJoinApplicationRejectConfig

The behavior property of the reject group join application setting.

Declared in ZIMDefines.cs

Properties

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Offline push configuration.

ZIMGroupJoinApplicationSendConfig

The behavior property of the send group join application setting.

Declared in ZIMDefines.cs

Properties

wording

wording
public string wording

Postscript to the application operation.

pushConfig

pushConfig
public ZIMPushConfig pushConfig

Offline push configuration.

ZIMLogConfig

Log configuration

Details

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

Declared in ZIMDefines.cs

Properties

logPath

logPath
public string logPath

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

logSize

logSize
public ulong logSize

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

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 ZIMDefines.cs

Properties

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

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

timestamp

timestamp
public ulong timestamp

Identifies the sending time of a message

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

message_length

message_length
public uint message_length

The length of the message. If the message type is text, it should be the length of the string.

senderUserID

senderUserID
public string senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public string conversationID

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

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public ulong conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

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

localMessageID

localMessageID
public long localMessageID

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

isUserInserted

isUserInserted
public bool isUserInserted

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

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

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

extendedData

extendedData
public string extendedData

message extension field

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

localExtendedData

localExtendedData
public string localExtendedData

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

isBroadcastMessage

isBroadcastMessage
public bool isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
public bool isMentionAll

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

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

mentionedUserIDs

mentionedUserIDs
public ArrayList<String> mentionedUserIDs

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

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

messageSeq

messageSeq
public ulong messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public uint rootRepliedCount

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

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public string editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public ulong editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public bool isGroupTargetedMessage

Identify if this message is group targeted message.

ZIMMessageDeletedInfo

Deleted message information.

Declared in ZIMDefines.cs

Properties

conversationID

conversationID
public string conversationID

Conversation ID.

conversationType

conversationType
public ZIMConversationType conversationType

Conversation type.

messageList

messageList
public List<ZIMMessage> messageList

List of deleted messages.

isDeleteConversationAllMessage

isDeleteConversationAllMessage
deprecated
public bool isDeleteConversationAllMessage

Whether to delete all current messages in the conversation.

Deprecated
This field was deprecated in version 2.14.0.

messageDeleteType

messageDeleteType
public ZIMMessageDeleteType messageDeleteType

[onMessageDeleted] Indicates the cause of being triggered.

ZIMMessagePinConfig

Pin message configuration.

Details

Pin configurations related to messages.

Declared in ZIMDefines.cs

Properties

disableAutoReplace

disableAutoReplace
public bool disableAutoReplace

When the number of pinned messages exceeds the limit, replacing older pinned messages in the pinned list during the next pin operation is not allowed.

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

ZIMMessageReaction

message reaction infos

Details

message reaction infos.

Declared in ZIMDefines.cs

Properties

conversationID

conversationID
public string conversationID

conversationID.

conversationType

conversationType
public ZIMConversationType conversationType

conversation type.

messageID

messageID
public string messageID

Detail description: reaction message ID.

reactionType

reactionType
public string reactionType

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

isSelfIncluded

isSelfIncluded
public bool isSelfIncluded

The reaciton users if included myself.

totalCount

totalCount
public uint totalCount

The reaction users number.

userList

userList
public List<ZIMMessageReactionUserInfo> userList

Reaction user info list.

sumCount

sumCount
public uint sumCount

The sum count of reaction.

ZIMMessageReactionSimpleInfo

message reaction infos

Details

message reaction infos.

Declared in ZIMDefines.cs

Properties

reactionType

reactionType
public string reactionType

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

sumCount

sumCount
public uint sumCount

The sum count of reaction.

ZIMMessageReactionUserChangeInfo

User reaction change information.

Declared in ZIMDefines.cs

Properties

userID

userID
public string userID

user ID.

action

action
public ZIMMessageReactionUserChangeAction action

reaction change action.

reactionType

reactionType
public string reactionType

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

sumCount

sumCount
public uint sumCount

The sum count of reaction.

ZIMMessageReactionUserFullInfo

reaction user information.

Details

Detail description: A class describing reaction user.

Declared in ZIMDefines.cs

Properties

userID

userID
public string userID

user ID

reactions

reactions
public List<ZIMMessageReactionSimpleInfo> reactions

Repeated reaction list.

ZIMMessageReactionUserInfo

reaction user information.

Details

Detail description: A class describing reaction user.

Declared in ZIMDefines.cs

Properties

userID

userID
public string userID

user ID

ZIMMessageReactionUserQueryConfig

Configuration for querying reaction user list

Details

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

Declared in ZIMDefines.cs

Properties

nextFlag

nextFlag
public ulong nextFlag

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

  • Required: Not required.

count

count
public uint count

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

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

reactionType

reactionType
public string reactionType

reaction type, defined by you.

ZIMMessageReactionsChangedEventResult

The result of the event callback.

Declared in ZIMDefines.cs

Properties

reactions

reactions
public ZIMMessageReaction[] reactions

the list of changed reactions.

changeInfoList

changeInfoList
public ZIMMessageReactionChangeInfo[] changeInfoList

change info list.

ZIMMessageReceiptInfo

receipt information.

Details

Detailed description: receipt information.

Declared in ZIMDefines.cs

Properties

status

status

Detail description: receipt status.

messageID

messageID
public long messageID

Message ID.

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

Is it required: No, SDK fills in.

conversationID

conversationID
public string conversationID

Session ID.

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

Is it required: No, SDK fills in.

conversationType

conversationType
public ZIMConversationType conversationType

Session type.

Business scenario: Indicates the type of the session.

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

readMemberCount

readMemberCount
public int readMemberCount

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

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

Is it required: no.

Default: 0.

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

unreadMemberCount

unreadMemberCount
public int unreadMemberCount

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

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

Is it required: no.

Default: 0.

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

isSelfOperated

isSelfOperated
public bool isSelfOperated

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

readTime

readTime
public ulong readTime

Server-side timestamp when the message receipt was read.

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

ZIMMessageRepliedInfo

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

Declared in ZIMDefines.cs

Properties

state

state
public ZIMMessageRepliedInfoState state

the source message status.

sentTime

sentTime
public ulong sentTime

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

senderUserID

senderUserID
public string senderUserID

The sender user ID of the source message.

messageSeq

messageSeq
public ulong messageSeq

The seq of the source message.

messageInfo

messageInfo
public ZIMMessageLiteInfo messageInfo

The source message lite info object.

messageID

messageID
public ulong messageID

The ID of the source message.

ZIMMessageRepliedListQueryConfig

Configuration for querying reply message list.

Declared in ZIMDefines.cs

Properties

nextFlag

nextFlag
public ulong nextFlag

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

count

count
public uint count

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

  • Required: Required.

ZIMMessageRootRepliedCountInfo

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

Declared in ZIMDefines.cs

Properties

conversationID

conversationID
public string conversationID

Conversation ID.

conversationType

conversationType
public ZIMConversationType conversationType

Conversation type.

messageID

messageID
public ulong messageID

root message id.

count

count
public uint count

The number of replies for the reply message tree.

ZIMMessageRootRepliedInfo

Reply to the root message of the message tree.

Declared in ZIMDefines.cs

Properties

state

state
public ZIMMessageRepliedInfoState state

Root message status.

sentTime

sentTime
public ulong sentTime

The send timestamp of the root message.

senderUserID

senderUserID
public string senderUserID

The sender user ID of the root message.

repliedCount

repliedCount
public uint repliedCount

The number of replies for the reply message tree.

message

message
public ZIMMessage message

The root message object.

ZIMRoomFullInfo

The room details object.

Details

Identifies the basic parameters of a message.

  • Caution: Identifies the detailed information of a room.

Declared in ZIMDefines.cs

Properties

baseInfo

baseInfo
public ZIMRoomInfo baseInfo

The base object of the room.

ZIMRoomInfo

Room information object.

Details

Identifies a unique room.

Declared in ZIMDefines.cs

Properties

roomID

roomID
public string roomID

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

roomName

roomName
public string roomName

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

ZIMRoomMemberAttributesInfo

Room user attribute information.

Details

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

Declared in ZIMDefines.cs

Properties

userID

userID
public string userID

Detail description: User ID.

attributes

attributes
public Record<string, string> attributes

Detailed description: room user attributes.

ZIMRoomMemberAttributesOperatedInfo

Room user attribute operation information.

Details

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

Declared in ZIMDefines.cs

Properties

attributesInfo

attributesInfo
public ZIMRoomMemberAttributesInfo attributesInfo

Detailed description: room user attribute information.

errorKeys

errorKeys
public string[] errorKeys

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

ZIMRoomMemberAttributesQueryConfig

Room user attribute query configuration.

Details

Detailed description: room user attribute query configuration.

Declared in ZIMDefines.cs

Properties

nextFlag

nextFlag
public string nextFlag

Detail description: Query anchor for room user properties.

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

count

count
public uint 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 ZIMDefines.cs

Properties

isDeleteAfterOwnerLeft

isDeleteAfterOwnerLeft
public bool isDeleteAfterOwnerLeft
  • Required: not required.

Default: true.

ZIMRoomMemberAttributesUpdateInfo

Room user attribute update information.

Details

Detailed description: Room user attribute update information.

Declared in ZIMDefines.cs

Properties

attributesInfo

attributesInfo
public ZIMRoomMemberAttributesInfo attributesInfo

Detailed description: room user attributes.

ZIMRoomMemberInfo

Room user information.

Details

Detail description: A class describing room user.

Declared in ZIMDefines.cs

Properties

userID

userID
public string userID

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

userName

userName
public string userName

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

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

userAvatarUrl

userAvatarUrl
public string userAvatarUrl

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

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

userExtendedData

userExtendedData
public string userExtendedData

Extended field information of the user.

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

ZIMRoomMemberQueryConfig

Configuration for querying room member.

Details

When querying member, you need to configure this object.

Declared in ZIMDefines.cs

Properties

nextFlag

nextFlag
public string nextFlag

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

  • Required: Not required.

count

count
public uint count

How many messages are retrieved in one query.

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

ZIMRoomOperatedInfo

Room operation information.

Details

Detailed description: Room operation information.

Declared in ZIMDefines.cs

Properties

userID

userID
public string userID

Detail description: UserID of the operator.

ZIMSelfUserInfo

Carry user information and rules of the current user.

Details

Carry user information and rules of the current user.

Declared in ZIMDefines.cs

Properties

userRule

userRule
public ZIMUserRule userRule

Rules for the current user, setting information.

userFullInfo

userFullInfo
public ZIMUserFullInfo userFullInfo

Personal information of the current user.

ZIMSelfUserRule

User's own rule class.

Declared in ZIMDefines.cs

Properties

offlinePushRule

offlinePushRule
public ZIMUserOfflinePushRule offlinePushRule

The user's current rule information.

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 ZIMDefines.cs

Properties

message

message
public string message

The content of the text message.

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

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

timestamp

timestamp
public ulong timestamp

Identifies the sending time of a message

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

message_length

message_length
public uint message_length

The length of the message. If the message type is text, it should be the length of the string.

senderUserID

senderUserID
public string senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public string conversationID

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

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public ulong conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

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

localMessageID

localMessageID
public long localMessageID

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

isUserInserted

isUserInserted
public bool isUserInserted

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

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

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

extendedData

extendedData
public string extendedData

message extension field

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

localExtendedData

localExtendedData
public string localExtendedData

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

isBroadcastMessage

isBroadcastMessage
public bool isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
public bool isMentionAll

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

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

mentionedUserIDs

mentionedUserIDs
public ArrayList<String> mentionedUserIDs

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

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

messageSeq

messageSeq
public ulong messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public uint rootRepliedCount

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

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public string editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public ulong editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public bool isGroupTargetedMessage

Identify if this message is group targeted message.

Methods

ZIMTextMessage

ZIMTextMessage
public void ZIMTextMessage()
Declared in ZIMDefines.cs

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 ZIMDefines.cs

Properties

message

message
public string message

The content of the text message.

Methods

ZIMTextMessageLiteInfo

ZIMTextMessageLiteInfo
Declared in ZIMDefines.cs

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 ZIMDefines.cs

Properties

baseInfo

baseInfo
public ZIMUserInfo baseInfo

User basic information.

userAvatarUrl

userAvatarUrl
deprecated
public string userAvatarUrl
  • Required: not required.

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

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

extendedData

extendedData
public string extendedData
  • Required: not required.

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

ZIMUserInfo

User information object.

Details

Identifies a unique user.

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

Declared in ZIMDefines.cs

Properties

userID

userID
public string userID

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

userName

userName
public string userName

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

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

userAvatarUrl

userAvatarUrl
public string userAvatarUrl

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

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

userExtendedData

userExtendedData
public string userExtendedData

Extended field information of the user.

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

ZIMUserOfflinePushRule

Data class of the user's offline push rule.

Details

Data class of the user's offline push rule.

Declared in ZIMDefines.cs

Properties

onlinePlatforms

onlinePlatforms
public List<int> onlinePlatforms

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

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

notToReceiveOfflinePushPlatforms

notToReceiveOfflinePushPlatforms
public List<int> notToReceiveOfflinePushPlatforms

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

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

ZIMVideoMessage

Video message object.

Declared in ZIMDefines.cs

Properties

videoDuration

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

videoFirstFrameLocalPath

videoFirstFrameLocalPath
public string videoFirstFrameLocalPath

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

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

videoFirstFrameDownloadUrl

videoFirstFrameDownloadUrl
public string videoFirstFrameDownloadUrl

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

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

videoFirstFrameWidth

videoFirstFrameWidth
public uint videoFirstFrameWidth

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

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

videoFirstFrameHeight

videoFirstFrameHeight
public uint videoFirstFrameHeight

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

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

videoFirstFrameSize

videoFirstFrameSize
public CGSize videoFirstFrameSize

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

Business scenario: When the user needs to draw a picture UI, the parameters used to determine the width and height of the first frame of the video.

fileLocalPath

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

fileDownloadUrl

fileDownloadUrl
public string fileDownloadUrl

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

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

fileUID

fileUID
public string fileUID

Detail description: The unique ID of the media file.

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

fileName

fileName
public string fileName

Detail description: The filename of the media file.

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

fileSize

fileSize
public ulong fileSize

Detail description: The size of the media file.

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

type

type
public ZIMMessageType type

Identifies the type of this message.

messageID

messageID
public long messageID

The unique ID that identifies this message.

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

timestamp

timestamp
public ulong timestamp

Identifies the sending time of a message

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

message_length

message_length
public uint message_length

The length of the message. If the message type is text, it should be the length of the string.

senderUserID

senderUserID
public string senderUserID

Displays the userID of the sender of this message.

conversationID

conversationID
public string conversationID

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

direction

direction
public ZIMMessageDirection direction

Used to describe whether a message is sent or received.

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

Describes the sending status of a message.

conversationType

conversationType
public ZIMConversationType conversationType

The type of conversation to which the message belongs.

conversationSeq

conversationSeq
public ulong conversationSeq

Indicates the sequence number of the message in the conversation.

orderKey

orderKey
public long orderKey

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

localMessageID

localMessageID
public long localMessageID

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

isUserInserted

isUserInserted
public bool isUserInserted

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

Default: false.

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

Describe the receipt status of the message

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

extendedData

extendedData
public string extendedData

message extension field

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

localExtendedData

localExtendedData
public string localExtendedData

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

isBroadcastMessage

isBroadcastMessage
public bool isBroadcastMessage

Whether the message is pushed by all employees.

  • Required: Internal assignment.

isMentionAll

isMentionAll
public bool isMentionAll

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

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

mentionedUserIDs

mentionedUserIDs
public ArrayList<String> mentionedUserIDs

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

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

messageSeq

messageSeq
public ulong messageSeq

Indicates the sequence number of the message in the conversation.

rootRepliedCount

rootRepliedCount
public uint rootRepliedCount

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

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

Information about the source message referenced by the reply message.

editorUserID

editorUserID
public string editorUserID

The latest editor's userID for this message.

editedTime

editedTime
public ulong editedTime

The latest editing timestamp for this message.

isGroupTargetedMessage

isGroupTargetedMessage
public bool isGroupTargetedMessage

Identify if this message is group targeted message.

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 ZIMDefines.cs

Properties

videoDuration

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

videoFirstFrameLocalPath

videoFirstFrameLocalPath
public string videoFirstFrameLocalPath

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

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

videoFirstFrameDownloadUrl

videoFirstFrameDownloadUrl
public string videoFirstFrameDownloadUrl

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

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

videoFirstFrameWidth

videoFirstFrameWidth
public uint videoFirstFrameWidth

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

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

videoFirstFrameHeight

videoFirstFrameHeight
public uint videoFirstFrameHeight

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

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

fileLocalPath

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

fileDownloadUrl

fileDownloadUrl
public string fileDownloadUrl

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

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

fileName

fileName
public string fileName

Detail description: The filename of the media file.

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

fileSize

fileSize
public ulong fileSize

Detail description: The size of the media file.

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

ZIMVoIPConfig

Provides information about the iOS VoIP offline push.

Details

Provides information about the iOS VoIP offline push.

Declared in ZIMDefines.cs

Properties

iOSVoIPHandleType

iOSVoIPHandleType
public ZIMCXHandleType iOSVoIPHandleType

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

iOSVoIPHandleValue

iOSVoIPHandleValue
public string iOSVoIPHandleValue

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

iOSVoIPHasVideo

iOSVoIPHasVideo
public bool iOSVoIPHasVideo

Video call or not. The default value is audio

Previous

Interface

Next

Enum

On this page

Back to top