logo
即时通讯
当前页

Struct

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

ZIMAppConfig

ZIM 应用配置,包含 AppID 和 AppSign。

Declared in ZIMDefines.cs

属性

appID

appID
public uint appID
  • 是否必填:必填。

appSign

appSign
public string appSign
  • 是否必填:必填。

ZIMBarrageMessage

弹幕消息类。

详情

弹幕消息类,不会出现在会话中,也不会存入历史消息。

Declared in ZIMDefines.cs

属性

message

message
public string message

弹幕消息内容。

type

type
public ZIMMessageType type

消息类型。

messageID

messageID
public long messageID

标识这条消息的唯一 ID。

  • 业务场景:可用于索引其他消息。
  • 注意事项:开发者主动创建一条消息时,不需要修改这个参数,此参数仅在回调时有值。

timestamp

timestamp
public ulong timestamp

标识一条消息的发送时间。

  • 业务场景:用于呈现一条消息的发送时间,并可用于消息排序。
  • 注意事项:此为标准 UNIX 时间戳,单位为毫秒。

message_length

message_length
public uint message_length

消息的长度。如果此消息的类型为 Text 文本消息,则应当为字符串的长度。

  • 是否必填:必填。

senderUserID

senderUserID
public string senderUserID

展示本条消息发送者的 userID。

conversationID

conversationID
public string conversationID

会话的 ID,相同会话类型下的 ID 是唯一的。

direction

direction
public ZIMMessageDirection direction

用于描述消息的方向是发送还是接收。

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

描述消息的发送状态。

conversationType

conversationType
public ZIMConversationType conversationType

该消息所属会话的类型。

conversationSeq

conversationSeq
public ulong conversationSeq

表示该消息在会话中的序号。

orderKey

orderKey
public long orderKey

orderKey 越大消息越新,可用于消息排序。

localMessageID

localMessageID
public long localMessageID

SDK 本地生成的 MessageID,开发者无需关注。

isUserInserted

isUserInserted
public bool isUserInserted

该消息是否是开发者通过 [insertMessageToLocalDB] 接口插入的消息。

  • 默认值:false。

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

描述该消息的回执状态。

  • 业务场景:用于在回执消息中,判断当前消息是处于什么状态。

extendedData

extendedData
public string extendedData

消息拓展字段。

  • 业务场景:可为消息附加拓展字段,然后发送给对端。
  • 是否必填:否。
  • 支持版本:2.6.0 及以上。
  • 注意事项:长度为1k,可联系技术支持进行配置。

localExtendedData

localExtendedData
public string localExtendedData

仅本端可见的消息拓展字段,可附带额外的信息存储到本地,可通过 [updateMessageLocalExtendedData] 修改,目前长度的限制是 128K。如有特殊需求,可联系 ZEGO 技术支持进行配置。

isBroadcastMessage

isBroadcastMessage
public bool isBroadcastMessage

该消息是否是全员推送消息。

  • 是否必填:SDK内部赋值。

isMentionAll

isMentionAll
public bool isMentionAll

是否需要提醒所有人。业务表现可为“@所有人”。

  • 业务场景:例如在群或者房间可使用。
  • 是否必填:否。
  • 默认值:false。
  • 建议值:如果需要提醒所有人,可以设置为 true。
  • 注意事项:该值并不会在消息文本上增加 @所有人 的字样,需要开发者自行实现。

支持版本 : 2.14.0 及以上。

mentionedUserIDs

mentionedUserIDs
public ArrayList\<String> mentionedUserIDs

提醒一批相关的用户。业务表现可为“@某用户”。

  • 业务场景:发消息时可以带上
  • 是否必填:否。
  • 注意事项:该值并不会在消息文本上增加 @某用户 的字样,需要开发者自行实现。

支持版本 : 2.14.0 及以上。

messageSeq

messageSeq
public ulong messageSeq

表示该消息在会话中的序号。

rootRepliedCount

rootRepliedCount
public uint rootRepliedCount

回复消息树对应的根消息的回复消息数量。

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

回复消息引用的源消息的信息。

editorUserID

editorUserID
public string editorUserID

本条消息最新的编辑者的 userID。

editedTime

editedTime
public ulong editedTime

本条消息最新的编辑时间戳。

isGroupTargetedMessage

isGroupTargetedMessage
public bool isGroupTargetedMessage

标识该消息是否为群定向消息。

ZIMCallInvitationEndedInfo

结束呼叫的操作信息。

详情

结束呼叫的操作信息。

Declared in ZIM.cs

属性

caller

caller
public string caller

当前呼叫的主叫。

operatedUserID

operatedUserID
public string operatedUserID

结束呼叫的操作者。

extendedData

extendedData
public string extendedData

调用结束呼叫时附带的透传字段。

mode

mode

当次呼叫邀请的模式。

endTime

endTime
public long endTime

结束呼叫的时间戳,单位毫秒,格式: UTC 时间戳。

ZIMCallInvitationTimeoutInfo

有关超时通知的信息类。

详情

有关超时通知的信息类。

Declared in ZIMDefines.cs

属性

mode

mode

呼叫邀请的类型。

ZIMCallJoinSentInfo

加入呼叫操作的结果信息。

详情

加入呼叫操作的结果信息。

Declared in ZIMDefines.cs

属性

createTime

createTime
public long createTime

当次呼叫邀请的创建时间的时间戳。

joinTime

joinTime
public long joinTime

本人加入呼叫邀请的时间戳。

extendedData

extendedData
public string extendedData

调用结束呼叫时附带的透传字段。

callUserList

callUserList
public List<ZIMCallUserInfo> callUserList

当前呼叫邀请中的用户信息列表。

ZIMCallQuitSentInfo

退出呼叫操作的结果信息。

详情

退出呼叫操作的结果信息。

Declared in ZIMDefines.cs

属性

createTime

createTime
public long createTime

当次呼叫邀请的创建时间的时间戳。

acceptTime

acceptTime
public long acceptTime

本人接受呼叫邀请的时间戳。

quitTime

quitTime
public long quitTime

本人退出呼叫的时间戳。

ZIMCallUserStateChangeInfo

呼叫成员状态变化信息。

详情

呼叫成员状态变化信息。

Declared in ZIM.cs

属性

callUserList

callUserList
public List<ZIMCallUserInfo> callUserList

发生状态变化的呼叫成员列表。

ZIMCallingInvitationSentInfo

呼叫中邀请已发送信息。

详情

呼叫中邀请已发送信息。

Declared in ZIMDefines.cs

属性

errorUserList

errorUserList
public List<ZIMErrorUserInfo> errorUserList

错误用户列表。

ZIMConversationsAllDeletedInfo

删除全部会话通知的信息。

详情

删除全部会话通知的信息。

Declared in ZIMDefine.cs

属性

count

count
public uint count

会话被删除的数目。

ZIMErrorUserInfo

失败用户信息类。

详情

用于展示失败的用户以及失败的原因。

Declared in ZIMDefines.cs

属性

userID

userID
public string userID

userID。

  • 取值范围:最大 32 字节的字符串。仅支持数字,英文字符 和 '!', '#', '$', '%', '&', '(', ')', '+', '-', ':', ';', '<', '=', '.', '>', '?', '@', '[', ']', '^', '_', '{', '}', '|', '~'。

reason

reason
public uint reason

描述查询失败原因的 reason。

ZIMFileCacheInfo

文件缓存信息。

详情

文件缓存信息。

Declared in ZIMDefines.cs

属性

totalFileSize

totalFileSize
public ulong totalFileSize

总的文件大小,单位为字节(B)。

ZIMFriendApplicationInfo

好友申请信息。

详情

好友申请信息。

Declared in ZIMDefines.cs

属性

applyUser

applyUser
public ZIMUserInfo applyUser

如果自己是申请人,则这里是被申请人信息;如果自己是被申请人,则这里是申请人信息;

wording

wording
public string wording

好友申请附言。

createTime

createTime
public int createTime

好友添加时间。

updateTime

updateTime
public int updateTime

好友申请状态更新时间。

type

type

好友申请类型。

state

state

好友申请状态。

ZIMFriendInfo

好友信息。

详情

好友信息。

Declared in ZIMDefines.cs

属性

userID

userID
public string userID

操作者的 UserID。

friendAlias

friendAlias
public string friendAlias

好友备注。

friendAttributes

friendAttributes
public Record<string, string> friendAttributes

好友属性。最多设置 5 个。属性的 key 仅支持从 k0 ~ k4 取值。

createTime

createTime
public int createTime

好友添加时间。

userName

userName
public string userName

用户 name,由开发者自定义生成。

  • 是否必填:非必填。
  • 取值范围:2.0.0 及以后版本,支持最大 256 字节的字符串。
  • 隐私保护声明:不要传入涉及个人隐私的敏感信息,包括但不限于手机号、身份证号、护照编号、真实姓名等。

userAvatarUrl

userAvatarUrl
public string userAvatarUrl

用户头像,由开发者自定义生成。

  • 是否必填:非必填。
  • 取值范围:特殊字符不受限制,最大长度为500字节。
  • 隐私保护声明:不要传入涉及个人隐私的敏感信息,包括但不限于手机号、身份证号、护照编号、真实姓名等。
  • 支持版本:2.13.0 及以上。
  • 注意事项:房间成员列表需要在 2.18.0 版本后才会返回该值。

userExtendedData

userExtendedData
public string userExtendedData

用户的扩展字段信息。

  • 注意事项:仅房间用户时,该属性有值。

ZIMFriendRelationInfo

好友关系信息。

详情

好友关系信息。

Declared in ZIMDefines.cs

属性

userID

userID
public string userID

用户ID。

type

type

好友关系类型。

ZIMGroupApplicationInfo

入群申请信息。

Declared in ZIMDefines.cs

属性

applyUser

applyUser
public ZIMUserInfo applyUser

类型为加入申请时是申请人,类型为邀请申请时是被邀请人,类型为被邀请申请时是邀请人。

wording

wording
public string wording

入群申请附言。

createTime

createTime
public ulong createTime

入群申请创建时间戳,单位为毫秒。

updateTime

updateTime
public ulong updateTime

入群申请状态更新时间,单位为毫秒。

type

type
public ZIMGroupApplicationType type

入群申请类型。

state

state
public ZIMGroupApplicationState state

入群申请状态。

groupInfo

groupInfo
public ZIMGroupInfo groupInfo

申请入群的群信息。

operatedUser

operatedUser
public ZIMGroupMemberSimpleInfo operatedUser

同意外部用户加群申请的操作人。

ZIMGroupConversation

群会话对象,继承自ZIMGroupConversation。

详情

群会话对象,继承自ZIMGroupConversation。

Declared in ZIMDefines.cs

属性

mutedExpiredTime

mutedExpiredTime
public long long mutedExpiredTime

群禁言的过期时间。

isDisabled

isDisabled
public bool isDisabled

这个群会话是否为不可用的状态。

conversationID

conversationID
public string conversationID

会话ID。

conversationName

conversationName
public string conversationName

conversationName,与会话对应的 groupName/userName 值相同。

type

type

会话类型。

unreadMessageCount

unreadMessageCount
public int unreadMessageCount

会话未读数。

lastMessage

lastMessage
public ZIMMessage lastMessage

最后一条消息。

orderKey

orderKey
public long orderKey

用于描述消息在会话中的顺序,orderKey 越大越新。

notificationStatus

notificationStatus
public ZIMConversationNotificationStatus notificationStatus

会话通知状态。

conversationAvatarUrl

conversationAvatarUrl
public string conversationAvatarUrl

会话头像 URL。单聊会话头像 URL 与用户头像 URL 相同,群聊会话头像 URL 与群头像 URL 相同。

  • 使用限制: 最大 500 字节,无特殊字符限制。

isPinned

isPinned
public bool isPinned

会话是否置顶。

  • 支持版本:2.8.0。

mentionedInfoList

mentionedInfoList
public ArrayList<ZIMMessageMentionedInfo> mentionedInfoList

当在会话的消息中被提醒到或者被提醒所有人时,该数组会有记录。

  • 业务场景:比如可以在会话列表根据该数组显示当前会话有多少个提醒,还可以显示是哪个用户的提醒。

conversationAlias

conversationAlias
public string conversationAlias

会话别名,通过 [updateFriendAlias] 设置好友备注后,对应的单聊会话该参数会同步修改。通过 [updateGroupAlias] 设置群备注后,对应的群聊会话该参数会同步修改。

  • 业务场景:为好友或群组设置备注后,渲染会话页时,对应的会话优先选择展示 alias 别名,而不是 conversation name(好友的用户名或群组名)。

marks

marks
public std::vector\<int> marks

描述了该会话现有的所有标记。

  • 业务场景:业务层可以按照不同会话拥有的不同标记做分组逻辑等。

draft

draft
public string draft

会话草稿,当设置会话草稿后,会话中会带有该字段。

ZIMGroupInviteApplicationAcceptConfig

接受邀请入群申请的配置。

Declared in ZIMDefines.cs

属性

pushConfig

pushConfig
public ZIMPushConfig pushConfig

离线推送配置。

ZIMGroupInviteApplicationRejectConfig

拒绝邀请入群申请的配置。

Declared in ZIMDefines.cs

属性

pushConfig

pushConfig
public ZIMPushConfig pushConfig

离线推送配置。

ZIMGroupInviteApplicationSendConfig

发送邀请入群申请的配置。

Declared in ZIMDefines.cs

属性

wording

wording
public string wording

申请的附言。

pushConfig

pushConfig
public ZIMPushConfig pushConfig

离线推送配置。

ZIMGroupJoinApplicationAcceptConfig

接受加群申请的配置。

Declared in ZIMDefines.cs

属性

pushConfig

pushConfig
public ZIMPushConfig pushConfig

离线推送配置。

ZIMGroupJoinApplicationRejectConfig

拒绝加群申请的配置。

Declared in ZIMDefines.cs

属性

pushConfig

pushConfig
public ZIMPushConfig pushConfig

离线推送配置。

ZIMGroupJoinApplicationSendConfig

发送加群申请的配置。

Declared in ZIMDefines.cs

属性

wording

wording
public string wording

申请的附言。

pushConfig

pushConfig
public ZIMPushConfig pushConfig

离线推送配置。

ZIMMessageDeletedInfo

被删除的消息信息。

Declared in ZIMDefines.cs

属性

conversationID

conversationID
public string conversationID

会话 ID。

conversationType

conversationType
public ZIMConversationType conversationType

会话类型。

messageList

messageList
public List<ZIMMessage> messageList

删除的消息列表。

isDeleteConversationAllMessage

isDeleteConversationAllMessage
deprecated
public bool isDeleteConversationAllMessage

是否删除会话当前所有消息。

已废弃
该字段在 2.14.0 版本被废弃。

messageDeleteType

messageDeleteType
public ZIMMessageDeleteType messageDeleteType

[onMessageDeleted] 被触发的原因。

ZIMMessageReaction

表态具体内容。

详情

表态具体内容。

Declared in ZIMDefines.cs

属性

conversationID

conversationID
public string conversationID

会话 ID。

conversationType

conversationType
public ZIMConversationType conversationType

会话类型。

messageID

messageID
public string messageID

表态的消息 ID。

reactionType

reactionType
public string reactionType

表态类型,由您定义,长度上限为 32 字节。

isSelfIncluded

isSelfIncluded
public bool isSelfIncluded

已表态用户中是否包含自己。

totalCount

totalCount
public uint totalCount

表态的用户总数。

userList

userList
public List<ZIMMessageReactionUserInfo> userList

表态的用户列表。

ZIMMessageReactionUserInfo

表态用户信息。

详情

描述表态用户的类。

Declared in ZIMDefines.cs

属性

userID

userID
public string userID

用户 ID

ZIMMessageReceiptInfo

回执信息。

详情

回执信息。

Declared in ZIMDefines.cs

属性

status

status

回执的状态。

messageID

messageID
public long messageID

消息ID。

  • 业务场景:开发者可根据这个ID 匹配已经加载过的消息列表。
  • 是否必填:否,SDK填充。

conversationID

conversationID
public string conversationID

会话ID。

  • 业务场景:用于表示这是属于哪个会话的回执信息。
  • 是否必填:否,SDK填充。

conversationType

conversationType
public ZIMConversationType conversationType

会话类型。

  • 业务场景:用于表示这个会话所属类型。
  • 是否必填:否,SDK填充。

readMemberCount

readMemberCount
public int readMemberCount

表示该回执的已读人数。

  • 业务场景:用于查询回执的信息时,可显示该消息已被多少人已读。
  • 是否必填:否。
  • 默认值:0。
  • 注意事项:该值表示有多少人已读过该消息,仅适用于消息已读;如果是非自己发送的消息,该值为0。

unreadMemberCount

unreadMemberCount
public int unreadMemberCount

表示该回执的未读人数。

  • 业务场景:用于查询回执的信息时,可显示该消息已被多少人未读。
  • 是否必填:否。
  • 默认值:0。
  • 注意事项:该值表示有多少人还没读过该消息,仅适用于消息已读;如果是非自己发送的消息,该值为0。

isSelfOperated

isSelfOperated
public bool isSelfOperated

多端登录场景时,A 设备设置消息回执已读后,其他在线多端设备用于区分是否自己设置的消息回执已读。

readTime

readTime
public ulong readTime

消息回执已读时的服务端时间戳。

  • 默认值:0。
  • 注意事项:对应消息发送者,其值为会话成员全部已读时的时间戳,对于消息接收者,其值为设置消息回执已读时的时间戳。

ZIMMessageRepliedInfo

回复消息引用的源消息的描述信息。

Declared in ZIMDefines.cs

属性

state

state
public ZIMMessageRepliedInfoState state

源消息状态。

sentTime

sentTime
public ulong sentTime

源消息的发送服务端时间戳(UTC)。

senderUserID

senderUserID
public string senderUserID

源消息的发送者用户 ID。

messageSeq

messageSeq
public ulong messageSeq

源消息的seq。

messageInfo

messageInfo
public ZIMMessageLiteInfo messageInfo

源消息的简要信息。

messageID

messageID
public ulong messageID

源消息 ID。

ZIMMessageRootRepliedCountInfo

回复消息树的回复数量的信息。

Declared in ZIMDefines.cs

属性

conversationID

conversationID
public string conversationID

会话 ID。

conversationType

conversationType
public ZIMConversationType conversationType

会话类型。

messageID

messageID
public ulong messageID

根消息 ID。

count

count
public uint count

回复消息树的回复数量。

ZIMMessageRootRepliedInfo

回复消息树的根消息的描述信息。

Declared in ZIMDefines.cs

属性

state

state
public ZIMMessageRepliedInfoState state

根消息状态。

sentTime

sentTime
public ulong sentTime

根消息的发送时间戳。

senderUserID

senderUserID
public string senderUserID

根消息的发送者用户 ID。

repliedCount

repliedCount
public uint repliedCount

回复消息树的回复数量。

message

message
public ZIMMessage message

根消息对象。

ZIMRoomMemberAttributesInfo

房间用户属性信息。

详情

描述房间用户属性的类,包含 UserID 以及其对应的属性。

Declared in ZIMDefines.cs

属性

userID

userID
public string userID

用户 ID。

attributes

attributes
public Record<string, string> attributes

房间用户属性。

ZIMRoomMemberAttributesOperatedInfo

房间用户属性操作信息。

详情

房间用户属性操作信息,包含成功操作的属性与失败的 Key。

Declared in ZIMDefines.cs

属性

attributesInfo

attributesInfo
public ZIMRoomMemberAttributesInfo attributesInfo

房间用户属性信息。

errorKeys

errorKeys
public string[] errorKeys

房间用户属性操作失败的 Key。

ZIMRoomMemberAttributesQueryConfig

房间用户属性查询配置。

详情

房间用户属性查询配置。

Declared in ZIMDefines.cs

属性

nextFlag

nextFlag
public string nextFlag

房间用户属性的查询锚点。

  • 是否必填:非必填,首次默认为空,表示从头开始查询。

count

count
public uint count

分页查询的数量。

  • 是否必填:必填。

ZIMRoomMemberAttributesSetConfig

房间用户属性设置配置。

详情

房间用户属性设置配置,包含可配置用户离开后是否保留用户属性等。

  • 业务场景:开发者可以在设置房间用户属性时,根据自身的实际应用场景选择使用。

Declared in ZIMDefines.cs

属性

isDeleteAfterOwnerLeft

isDeleteAfterOwnerLeft
public bool isDeleteAfterOwnerLeft

配置房间用户属性在用户离开房间后,是否保存下来。

  • 是否必填:非必填。
  • 默认值:true。

ZIMRoomMemberAttributesUpdateInfo

房间用户属性更新信息。

详情

房间用户属性更新信息。

Declared in ZIMDefines.cs

属性

attributesInfo

attributesInfo
public ZIMRoomMemberAttributesInfo attributesInfo

房间用户属性。

ZIMRoomMemberInfo

房间用户信息。

详情

描述房间用户的类。

Declared in ZIMDefines.cs

属性

userID

userID
public string userID

用户 ID,由开发者自定义生成。

  • 是否必填:必填。
  • 取值范围:最大 32 字节的字符串。仅支持数字,英文字符 和 '!', '#', '$', '%', '&', '(', ')', '+', '-', ':', ';', '<', '=', '.', '>', '?', '@', '[', ']', '^', '_', '{', '}', '|', '~'。
  • 隐私保护声明:不要传入涉及个人隐私的敏感信息,包括但不限于手机号、身份证号、护照编号、真实姓名等。
  • 注意事项:注意 userID 在同一个 appID 下需唯一,否则会出现互踢的情况。 强烈建议 userID 与业务 APP 的用户 ID 一一对应,即一个 userID 与一个真实用户是固定且唯一的,而不应该是以随机的 userID 的方式传给 SDK 的方式。因为唯一且固定的 userID 可以让 ZEGO 技术人员快速定位线上问题。

userName

userName
public string userName

用户 name,由开发者自定义生成。

  • 是否必填:非必填。
  • 取值范围:2.0.0 及以后版本,支持最大 256 字节的字符串。
  • 隐私保护声明:不要传入涉及个人隐私的敏感信息,包括但不限于手机号、身份证号、护照编号、真实姓名等。

userAvatarUrl

userAvatarUrl
public string userAvatarUrl

用户头像,由开发者自定义生成。

  • 是否必填:非必填。
  • 取值范围:特殊字符不受限制,最大长度为500字节。
  • 隐私保护声明:不要传入涉及个人隐私的敏感信息,包括但不限于手机号、身份证号、护照编号、真实姓名等。
  • 支持版本:2.13.0 及以上。
  • 注意事项:房间成员列表需要在 2.18.0 版本后才会返回该值。

userExtendedData

userExtendedData
public string userExtendedData

用户的扩展字段信息。

  • 注意事项:仅房间用户时,该属性有值。

ZIMRoomOperatedInfo

房间操作信息。

详情

房间操作信息。

Declared in ZIMDefines.cs

属性

userID

userID
public string userID

操作者的 UserID。

ZIMSelfUserInfo

携带当前用户的用户信息、规则。

详情

携带当前用户的用户信息、规则。

Declared in ZIMDefines.cs

属性

userRule

userRule
public ZIMUserRule userRule

当前用户的规则,设置信息。

userFullInfo

userFullInfo
public ZIMUserFullInfo userFullInfo

当前用户的个人信息。

ZIMSelfUserRule

用户自身的规则类。

Declared in ZIMDefines.cs

属性

offlinePushRule

offlinePushRule
public ZIMUserOfflinePushRule offlinePushRule

用户当前的规则信息。

ZIMUserOfflinePushRule

用户离线推送规则的数据类。

详情

用户离线推送规则的数据类。

Declared in ZIMDefines.cs

属性

onlinePlatforms

onlinePlatforms
public List\<int> onlinePlatforms

与该数据类中的 notToReceiveOfflinePushPlatforms 成员变量搭配使用。onlinePlatforms 指定的平台在线时,notToReceiveOfflinePushPlatforms 指定的平台将不会收到离线推送。

  • 取值范围:请填入 ZIMPlatformType 枚举中平台对应的枚举值。

notToReceiveOfflinePushPlatforms

notToReceiveOfflinePushPlatforms
public List\<int> notToReceiveOfflinePushPlatforms

与该数据类中的 onlinePlatforms 成员变量搭配使用。onlinePlatforms 指定的平台在线时,notToReceiveOfflinePushPlatforms 指定的平台将不会收到离线推送。

  • 取值范围:请填入 ZIMPlatformType 枚举中平台对应的枚举值。

ZIMVideoMessage

视频消息对象。

详情

标识一条视频消息。

  • 使用限制:仅支持视频编码格式为 H264 和 H265 的视频文件在消息发送成功后获取该视频首帧的宽、高信息。
  • 注意事项:回调时若基类的 Type 参数为 Video,可将基类消息对象强转为此类。

Declared in ZIMDefines.cs

属性

videoDuration

videoDuration
public ulong videoDuration

视频文件的时长。

  • 是否必填:发送本地视频时,发送端必填,不填会导致视频消息发送失败。

videoFirstFrameLocalPath

videoFirstFrameLocalPath
public string videoFirstFrameLocalPath

视频文件的首帧图本地路径。

  • 是否必填:发送端不需要填,当调用 [downloadMediaFile] 下载之后, SDK 会生成该值。

videoFirstFrameDownloadUrl

videoFirstFrameDownloadUrl
public string videoFirstFrameDownloadUrl

视频文件的缩略图外部下载 URL。当开发者将首帧图上传到自己的服务器上时,可以通过该字段让 SDK 透传到其他用户中。

  • 是否必填:发送端选填,当 fileDownloadUrl 填入后,该字段才生效。

videoFirstFrameWidth

videoFirstFrameWidth
public uint videoFirstFrameWidth

视频首帧宽度。在 2.19.0 版本后对于透传图片消息(即该 URL 由客户自行传入的情况)支持传入,ZIM 会做透传处理;对于本地图片消息如果传入,ZIM 会在发送时检查是否正确,如果不正确将会自动纠正。

  • 业务场景:用户需要绘出图片 UI 时,用于确定视频首帧宽度的参数,单位为像素。

videoFirstFrameHeight

videoFirstFrameHeight
public uint videoFirstFrameHeight

视频首帧高度。在 2.19.0 版本后对于透传图片消息(即该 URL 由客户自行传入的情况)支持传入,ZIM 会做透传处理;对于本地图片消息如果传入,ZIM 会在发送时检查是否正确,如果不正确将会自动纠正。

  • 业务场景:用户需要绘出图片 UI 时,用于确定视频首帧高度的参数,单位为像素。

videoFirstFrameSize

videoFirstFrameSize
public CGSize videoFirstFrameSize

视频首帧宽高。在 2.19.0 版本后对于透传图片消息(即该 URL 由客户自行传入的情况)支持传入,ZIM 会做透传处理;对于本地图片消息如果传入,ZIM 会在发送时检查是否正确,如果不正确将会自动纠正。

  • 业务场景:用户需要绘出图片 UI 时,用于确定视频首帧宽高的参数。

fileLocalPath

fileLocalPath
public string fileLocalPath

媒体消息的文件的本地绝对路径。

  • 是否必填:如果发送本地文件,则发送端必填,否则消息会发送失败。

fileDownloadUrl

fileDownloadUrl
public string fileDownloadUrl

媒体消息的外部下载 URL,用于开发者将媒体文件上传到自己的服务器中时,通过填入该 URL 让 SDK 透传到其他用户中。

  • 是否必填:如果发送的是外部 URL,发送端必填。

fileUID

fileUID
public string fileUID

媒体文件的唯一 ID。

  • 是否必填:发送端不需要填,该值由 SDK 生成。

fileName

fileName
public string fileName

媒体文件的文件名。

  • 是否必填:如果发送的是外部 URL,则需要填写该值,且需要包含文件扩展名。如果发送的是本地文件,该值选填。

fileSize

fileSize
public ulong fileSize

媒体文件的大小。

  • 是否必填:发送端不需要填,该值由 SDK 生成。

type

type
public ZIMMessageType type

消息类型。

messageID

messageID
public long messageID

标识这条消息的唯一 ID。

  • 业务场景:可用于索引其他消息。
  • 注意事项:开发者主动创建一条消息时,不需要修改这个参数,此参数仅在回调时有值。

timestamp

timestamp
public ulong timestamp

标识一条消息的发送时间。

  • 业务场景:用于呈现一条消息的发送时间,并可用于消息排序。
  • 注意事项:此为标准 UNIX 时间戳,单位为毫秒。

message_length

message_length
public uint message_length

消息的长度。如果此消息的类型为 Text 文本消息,则应当为字符串的长度。

  • 是否必填:必填。

senderUserID

senderUserID
public string senderUserID

展示本条消息发送者的 userID。

conversationID

conversationID
public string conversationID

会话的 ID,相同会话类型下的 ID 是唯一的。

direction

direction
public ZIMMessageDirection direction

用于描述消息的方向是发送还是接收。

sentStatus

sentStatus
public ZIMMessageSentStatus sentStatus

描述消息的发送状态。

conversationType

conversationType
public ZIMConversationType conversationType

该消息所属会话的类型。

conversationSeq

conversationSeq
public ulong conversationSeq

表示该消息在会话中的序号。

orderKey

orderKey
public long orderKey

orderKey 越大消息越新,可用于消息排序。

localMessageID

localMessageID
public long localMessageID

SDK 本地生成的 MessageID,开发者无需关注。

isUserInserted

isUserInserted
public bool isUserInserted

该消息是否是开发者通过 [insertMessageToLocalDB] 接口插入的消息。

  • 默认值:false。

receiptStatus

receiptStatus
public ZIMMessageReceiptStatus receiptStatus

描述该消息的回执状态。

  • 业务场景:用于在回执消息中,判断当前消息是处于什么状态。

extendedData

extendedData
public string extendedData

消息拓展字段。

  • 业务场景:可为消息附加拓展字段,然后发送给对端。
  • 是否必填:否。
  • 支持版本:2.6.0 及以上。
  • 注意事项:长度为1k,可联系技术支持进行配置。

localExtendedData

localExtendedData
public string localExtendedData

仅本端可见的消息拓展字段,可附带额外的信息存储到本地,可通过 [updateMessageLocalExtendedData] 修改,目前长度的限制是 128K。如有特殊需求,可联系 ZEGO 技术支持进行配置。

isBroadcastMessage

isBroadcastMessage
public bool isBroadcastMessage

该消息是否是全员推送消息。

  • 是否必填:SDK内部赋值。

isMentionAll

isMentionAll
public bool isMentionAll

是否需要提醒所有人。业务表现可为“@所有人”。

  • 业务场景:例如在群或者房间可使用。
  • 是否必填:否。
  • 默认值:false。
  • 建议值:如果需要提醒所有人,可以设置为 true。
  • 注意事项:该值并不会在消息文本上增加 @所有人 的字样,需要开发者自行实现。

支持版本 : 2.14.0 及以上。

mentionedUserIDs

mentionedUserIDs
public ArrayList\<String> mentionedUserIDs

提醒一批相关的用户。业务表现可为“@某用户”。

  • 业务场景:发消息时可以带上
  • 是否必填:否。
  • 注意事项:该值并不会在消息文本上增加 @某用户 的字样,需要开发者自行实现。

支持版本 : 2.14.0 及以上。

messageSeq

messageSeq
public ulong messageSeq

表示该消息在会话中的序号。

rootRepliedCount

rootRepliedCount
public uint rootRepliedCount

回复消息树对应的根消息的回复消息数量。

repliedInfo

repliedInfo
public ZIMMessageRepliedInfo repliedInfo

回复消息引用的源消息的信息。

editorUserID

editorUserID
public string editorUserID

本条消息最新的编辑者的 userID。

editedTime

editedTime
public ulong editedTime

本条消息最新的编辑时间戳。

isGroupTargetedMessage

isGroupTargetedMessage
public bool isGroupTargetedMessage

标识该消息是否为群定向消息。

ZIMVideoMessageLiteInfo

视频消息的简要信息对象。

详情

标识一条视频消息。

  • 使用限制:仅支持视频编码格式为 H264 和 H265 的视频文件在消息发送成功后获取该视频首帧的宽、高信息。

Declared in ZIMDefines.cs

属性

videoDuration

videoDuration
public ulong videoDuration

视频文件的时长。

  • 是否必填:发送本地视频时,发送端必填,不填会导致视频消息发送失败。

videoFirstFrameLocalPath

videoFirstFrameLocalPath
public string videoFirstFrameLocalPath

视频文件的首帧图本地路径。

  • 是否必填:发送端不需要填,当调用 [downloadMediaFile] 下载之后, SDK 会生成该值。

videoFirstFrameDownloadUrl

videoFirstFrameDownloadUrl
public string videoFirstFrameDownloadUrl

视频文件的缩略图外部下载 URL。当开发者将首帧图上传到自己的服务器上时,可以通过该字段让 SDK 透传到其他用户中。

  • 是否必填:发送端选填,当 fileDownloadUrl 填入后,该字段才生效。

videoFirstFrameWidth

videoFirstFrameWidth
public uint videoFirstFrameWidth

视频首帧宽度。

  • 业务场景:用户需要绘出图片 UI 时,用于确定视频首帧宽度的参数,单位为像素。

videoFirstFrameHeight

videoFirstFrameHeight
public uint videoFirstFrameHeight

视频首帧高度。

  • 业务场景:用户需要绘出图片 UI 时,用于确定视频首帧高度的参数,单位为像素。

fileLocalPath

fileLocalPath
public string fileLocalPath

媒体消息的文件的本地绝对路径。

  • 是否必填:如果发送本地文件,则发送端必填,否则消息会发送失败。

fileDownloadUrl

fileDownloadUrl
public string fileDownloadUrl

媒体消息的外部下载 URL,用于开发者将媒体文件上传到自己的服务器中时,通过填入该 URL 让 SDK 透传到其他用户中。

  • 是否必填:如果发送的是外部 URL,发送端必填。

fileName

fileName
public string fileName

媒体文件的文件名。

  • 是否必填:如果发送的是外部 URL,则需要填写该值,且需要包含文件扩展名。如果发送的是本地文件,该值选填。

fileSize

fileSize
public ulong fileSize

媒体文件的大小。

  • 是否必填:发送端不需要填,该值由 SDK 生成。

ZIMVoIPConfig

提供发起 iOS VoIP 离线推送类型的信息。

详情

提供发起 iOS VoIP 离线推送类型的信息。

Declared in ZIMDefines.cs

属性

iOSVoIPHandleType

iOSVoIPHandleType
public ZIMCXHandleType iOSVoIPHandleType

VoIP 发起方联系信息类型,默认为不指定类型。

iOSVoIPHandleValue

iOSVoIPHandleValue
public string iOSVoIPHandleValue

VoIP 发起方联系信息内容,与 iOSVoIPHandleType 相关。当 iOSVoIPHandleType 为 PhoneNumber 时,Value 为一串数字;当 iOSVoIPHandleType 为 EmailAddress 时,Value 为电子邮箱地址;当联系信息为其他类型时,Value 通常遵循某种特定格式,如用户名、数字 ID 或 URL。

iOSVoIPHasVideo

iOSVoIPHasVideo
public bool iOSVoIPHasVideo

是否为视频通话,默认为音频。

上一篇

Interface

下一篇

Enum