Function Overview
2026-01-23
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.
SDK Initialization Related Functions
| 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. |
| queryPinnedMessageList | Query pinned message list. |
| 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. |