Protocol

• 调用时机：在调用其他成员函数之前，必须先调用此 API 创建出 ZIM 示例。
• 影响范围：不调用此函数将导致其他成员函数无法调用。
• 平台差异：Android 平台下在调用此函数时，除了传入 appID 之外，还必须将 Application 类对象传入。

• 调用时机：在调用其他成员函数之前，必须先调用此 API 创建出 ZIM 示例。
• 影响范围：不调用此函数将导致其他成员函数无法调用。
• 平台差异：Android 平台下在调用此函数时，除了传入 AppID 之外，还必须将 Application 类对象传入。

• 业务场景：1. SDK 在运行过程中，当开发者发现与预期情况不符时，可将问题与相关日志提交给 ZEGO 技术人员定位，ZEGO 技术人员可能需要 SDK 的版本的信息来辅助定位问题。

2. 开发者也可以收集此信息作为 App 所使用的 SDK 的版本信息，以便统计线上各版本 App 对应的各版本 SDK。

• 调用时机：在任意时刻均可调用。

• 调用时机：必须在调用 [create] 创建实例之后，才能调用此函数获取到单例对象，否则将返回 [nil]。
• 相关接口：[create]。

• 默认值：Android：/storage/Android/data/[packageName]/files/ZIMLogs iOS：/Library/Caches/ZIMLogs macOS：（沙箱）/Library/Containers/[Bundle ID]/Data/Library/Caches/ZIMLogs / ；（非沙箱）~/Library/Caches/ZIMLogs Windows：C:\Users[Your UserName]\AppData[App Name]ZEGO.SDK\ZIMLogs
• 调用时机：必须在 [create] 之前调用。
• 生命周期：调用 [create] 之前设置，调用 [create] 时生效。若开发者在下一次 [create] 时没有再设置新的日志配置，则上一次配置依然生效。
• 平台差异：不同平台的默认路径不一样，请参考默认值。
• 相关参考：详细内容请参考 https://doc-zh.zego.im/faq/IM_sdkLog?product=IM&platform=all。

• 业务场景：地理围栏指将即时通信数据传输限定在某一区域，用以满足地区数据隐私安全相关法规，即限定访问某一特定区域的通信服务。
• 调用时机/通知时机：[setGeofencingConfig] 接口需要在 [createWithAppConfig] 接口之前调用。

• 默认值：Android：/storage/Android/data/[packageName]/files/ZIMCaches iOS：/Library/Caches/ZIMCaches macOS：（沙箱）/Library/Containers/[Bundle ID]/Data/Library/Caches/ZIMCaches / （非沙箱）~/Library/Caches/ZIMCaches Windows：C:\Users[Your UserName]\AppData[App Name]ZEGO.SDK\ZIMCaches
• 调用时机：必须在 [create] 之前调用。
• 生命周期：调用 [create] 之前设置，调用 [create] 时生效。若开发者在下一次 [create] 时没有再设置新的缓存配置，则上一次配置依然生效。
• 平台差异：不同平台的默认路径不一样，请参考默认值。

• 调用时机：必须在调用 [create] 创建实例之后，调用 [login] 登录后才可使用。
• 相关回调：[friendListChanged]。

• 业务场景：当需要对一个用户发起好友申请时，可调用此接口。
• 调用时机：通过 [create] 创建 ZIM 实例后可调用。
• 相关回调：[friendApplicationListChanged]。

• 调用时机：必须在调用 [create] 创建实例之后，调用 [login] 登录后才可使用。
• 相关回调：[onFriendListChanged]。

• 调用时机：必须在调用 [create] 创建实例之后，调用 [login] 登录后才可使用。
• 相关回调：[ZIMFriendsRelationCheckedCallback]。

• 调用时机：必须在调用 [create] 创建实例之后，调用 [login] 登录后才可使用。
• 相关回调：[ZIMFriendAliasUpdatedCallback]。

• 调用时机：必须在调用 [create] 创建实例之后，调用 [login] 登录后才可使用。

• 调用时机：必须在调用 [create] 创建实例之后，调用 [login] 登录后才可使用。
• 相关回调：[friendApplicationUpdated]、[friendListChanged]。

• 调用时机：必须在调用 [create] 创建实例之后，调用 [login] 登录后才可使用。
• 相关回调：[ZIMFriendApplicationRejectedCallback]。

• 调用时机：必须在调用 [create] 创建实例之后，调用 [login] 登录后才可使用。
• 相关回调：[ZIMFriendListQueriedCallback]。

• 调用时机：必须在调用 [create] 创建实例之后，调用 [login] 登录后才可使用。
• 相关回调：[ZIMFriendListQueriedCallback]。

• 调用时机：必须在调用 [create] 创建实例之后，调用 [login] 登录后才可使用。
• 相关回调：[ZIMFriendApplicationListQueriedCallback]。

• 调用时机：必须在调用 [create] 创建实例之后，调用 [login] 登录后才可使用。
• 相关回调：[ZIMFriendsSearchedCallback]。

• 调用时机：必须在调用 [createWithAppConfig] 创建实例之后，调用 [loginWithUserID] 登录后才可使用。
• 相关回调：[ZIMBlacklistUsersAddedCallback]。

• 调用时机：必须在调用 [create] 创建实例之后，调用 [login] 登录后才可使用。
• 相关回调：[ZIMBlacklistUsersRemovedCallback]。

• 调用时机：必须在调用 [create] 创建实例之后，调用 [login] 登录后才可使用。
• 相关回调：[ZIMBlacklistQueriedCallback]。

• 调用时机：必须在调用 [create] 创建实例之后，调用 [login] 登录后才可使用。
• 相关回调：[ZIMBlacklistCheckedCallback]。

• 业务场景：您可以通过该接口获得当前用户的用户订阅列表在本地的缓存，方便您了解当前用户订阅了哪些用户，获取订阅用户的订阅过期时间、以及订阅用户上次变更时的状态数据。
• 调用时机/通知时机：登录后即可调用，不受网络状态限制。
• 相关回调：ZIMSubscribedUserStatusListQueriedCallback、subscribeUsersStatus、unsubscribeUsersStatus。
• 相关接口：subscribeUsersStatus、unsubscribeUsersStatus。

• 业务场景：当您不需要持续关注某些用户的在线状态，仅需要单次获取时可以通过该接口向后台做一次查询。
• 调用时机/通知时机：登录后并且网络条件良好的情况下可以调用。
• 相关回调：ZIMUsersStatusQueriedCallback 。

• 业务场景：进入群组/房间/好友列表，需要了解当前哪些房间/群成员/好友在线时，通过该接口进行订阅，成功之后这些用户的用户状态将通过 [userStatusUpdated] 接口回调。
• 调用时机/通知时机：登录成功并且网络条件良好的情况下即可调用。
• 相关回调：[ZIMUsersStatusSubscribedCallback]、[userStatusUpdated]
• 相关接口：[unsubscribeUsersStatus]

• 业务场景：非多端登录场景下，当您离开房间/群组时，如果您短期内不再关注房间/群组成员的用户状态，并且您在进入房间/群组时订阅过房间/群组成员的用户状态，可以通过该接口取消订阅。
• 调用时机/通知时机：登录后，并且网络情况良好时调用。
• 相关回调：ZIMUsersStatusUnsubscribedCallback。
• 相关接口：subscribeUsersStatus、queryUsersStatus、querySubscribedUserStatusList。

• 业务场景：登录后、类似微信用户设置"干饭"、"闭关"等状态、或者类似 QQ 用户设置"请勿打扰"、"忙碌"等状态时，调用该接口来修改当前用户的自定义状态。
• 调用时机/通知时机：在线登录后并且存在连接网络时。
• 相关回调：接口调用成功更新自定义状态后, 多端登录下的其他设备、通过 subscribeUsersStatus 订阅当前用户状态的用户，将会收到 onUserStatusUpdated 并更新当前用户的自定义状态。

• 业务场景：比如多端登录场景下，开发者希望桌面端在线时，移动端不希望收到离线推送，这种场景可以通过调用该接口来实现此功能。
• 调用时机：登录后且网络状态良好的情况下可以调用。
• 影响范围：接口调用成功后，所有端将会收到 userRuleUpdate 通知用户规则发生了更新。
• 相关回调：userRuleUpdate、ZIMUserOfflinePushRuleUpdatedCallback
• 相关接口：querySelfUserInfo

• 业务场景：需要展示自身用户信息、规则时可以调用查询，如进入当前用户的个人页时。
• 调用时机：登录后即可调用。
• 相关回调：ZIMSelfUserInfoQueriedCallback、userInfoUpdated、userRuleUpdated

• 调用时机：必须在调用 [create] 创建实例之后，通过该实例来调用此函数。
• 生命周期：在调用 [create] 之后设置此函数，能正常接收到 ZIM 相关的事件通知；在调用 [destroy] 之后，将不能再收到任何事件通知。

• 调用时机：必须在调用 [create] 创建实例之后，调用其他实例函数之前调用此函数。
• 隐私保护声明：提醒用户尽量不要在 userID 参数里传入涉及个人隐私的敏感信息，包括但不限于手机号、身份证号、护照编号、真实姓名等。
• 相关回调：开发者除了能在 callback 参数中得到登录结果之外，在登录请求中和登录成功/失败后，还将收到 [onConnectionStateChanged] 回调，用于判断当前用户的登录状态。

常见问题解答: 与 ZEGO 的 RTC 登录有什么不同？RTC 的登录指的是登录到房间、ZIM 的登录为登录到账户。

• 相关参考：详情请参考鉴权 Token 生成 https://doc-zh.zego.im/article/11617 。

• 调用时机：必须在调用 [create] 创建实例之后，调用其他实例函数之前调用此函数。
• 隐私保护声明：提醒用户尽量不要在 userID 参数里传入涉及个人隐私的敏感信息，包括但不限于手机号、身份证号、护照编号、真实姓名等。
• 相关回调：开发者除了能在 callback 参数中得到登录结果之外，在登录请求中和登录成功/失败后，还将收到 [onConnectionStateChanged] 回调，用于判断当前用户的登录状态。

常见问题解答: 与 ZEGO 的 RTC 登录有什么不同？RTC 的登录指的是登录到房间、ZIM 的登录为登录到账户。

• 调用时机：必须在调用 [create] 创建实例之后，调用其他实例函数之前调用此函数。
• 隐私保护声明：提醒用户尽量不要在 userID 参数里传入涉及个人隐私的敏感信息，包括但不限于手机号、身份证号、护照编号、真实姓名等。
• 相关回调：开发者除了能在 callback 参数中得到登录结果之外，在登录请求中和登录成功/失败后，还将收到 [connectionStateChanged] 回调，用于判断当前用户的登录状态。
• 相关参考：详情请参考鉴权 Token 生成 https://doc-zh.zego.im/article/11617 。

• 调用时机：必须在调用 [create] 创建实例之后，通过该实例来调用此函数。
• 生命周期：该函数的生命周期依赖鉴权 Token 的有效期，由开发者业务方自行决定。
• 相关参考：详情请参考鉴权 Token 生成 https://doc-zh.zego.im/article/11617 。

• 调用时机：必须在调用 [create] 创建实例之后，调用 [login] 登录后才可使用。
• 相关回调：[ZIMUsersInfoQueriedCallback]。

• 调用时机/通知时机：用户登录后。
• 隐私保护声明：尽量不要传入涉及个人隐私的敏感信息，包括但不限于手机号、身份证号、护照编号、真实姓名等。
• 相关回调：[ZIMUserNameUpdatedCallback]。
• 相关接口：[updateUserExtendedData] 与 [queryUsersInfo]。

• 调用时机/通知时机：用户登录后。
• 相关回调：[ZIMUserAvatarUrlUpdatedCallback]。
• 相关接口：[queryUsersInfo]。

• 调用时机/通知时机：用户登录后。
• 隐私保护声明：尽量不要传入涉及个人隐私的敏感信息，包括但不限于手机号、身份证号、护照编号、真实姓名等。
• 相关回调：[ZIMUserExtendedDataUpdatedCallback]。
• 相关接口：[updateUserName] 与 [queryUsersInfo]。

• 业务场景：开发者可在 App 提供业务上的“反馈”渠道，当用户反馈的问题属于 ZEGO SDK 时，可调用此函数将 SDK 的本地日志信息上传，并联系 ZEGO 技术支持协助定位用户问题。
• 调用时机：在 [create] 后。
• 相关回调：开发者可以通过 callback 参数获取上传结果。

• 调用时机：必须在调用 [Create] 创建实例之后，通过该实例来调用此函数。
• 相关回调：开发者在登出后，将收到 [connectionStateChanged] 回调，此时登录状态为 [Disconnected]。

• 调用时机：在不需要再使用 ZIM 的时候调用，一般可以在对 ZIM 对象置空之前调用。

• 业务场景：当需要对一个或者多个用户发起邀请时，可调用此接口。
• 调用时机：通过 [create] 创建 ZIM 实例后可调用。
• 相关回调：[ZIMCallInvitationSentCallback]。

• 业务场景：没有加入呼叫的用户加入呼叫，或者已在呼叫内的用户切换主设备。
• 调用时机：需要登录后调用。

• 业务场景：需要取消之前发起的呼叫邀请时，可通过该接口来取消呼叫邀请。
• 调用时机：通过 [create] 创建 ZIM 实例后可调用。
• 相关回调：[ZIMCallCancelSentCallback]。

• 业务场景：ZIM SDK在接受后无相关业务逻辑，开发者可以自定义接受后的开发逻辑，如收到其他主叫发起的邀请后，通过该接口来接受呼叫邀请，之后使用 RTC 开启语音聊天功能。
• 调用时机：通过 [create] 创建 ZIM 实例后可调用。
• 相关回调：[ZIMCallAcceptanceSentCallback]。

• 业务场景：收到其他主叫发起的邀请后，可通过该接口来拒绝呼叫邀请。
• 调用时机：通过 [create] 创建 ZIM 实例后可调用。
• 相关回调：[ZIMCallRejectionSentCallback]。

• 调用时机：呼叫建立后，呼叫状态为 Accepted 的用户可调用此接口。
• 相关回调：[ZIMCallQuitSentCallback]。

• 调用时机：呼叫为进阶模式且用户状态为 "Accepted"。
• 相关回调：[ZIMCallEndSentCallback]。

• 调用时机：调用 [callInviteWithInvitees] 发起进阶模式的呼叫邀请后使用，或被叫接受进阶模式呼叫邀请后。
• 相关回调：[ZIMCallingInvitationSentCallback]。

• 业务场景：用户可通过该查询呼叫邀请列表，用作界面展示或其他功能。
• 调用时机：通过 [create] 创建 ZIM 实例, 登录后可调用。
• 相关回调：[ZIMCallInvitationListQueriedCallback]。

• 业务场景：需要创建多人聊天场景时，可通过该接口创建并加入群组。
• 调用时机：通过 [create] 创建 ZIM 实例并 [login] 登录之后。
• 相关回调：通过 [ZIMGroupCreatedCallback] 回调可拿到创建群组的结果。
• 相关接口：可通过 [joinGroup] 加入群组，[leaveGroup] 离开群组， [dismissGroup] 解散群组。

• 业务场景：当需要通过关键字等配置搜索本地群组时，可以调用该接口进行搜索。
• 调用时机/通知时机：调用 [login] 登录后。
• 相关回调：[ZIMGroupsSearchedCallback]

• 业务场景：当需要通过关键字等配置搜索本地群成员时，可以调用该接口进行搜索。
• 相关回调：[ZIMGroupMembersSearchedCallback]

• 业务场景：需要创建多人聊天场景时，可通过该接口创建并加入群组。
• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。
• 相关回调：通过 [ZIMGroupCreatedCallback] 回调可拿到创建群组的结果。
• 相关接口：可通过 [joinGroup] 加入群组，[leaveGroup] 离开群组， [dismissGroup] 解散群组。

• 业务场景：需要加入多人聊天场景时，可通过该接口加入群组。
• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。
• 相关回调：通过 [ZIMGroupJoinedCallback] 回调可拿到加入房间的结果。
• 相关接口：可通过 [createGroup] 创建群组，[leaveGroup] 离开群组， [dismissGroup] 解散群组。

• 业务场景：需要退出多人聊天场景时，可通过该接口离开群组。
• 调用时机/通知时机：通过 [create] 创建 ZIM 实例后并登录后可调用。
• 相关回调：通过 [ZIMGroupLeftCallback] 回调可拿到离开房间的结果。
• 相关接口：可通过 [createGroup] 创建群组，[joinGroup] 加入群组， [dismissGroup] 解散群组。

• 业务场景：创建多人聊天群组后，不需要在此群组进行聊天互动，可通过此接口解散群组。
• 调用时机：通过 [createGroup] 创建群组后可以调用。
• 相关回调：通过 [ZIMGroupDismissedCallback] 回调可拿到解散房间的结果，通过 [groupStateChanged] 监听回调可拿到房间状态。
• 相关接口：可通过 [createGroup] 创建群组， [joinGroup] 加入群组，[leaveGroup] 离开群组。

• 业务场景：需要将一个或多个用户踢出群组时，可通过此方法实现该功能。
• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。
• 相关回调：通过 [ZIMGroupMemberKickedCallback] 回调可拿到将用户踢出群组的结果。
• 相关接口：可通过 [inviteUsersIntoGroup] 邀请目标用户进入群组。

• 业务场景：需要邀请一个或多个用户邀请加入群组时，可通过此方法实现该功能。
• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。
• 相关回调：通过 [ZIMGroupMemberinvitedCallback] 回调可拿到邀请用户加入群组的结果。
• 相关接口：可通过 [kickGroupMembers] 将目标用户踢出群组。

• 业务场景：在多人群组聊天场景中，可通过该接口转让群主。
• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。
• 相关回调：通过 [ZIMGroupOwnerTransferredCallback] 回调可拿到转让群主的结果。

• 业务场景：如需区分不同的群聊。
• 调用时机：通过 [create] 创建 ZIM 实例并登录后可调用。
• 相关回调：通过 [ZIMGroupAliasUpdatedCallback] 回调可拿到更改群备注的结果。

• 业务场景：创建群组后，用户需要更改群名称。
• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。
• 相关回调：通过 [ZIMGroupNameUpdatedCallback] 回调可拿到更改群名称的结果，通过 [groupNoticeUpdated] 可拿到更新群名称信息。

• 业务场景：创建群组后，群组的管理者需要更改群组禁言状态。
• 调用时机：通过 [create] 创建 ZIM 实例并登录进入群组后可调用。
• 相关回调：通过 [ZIMGroupMutedCallback] 回调可拿到更改群禁言状态的结果，通过 [groupMuteInfoUpdated] 可拿到更新群禁言状态信息。

• 业务场景：创建群组后，用户需要更改群组成员禁言状态。
• 调用时机：通过 [create] 创建 ZIM 实例并登录进入群组后可调用。
• 相关回调：通过 [ZIMGroupMembersMutedCallback] 回调可拿到更改群成员禁言状态的结果，通过 [groupMemberInfoUpdated] 可拿到更新群成员禁言状态信息。

• 业务场景：创建群组后，用户需要更改群头像 URL。
• 调用时机/通知时机：通过 [Create] 创建 ZIM 实例并登录、处于对应群中时可调用。
• 相关回调：通过 [ZIMGroupAvatarUrlUpdatedCallback] 回调可拿到更改群头像的结果，通过 [groupAvatarUrlUpdated] 可拿到更新群头像信息。

• 业务场景：需要在群组中，更新群公告。
• 调用时机/通知时机：通过 [Create] 创建 ZIM 实例并登录后可调用。
• 相关回调：通过 [ZIMGroupNoticeUpdateCallback] 回调可拿到更新群公告的结果，通过 [groupNoticeUpdated] 可拿到更新群公告信息。

• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。

• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。

• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。

• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。

• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。

• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。

• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。

• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。

• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。

• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。

• 业务场景：需获取群组信息进行展示。
• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。
• 相关回调：通过 [ZIMGroupInfoQueriedCallback] 回调可拿到查询群组信息的结果。

• 业务场景：需要获取群列表进行展示。
• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。
• 相关回调：通过 [ZIMGroupListQueriedCallback] 回调查询当前所有群列表的结果。

• 业务场景：新增对群组描述的扩展字段信息，如群的家族、标签、行业类别等。
• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。
• 相关回调：通过 [ZIMGroupAttributesOperatedCallback] 回调可拿到设置群属性的结果。
• 相关接口：可通过 [deleteGroupAttributes] 删除群属性，[queryGroupAttributes] 查询群属性，[queryAllGroupAttributes] 查询全部群属性。

• 业务场景：删除对群组描述的扩展字段信息。
• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。
• 相关回调：通过 [ZIMGroupAttributesOperatedCallback] 回调可拿到删除群属性的结果。
• 相关接口：可通过 [setGroupAttributes] 设置群属性，[queryGroupAttributes] 查询群属性，[queryAllGroupAttributes] 查询全部群属性。

• 业务场景：需要查询指定群属性进行展示的场景。
• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并 [login] 登录之后。
• 相关回调：通过 [ZIMGroupAttributesQuriedCallback] 回调可拿到查询指定群属性的结果。
• 相关接口：[queryAllGroupAttributes] 查询所有群属性。

• 业务场景：需要查询所有群属性进行展示的场景。
• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。
• 相关回调：通过 [ZIMGroupAttributesQuriedCallback] 回调可拿到查询所有群属性的结果。
• 相关接口：[queryGroupAttributes] 查询指定群属性。

• 业务场景：在多人群组中，需要对指定群成员角色进行设置。
• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。
• 相关回调：通过 [ZIMGroupMemberRoleUpdatedCallback] 回调可拿到设置群成员角色的结果。

• 业务场景：需要对群成员设置昵称。
• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。
• 相关回调：通过 [ZIMGroupMemberNicknameUpdatedCallback] 回调可拿到设置群成员昵称的结果。

• 业务场景：需要获取指定群成员信息进行展示或交互。
• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。
• 相关回调：通过 [ZIMGroupMemberInfoQueriedCallback] 回调可拿到查询指定群成员信息的结果。

• 业务场景：需要获取指定群成员列表信息进行展示或交互。
• 调用时机/通知时机：通过 [create] 创建 ZIM 实例并登录后可调用。
• 相关回调：通过 [ZIMGroupMemberListQueriedCallback] 回调可拿到查询群成员列表的结果。

• 业务场景：需要获取指定群禁言成员列表信息进行展示或交互。
• 调用时机：通过 [create] 创建 ZIM 实例并登录且加入群后可调用。
• 相关回调：通过 [ZIMGroupMembersMutedCallback] 回调可拿到查询群禁言成员列表的结果。

• 调用时机：通过 [create] 创建 ZIM 实例并登录后可调用。
• 相关回调：[ZIMGroupMemberCountQueriedCallback]。

• 业务场景：需要得知指定会话的相关信息时，这时可以调用该接口来获得数据源。
• 调用时机/通知时机：登录后可调用。
• 相关回调：[ZIMConversationQueriedCallback]。

• 业务场景：登录后需要展示已有的消息会话，这时可以调用该接口来获得数据源。
• 调用时机/通知时机：登录后可调用。
• 相关回调：[ZIMConversationListQueriedCallback]。
• 相关接口：[deleteConversation] 删除会话；[clearConversationUnreadMessageCount] 清除会话未读数。

• 业务场景：登录后需要展示已有的特定会话，这时可以调用该接口来获得数据源。
• 调用时机/通知时机：登录后可调用。
• 相关回调：[ZIMConversationListQueriedCallback]。

• 业务场景：登录后需要展示已有的置顶消息会话，这时可以调用该接口来获得数据源。
• 调用时机/通知时机：登录后可调用。

• 业务场景：登录后需要展示已有的特定会话未读消息总数，这时可以调用该接口来获得数据源。
• 调用时机/通知时机：登录后可调用。
• 相关回调：[ZIMConversationTotalUnreadMessageCountQueriedCallback]。

• 业务场景：需要修改某个会话置顶状态时，可以调用该接口。
• 调用时机/通知时机：登录后可调用。
• 相关回调：[ZIMConversationPinnedStateUpdatedCallback]。

• 业务场景：在所有会话不再被需要时，若要将所有会话删除，此时可调用该接口实现。
• 调用时机/通知时机：需要删除会话时调用，创建 ZIM 实例后即可调用，登录后生效，登出后失效。
• 影响范围：若所删除会话包含未读消息会触发 [conversationTotalUnreadMessageCountUpdated] 回调，调用成功在多端登录时，其他端会触发 [conversationsAllDeleted] 回调。
• 相关回调：[ZIMConversationsAllDeletedCallback]

• 业务场景：在会话不再被需要时，若要将整个会话删除，此时可调用该接口实现。
• 调用时机/通知时机：需要删除会话时调用,创建 ZIM 实例后即可调用，登录后生效，登出后失效。
• 影响范围：调用成功会触发 deleteConversation 的 callback 回调。若所删除会话包含未读消息会触发 [onConversationTotalUnreadMessageCountUpdated] 回调。
• 相关回调：[ZIMConversationDeletedCallback]

• 业务场景：当需要临时保存用户正在编辑但尚未发送的文本消息，此时可调用该接口实现。
• 调用时机/通知时机：需要设置会话草稿时调用,创建 ZIM 实例后即可调用，登录后生效，登出后失效。
• 影响范围：调用成功会触发 [conversationchanged] 回调。
• 相关回调：[ZIMConversationDraftSetCallback]

• 业务场景：当需要将全部会话未读数清零时，可调用该接口。
• 调用时机/通知时机：需要清除全部会话未读数时调用。
• 影响范围：调用该方法会触发总未读数更新的回调 [conversationTotalUnreadMessageCountUpdated] 。
• 相关回调：[ZIMConversationTotalUnreadMessageCountClearedCallback]。
• 相关接口：[conversationTotalUnreadMessageCountUpdated]。

• 业务场景：当由会话进入聊天页，此时该会话原先的消息未读数需要清零，可调用该接口。
• 调用时机/通知时机：需要清除目标未读数时调用。
• 影响范围：调用该方法会触发总未读数更新的回调 [conversationTotalUnreadMessageCountUpdated] ，会触发会话更新的回调 [conversationChanged] 。
• 相关回调：[ZIMConversationUnreadMessageCountClearedCallback]。
• 相关接口：[conversationTotalUnreadMessageCountUpdated]、[conversationChanged]。

• 业务场景：您需要基于对会话进行标记实现自定义的业务逻辑时。
• 默认值：会话标记默认为空。
• 调用时机：登录并存在有效的会话的前提下，若想要设置或取消设置目标会话的标记，调用该接口。
• 相关回调：[ZIMConversationMarkSetCallback]。

• 业务场景：用户选择消息免打扰，可以调用对应方法，未读数不增加。
• 默认值：消息免打扰默认不开启。
• 调用时机/通知时机：登录并存在目标会话的前提下，若想要开关目标会话的消息免打扰状态，调用该接口。
• 影响范围：使用该方法开启免打扰状态后，收到消息不会触发 [conversationTotalUnreadMessageCountUpdated]。
• 相关回调：[ZIMConversationNotificationStatusSetCallback]。
• 相关接口：[conversationTotalUnreadMessageCountUpdated]。

• 相关接口：[queryHistoryMessage]、[sendMessage]。

• 业务场景：登录后需要向目标用户、目标群聊编辑自己发送成功的消息时，通过该接口编辑。
• 相关回调：[ZIMMessageSendNotification]、[ZIMMessageEditedCallback]、[messageEdited]、[conversationChanged]、[messageRepliedInfoChanged]。
• 相关接口：[queryHistoryMessage]、[sendMessage]。

• 业务场景：登录后需要向目标用户、目标群聊置顶或取消置顶自己发送成功的消息时，通过该接口进行操作。
• 相关回调：[ZIMMessagePinnedCallback]、[onMessagePinStatusChanged]。
• 相关接口：[queryPinnedMessageList]、[sendMessage]。

• 业务场景：登录后需要向目标用户、目标房间、目标群聊发送消息时，通过该接口发送。
• 调用时机：登录后即可调用。
• 相关回调：[ZIMMessageSentCallback]、[ZIMMessageSendNotification]、[receivePeerMessage]、[receiveRoomMessage]、[receiveGroupMessage]、[conversationChanged]、[conversationTotalUnreadMessageCountUpdated]。
• 相关接口：[queryHistoryMessage]、[deleteAllMessage]、[deleteMessages]、[sendMediaMessage].

• 业务场景：登录后需要向目标用户、目标房间以及目标群聊发送媒体消息时，通过本接口发送。
• 调用时机：登录后可调用。
• 影响范围：使用该方法会触发消息接收方的 [receivePeerMessage] / [receiveRoomMessage] / [receiveGroupMessage] 回调，会触发发送方和接收方的 [conversationChanged] 回调，若该消息所在会话未设置消息免打扰，会触发 [conversationTotalUnreadMessageCountUpdated] 回调。
• 相关回调：[ZIMMessageSentCallback]、[ZIMMediaUploadingProgress]、[receivePeerMessage]、[receiveRoomMessage]、[receiveGroupMessage]、 [conversationChanged]、[conversationTotalUnreadMessageCountUpdated]。
• 相关接口：[queryHistoryMessage]、[deleteAllMessage]、[deleteMessages]

• 业务场景：开发者可结合系统消息类型，在客户端将回调通知（例如：邀请某人进群、把某人移出群等），转为系统消息类型，插入本地 DB，以达到系统提示的效果。
• 调用时机/通知时机：登录后可调用。
• 相关回调：[ZIMMessageInsertedCallback]。
• 相关接口：[queryHistoryMessage]、[deleteMessageByConversationID]、[deleteMessages]。

• 业务场景：当需要清理本地消息缓存时，调用该接口。
• 相关回调：[ZIMFileCacheClearedCallback]。

• 业务场景：当需要查询本地消息缓存时，调用该接口。
• 相关回调：[ZIMFileCacheQueriedCallback]。

• 业务场景：当需要导出消息时，调用该接口。
• 相关回调：[ZIMMessageExportedCallback]

• 业务场景：当需要导入消息时，调用该接口。
• 相关回调：[ZIMMessageImportedCallback]

• 业务场景：设置整个会话所有已接收的回执消息已读，会话里消息回执的发送者会从 ZIMEventHandler 收到 [conversationMessageReceiptChanged] 的回调。
• 调用时机/通知时机：登录后即可调用，建议在进入消息列表页面之前调用，在消息列表页面内建议调用 [sendMessageReceiptsRead] 对需要设置已读的消息批量设置。
• 相关回调：[ZIMConversationMessageReceiptReadSentCallback]。
• 相关接口：[sendMessageReceiptsRead] 、[sendMessage] 。

• 业务场景：开发者可通过这个方法，设置一批带回执的消息已经被读了。发送端如果在线，则会收到 [messageReceiptChanged] 的回调。
• 调用时机：登录后可调用。建议在消息列表页对需要设置已读的消息设置。不建议和 [sendConversationMessageReceiptRead] 一起混用。
• 相关回调：[ZIMMessageReceiptsReadSentCallback]。
• 相关接口：[sendMessage].

• 业务场景：如果需要查询消息的回执状态、未读用户数和已读用户数，可以调用此接口。
• 调用时机：登录后可调用。如果需要查询详细的成员列表，则可以通过接口[queryGroupMessageReceiptReadMemberList] 或[queryGroupMessageReceiptUnreadMemberList] 查询。
• 相关回调：[ZIMMessageReceiptsInfoQueriedCallback]。
• 相关接口：[queryGroupMessageReceiptReadMemberList] , [queryGroupMessageReceiptUnreadMemberList]。