logo
In-app Chat
On this page

Struct

2026-01-23
ZIMAppConfigZIMBarrageMessage
ZIMCallingInvitationSentInfoZIMCallInvitationEndedInfo
ZIMCallInvitationTimeoutInfoZIMCallJoinSentInfo
ZIMCallQuitSentInfoZIMCallUserStateChangeInfo
ZIMConversationsAllDeletedInfoZIMErrorUserInfo
ZIMFileCacheInfoZIMFriendApplicationInfo
ZIMFriendInfoZIMFriendRelationInfo
ZIMGroupApplicationInfoZIMGroupConversation
ZIMGroupInviteApplicationAcceptConfigZIMGroupInviteApplicationRejectConfig
ZIMGroupInviteApplicationSendConfigZIMGroupJoinApplicationAcceptConfig
ZIMGroupJoinApplicationRejectConfigZIMGroupJoinApplicationSendConfig
ZIMMessageDeletedInfoZIMMessageReaction
ZIMMessageReactionUserInfoZIMMessageReceiptInfo
ZIMMessageRepliedInfoZIMMessageRootRepliedCountInfo
ZIMMessageRootRepliedInfoZIMRoomMemberAttributesInfo
ZIMRoomMemberAttributesOperatedInfoZIMRoomMemberAttributesQueryConfig
ZIMRoomMemberAttributesSetConfigZIMRoomMemberAttributesUpdateInfo
ZIMRoomMemberInfoZIMRoomOperatedInfo
ZIMSelfUserInfoZIMSelfUserRule
ZIMUserOfflinePushRuleZIMVideoMessage
ZIMVideoMessageLiteInfoZIMVoIPConfig

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.

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.

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.

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.

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.

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.

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.

ZIMMessageReactionUserInfo

reaction user information.

Details

Detail description: A class describing reaction user.

Declared in ZIMDefines.cs

Properties

userID

userID
public string userID

user ID

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.

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.

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.

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.

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