Documentation
In-app Chat
Function Overview
Function overview

Function Overview

Last updated：2025-03-21 20:56

ZEGO ZIM SDKs provide rich APIs for you to quickly build in app chat capabilities into your applications.

ZEGO ZIM SDKs are available for all major platforms, including Android, iOS, Mac, Windows, and Web.

Method	Description
Create	Create a ZIM instance.
GetVersion	Gets the SDK's version number.
GetInstance	Get the ZIM singleton object.
SetLogConfig	Set log related configuration.
SetCacheConfig	Set cache related configuration.
Login	Login, you must log in before using all functions.
Login	Login, you must log in before using all functions.
RenewToken	Update the authentication token.
QueryUsersInfo	Query user information.
UpdateUserName	Update user's user name.
UpdateUserAvatarUrl	Update user's avatar URL.
UpdateUserExtendedData	Update user's user extended data.
UploadLog	Upload log and call after setting up log path.
Logout	Log out of ZIM service.
Destroy	Destroy the ZIM instance.
OnError	The callback for error information.
OnTokenWillExpire	A reminder callback that the token is about to expire.
OnUserInfoUpdated	Callback for user information update.
OnUserRuleUpdated	Callback of user rule changes.

Room functions

Method	Description
CreateRoom	Create and join a room.
QueryRoomMembers	Query the information of up to ten users in the specified room.
SetRoomMembersAttributes	Set room member attributes (use this for all additions and changes).
QueryRoomMembersAttributes	Batch query the room user attributes of the members in the room.
QueryRoomMemberAttributesList	paginate the room user properties that have room property members in the room.
CreateRoom	Create a room with advanced settings
EnterRoom	Enter the room. If the room does not exist, it will be created automatically.
JoinRoom	Join a room.
LeaveRoom	Leave a room.
QueryRoomMemberList	Query the list of members in the room.
QueryRoomOnlineMemberCount	Query the number of online members in the room.
QueryRoomAllAttributes	Query all properties of the room.
SetRoomAttributes	Set room attributes (use this for all additions and changes).
DeleteRoomAttributes	Delete room attributes.
BeginRoomAttributesBatchOperation	Open combination room attribute operation.
EndRoomAttributesBatchOperation	Complete the property operation of the combined room.
OnReceiveRoomMessage	The callback for receiving room message.
OnRoomStateChanged	event callback when the room connection status changes.
OnRoomMemberJoined	Callback when other members join the room.
OnRoomMemberLeft	Callback when other members leave the room.

Message functions

Method	Description
SendMessage	send message.
SendMediaMessage	Send media messages.
InsertMessageToLocalDB	Insert a message to the local DB.
SendConversationMessageReceiptRead	Sets all received receipts for the conversation as read.
SendMessageReceiptsRead	Set the receipt of a batch of messages to become read.
QueryMessageReceiptsInfo	Query the receipt information of a batch of messages.
QueryGroupMessageReceiptReadMemberList	Query the list of read members of the group
QueryGroupMessageReceiptUnreadMemberList	Query the list of read members of the group.
SearchLocalMessages	Search local message list.
SearchLocalConversations	Search local conversations on local messages.
SearchGlobalLocalMessages	Search global local message list.
ReplyMessage	send reply message.
DownloadMediaFile	Download media file message content.
DownloadMediaFile	Download media message content.
QueryHistoryMessage	Query historical messages.
RevokeMessage	revoke message.
DeleteMessages	delete message.
AddMessageReaction	add message reaction
DeleteMessageReaction	delete message reaction
QueryMessageReactionUserList	query message reaction userlist
DeleteAllMessage	Delete all message.
UpdateMessageLocalExtendedData	Update the local expandable field of the message.
OnMessageRevokeReceived	The callback for receiving revoke message.
OnMessageSentStatusChanged	The callback for received message send status change.
OnBroadcastMessageReceived	The callback of the broadcast message received by all employees.
OnMessageReactionsChanged	The callback of the reactions change.
OnMessageDeleted	Callback when the message is deleted.
OnReceivePeerMessage	The callback for receiving peer-to-peer message.
OnMessageRepliedCountChanged	Reply to the event that the number of message trees has changed.
OnMessageRepliedInfoChanged	The reply information of a reply message is changed.
OnReceiveGroupMessage	The callback for receiving group message.

Group functions

Method	Description
CreateGroup	Create groups.
SearchLocalGroups	Search local groups.
SearchLocalGroupMembers	Search local group members.
CreateGroup	Create a group with the andvanced info such as group attributes and group notice.
JoinGroup	join a goup.
LeaveGroup	Leave the group.
DismissGroup	Disband the group.
KickGroupMembers	kick some members out of the group.
InviteUsersIntoGroup	invite some members into the group.
TransferGroupOwner	Transfer the group owner.
UpdateGroupName	Update the group name.
UpdateGroupAvatarUrl	Update the group avatar URL.
UpdateGroupNotice	Update group announcements.
QueryGroupInfo	Query group information.
QueryGroupList	Query group list.
SetGroupAttributes	Add or update group attributes.
DeleteGroupAttributes	Delete group attribute.
QueryGroupAttributes	Query group attributes by keys.
QueryGroupAllAttributes	Query all attributes of the group.
SetGroupMemberRole	Set the group member role.
SetGroupMemberNickname	Set group member nickname.
QueryGroupMemberInfo	Query group member information.
QueryGroupMemberList	Query the list of group members.
QueryGroupMemberCount	Query the number of group members in a specified group.
OnGroupStateChanged	Group state change notification callback.
OnGroupNameUpdated	Group name update notification callback.
OnGroupAvatarUrlUpdated	Group avatar URL update notification callback.
OnGroupNoticeUpdated	Notification callback for group announcement updates.
OnGroupAttributesUpdated	Group property update attributes callback.
OnGroupMemberStateChanged	Group member state change notification callback.
OnGroupMemberInfoUpdated	Group member basic information change notification.

Conversation functions

Method	Description
QueryConversation	Query a conversation by conversation ID and conversation type.
QueryConversationList	Query the conversation list.
QueryConversationPinnedList	Query the conversation pinned list.
UpdateConversationPinnedState	Modify the conversation pinned state.
DeleteConversation	delete the conversation.
ClearConversationUnreadMessageCount	clear session unreads.
SetConversationNotificationStatus	Set the conversation notification state.
OnConversationChanged	Received notification callback for session update.
OnConversationMessageReceiptChanged	Callback for notifications of read updates for sessions that receive receipts.
OnConversationsAllDeleted	The callback of all conversation deletion was received.
OnMessageReceiptChanged	The notification callback for the read update of the message that received the receipt.
OnConversationTotalUnreadMessageCountUpdated	Notification callback for session total unread updates.

Call Invitation functions

Method	Description
CallInvite	Initiate a call invitation.
CallCancel	Cancel the call invitation.
CallAccept	Accept the call invitation.
CallReject	Reject the call invitation.
CallQuit	Reject the call invitation.
CallEnd	End the call invitation.
CallingInvite	Invite other users to join the call invitation
QueryCallInvitationList	Query call invitation list
OnCallInvitationReceived	The notification callback for the call invitation received by the invitee.
OnCallInvitationCreated	The notification callback for the call invitation created by the caller.
OnCallInvitationCancelled	The notification callback received by the invitee to cancel the invitation.
OnCallInvitationTimeout	Callback for notification of called call invitation timeout.
OnCallInvitationAccepted	The notification callback received by the inviter that invitee has accepted the invitation.
OnCallInvitationRejected	The inviter receives the notification callback that the invitee reject the invitation.
OnCallInviteesAnsweredTimeout	Callback for notification of caller call invitation timeout.
OnCallInvitationEnded	Callback for notification of caller call invitation ended.
OnCallUserStateChanged	Call the notification of the user status in the invitation invitation.