Class

2026-01-21


ZIM	ZIMAudio
ZIMAudioEventHandler	ZIMEventHandler
ZPNsManager	ZPNsMessageReceiver

ZIM

详情

ZIM SDK 主类。

Declared in ZIM.java

方法

create

static

create

deprecated

ZIM create(long appID, Application application)

创建 ZIM 实例。

Declared in ZIM.java

参数

名称	类型	描述
appID	long	ZEGO 为开发者签发的应用 ID，请联系 ZEGO 技术支持申请。
application	Application	Android 应用上下文。

详情

创建 ZIM 实例，用于后续调用其他成员函数。

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

支持版本：1.1.0 及以上。
使用限制：当前仅支持创建一个实例，重复调用将返回 [null]。
注意事项：目前 [create] 函数最多只能创建一个实例，若多次调用，则只有第一次返回有效实例，其余都为 [null]。开发者应自行保存 ZIM 实例，并且在使用 ZIM 业务功能的过程中确保实例的生命周期处于可用状态。建议作为单例封装在一个 SDK 管理类中。

已废弃

该函数于 2.3.0 版本被废弃，请使用另一个同名方法 [create]

返回值

ZIM 实例。

create

static

create

ZIM create(ZIMAppConfig appConfig, Application application)

创建 ZIM 实例。

Declared in ZIM.java

参数

名称	类型	描述
appConfig	ZIMAppConfig	ZEGO 为开发者签发的应用 ID 和应用签名，请前往 ZEGO 控制台申请。
application	Application	Android 应用上下文。

详情

创建 ZIM 实例，用于后续调用其他成员函数。

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

支持版本：2.3.0 及以上。
使用限制：当前仅支持创建一个实例，重复调用将返回 [null]。
注意事项：1、目前 [create] 函数最多只能创建一个实例，若多次调用，则只有第一次返回有效实例，其余都为 [null]。开发者应自行保存 ZIM 实例，并且在使用 ZIM 业务功能的过程中确保实例的生命周期处于可用状态；或者也可以在调用了 [create] 之后使用 [getInstance] 获取其单例对象调用其他成员函数。

2、若使用此函数创建实例，必须同时传入 AppID 与 AppSign（Web 平台除外）。

返回值

ZIM 实例。

getVersion

static

getVersion

String getVersion()

获取 SDK 版本号。

Declared in ZIM.java

获取 SDK 版本号。

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

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

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

支持版本：1.1.0 及以上。

SDK 版本号。

getInstance

static

getInstance

ZIM getInstance()

获取 ZIM 单例对象。

Declared in ZIM.java

获取 ZIM 单例对象，用于后续调用其他成员函数。

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

支持版本：2.3.0 及以上。

setLogConfig

static

setLogConfig

void setLogConfig(ZIMLogConfig config)

设置日志相关配置。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMLogConfig	日志配置对象。

详情

设置日志相关配置，包括日志路径与日志大小。由于 SDK 内部有默认的日志路径，因此除非开发者有强烈需要自定义日志路径的需求，否则一般情况下不建议客户自行设置。

默认值：/storage/Android/data/[Application ID]/files/ZIMLogs
调用时机：必须在 [create] 之前调用。
生命周期：调用 [create] 之前设置，调用 [create] 时生效。若开发者在下一次 [create] 时没有再设置新的日志配置，则上一次配置依然生效。
平台差异：不同平台的默认路径不一样，请参考默认值。
相关参考：详细内容请参考 https://doc-zh.zego.im/faq/IM_sdkLog?product=IM&platform=all 。

支持版本：1.1.0 及以上。
注意事项：若开发者在 [create] 之后调用，SDK 则保存此配置，直至等到下一次 [create] 时生效。

setGeofencingConfig

static

setGeofencingConfig

boolean setGeofencingConfig(ArrayList<Integer> areaList, ZIMGeofencingType type)

设置地理围栏相关配置。

Declared in ZIM.java

参数

名称	类型	描述
areaList	ArrayList<Integer>	地理围栏区域列表。最少设置 1 个，最多设置不得大于 SDK 所支持个数。
type	ZIMGeofencingType	地理围栏区域类型。

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

支持版本：2.12.0及以上。
使用限制：如果需要使用地理围栏功能，请联系 ZEGO 技术支持。
注意事项：如需更新地理围栏信息，请调用 [destroy] 接口销毁当前 ZIM 实例，再调用本接口。

返回值

地理围栏设置结果。

setCacheConfig

static

setCacheConfig

void setCacheConfig(ZIMCacheConfig config)

设置缓存相关配置。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMCacheConfig	缓存配置对象。

详情

设置 SDK 缓存文件路径。由于 SDK 内部有默认的路径，因此除非开发者有强烈需要自定义路径的需求，否则一般情况下不建议客户自行设置。

默认值：/storage/Android/data/[Application ID]/files/ZIMCaches
调用时机：必须在 [create] 之前调用。
生命周期：调用 [create] 之前设置，调用 [create] 时生效。若开发者在下一次 [create] 时没有再设置新的缓存配置，则上一次配置依然生效。
平台差异：不同平台的默认路径不一样，请参考默认值。

支持版本：1.1.0 及以上。
注意事项：若开发者在 [create] 之后调用，SDK 则保存此配置，直至等到下一次 [create] 时生效。

addFriend

void addFriend(String userID, ZIMFriendAddConfig config, ZIMFriendAddedCallback callback)

直接添加好友。

Declared in ZIM.java

参数

名称	类型	描述
userID	String	用户ID。
config	ZIMFriendAddConfig	添加好友相关配置。
callback	ZIMFriendAddedCallback	添加好友结果回调。

详情

通过该接口可以将指定 userID 用户添加到好友列表。

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

支持版本：2.14.0 及以上。

返回值

添加好友结果回调。

sendFriendApplication

void sendFriendApplication(String userID, ZIMFriendApplicationSendConfig config, ZIMFriendApplicationSentCallback callback)

发送好友申请。

Declared in ZIM.java

参数

名称	类型	描述
userID	String	用户ID。
config	ZIMFriendApplicationSendConfig	发起好友申请相关配置。
callback	ZIMFriendApplicationSentCallback	发起好友申请结果回调。

详情

当用户需要发起好友申请，可通过 [sendFriendApplication] 向对方发起好友申请。

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

支持版本：2.14.0 及以上。

返回值

发起好友申请结果回调。

deleteFriends

void deleteFriends(ArrayList\<String> userIDs, ZIMFriendDeleteConfig config, ZIMFriendsDeletedCallback callback)

批量删除好友。

Declared in ZIM.java

参数

名称	类型	描述
userIDs	ArrayList<String>	要删除的用户ID列表。
config	ZIMFriendDeleteConfig	删除好友相关配置。
callback	ZIMFriendsDeletedCallback	删除好友结果回调。

详情

通过该接口可以将好友列表中指定用户删除。

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

支持版本：2.14.0 及以上。

返回值

删除好友结果回调。

checkFriendsRelation

void checkFriendsRelation(ArrayList\<String> userIDs, ZIMFriendRelationCheckConfig config, ZIMFriendsRelationCheckedCallback callback)

检查好友关系。

Declared in ZIM.java

参数

名称	类型	描述
userIDs	ArrayList<String>	要检查的用户ID列表。
config	ZIMFriendRelationCheckConfig	检查好友关系相关配置。
callback	ZIMFriendsRelationCheckedCallback	检查好友关系结果回调。

详情

通过该接口可以检查与指定用户之间的好友关系。

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

支持版本：2.14.0 及以上。

返回值

检查好友关系结果回调。

updateFriendAlias

void updateFriendAlias(String friendAlias, String userID, ZIMFriendAliasUpdatedCallback callback)

更新好友备注。

Declared in ZIM.java

参数

名称	类型	描述
friendAlias	String	好友备注。
userID	String	用户 ID。
callback	ZIMFriendAliasUpdatedCallback	更新好友备注结果回调。

详情

通过该接口可以将指定 userID 用户更新备注。

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

支持版本：2.14.0 及以上。

返回值

更新好友备注结果回调。

updateFriendAttributes

void updateFriendAttributes(HashMap<String, String> friendAttributes, String userID, ZIMFriendAliasUpdatedCallback callback)

更新好友属性。

Declared in ZIM.java

参数

名称	类型	描述
friendAttributes	HashMap<String, String>	好友属性。最多设置 5 个。属性的 key 仅支持从 k0 ～ k4 取值。
userID	String	用户 ID。
callback	ZIMFriendAliasUpdatedCallback	更新好友属性结果回调。

详情

通过该接口可以将指定 userID 用户更新好友属性。

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

支持版本：2.14.0 及以上。

返回值

更新好友属性结果回调。

acceptFriendApplication

void acceptFriendApplication(String userID, ZIMFriendApplicationAcceptConfig config, ZIMFriendApplicationAcceptedCallback callback)

接受好友申请。

Declared in ZIM.java

参数

名称	类型	描述
userID	String	用户 ID。
config	ZIMFriendApplicationAcceptConfig	接受好友申请配置。
callback	ZIMFriendApplicationAcceptedCallback	接受好友申请的结果回调。

详情

收到好友申请后，通过该接口接受该好友申请。

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

支持版本：2.14.0 及以上。

返回值

接受好友申请的结果回调。

rejectFriendApplication

void rejectFriendApplication(String userID, ZIMFriendApplicationRejectConfig config, ZIMFriendApplicationRejectedCallback callback)

拒绝好友申请。

Declared in ZIM.java

参数

名称	类型	描述
userID	String	用户 ID。
config	ZIMFriendApplicationRejectConfig	拒绝好友申请配置。
callback	ZIMFriendApplicationRejectedCallback	拒绝好友申请的结果回调。

详情

收到好友申请后，通过该接口拒绝该好友申请。

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

支持版本：2.14.0 及以上。

返回值

拒绝好友申请的结果回调。

queryFriendsInfo

void queryFriendsInfo(ArrayList\<String> userIDs, ZIMFriendsInfoQueriedCallback callback)

批量查询好友信息。

Declared in ZIM.java

参数

名称	类型	描述
userIDs	ArrayList<String>	用户 ID 列表。
callback	ZIMFriendsInfoQueriedCallback	批量查询好友信息的结果回调。

详情

需要查询一批指定好友的信息做展示，可通过该接口查询。

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

支持版本：2.14.0 及以上。

返回值

批量查询好友信息的结果回调。

queryFriendList

void queryFriendList(ZIMFriendListQueryConfig config, ZIMFriendListQueriedCallback callback)

查询好友列表。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMFriendListQueryConfig	查询好友列表配置。
callback	ZIMFriendListQueriedCallback	查询好友列表的返回结果。

详情

需要分页查询好友列表，可通过该接口查询。

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

支持版本：2.14.0 及以上。

返回值

查询好友列表返回结果。

queryFriendApplicationList

void queryFriendApplicationList(ZIMFriendApplicationListQueryConfig config, ZIMFriendApplicationListQueriedCallback callback)

查询好友申请列表。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMFriendApplicationListQueryConfig	查询好友申请列表配置。
callback	ZIMFriendApplicationListQueriedCallback	查询好友申请列表的返回结果。

详情

需要分页查询好友申请列表，可通过该接口查询。

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

支持版本：2.14.0 及以上。

返回值

查询好友申请列表的返回结果。

searchLocalFriends

void searchLocalFriends(ZIMFriendsSearchConfig config, ZIMFriendsSearchedCallback callback)

搜索本地好友。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMFriendsSearchConfig	好友搜索配置。
callback	ZIMFriendsSearchedCallback	搜索本地好友信息返回结果。

详情

通过该接口可以根据关键词搜索本地好友信息。

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

支持版本：2.14.0 及以上。

返回值

搜索本地好友信息返回结果。

addUsersToBlacklist

void addUsersToBlacklist(ArrayList\<String> userIDs, ZIMBlacklistUsersAddedCallback callback)

添加用户到黑名单。

Declared in ZIM.java

参数

名称	类型	描述
userIDs	ArrayList<String>	需要被拉黑的 userID 数组。
callback	ZIMBlacklistUsersAddedCallback	添加用户到黑名单的操作结果回调。

详情

通过该接口可以将指定 userID 用户添加到黑名单。

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

支持版本：2.13.0 及以上。
使用限制：传入的 userID 一次性不能超过 20 个。

removeUsersFromBlacklist

void removeUsersFromBlacklist(List\<String> userIDs, ZIMBlacklistUsersRemovedCallback callback)

将用户移除出黑名单。

Declared in ZIM.java

参数

名称	类型	描述
userIDs	List<String>	需要被解除黑名单的 userID 数组。
callback	ZIMBlacklistUsersRemovedCallback	移除用户出黑名单的操作结果回调。

详情

通过该接口可以将指定 userID 用户移除出黑名单。

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

支持版本：2.13.0 及以上。
使用限制：传入的 userID 一次性不能超过 20 个。

queryBlacklist

void queryBlacklist(ZIMBlacklistQueryConfig config, ZIMBlacklistQueriedCallback callback)

查询黑名单。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMBlacklistQueryConfig	查询黑名单配置。
callback	ZIMBlacklistQueriedCallback	查询黑名单结果回调。

详情

查询黑名单。

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

支持版本：2.13.0 及以上。

checkUserIsInBlacklist

void checkUserIsInBlacklist(String userID, ZIMBlacklistCheckedCallback callback)

检查用户是否在黑名单。

Declared in ZIM.java

参数

名称	类型	描述
userID	String	需要要检查的用户ID信息。
callback	ZIMBlacklistCheckedCallback	黑名单检查结果回调。

详情

通过该接口可以检查某个 userID 是否在黑名单内。

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

支持版本：2.13.0 及以上。

querySubscribedUserStatusList

void querySubscribedUserStatusList(ZIMSubscribedUserStatusQueryConfig config, ZIMSubscribedUserStatusListQueriedCallback callback)

用于查询当前用户用户状态订阅列表。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMSubscribedUserStatusQueryConfig	查询订阅列表有关的相关参数。
callback	ZIMSubscribedUserStatusListQueriedCallback	查询用户状态订阅列表的结果回调。

详情

用于查询当前用户用户状态列表。

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

支持版本：2.18.0
使用限制：非联网查询，没有调用频率限制，获取的数据为 SDK 在本地的缓存，登录后网络条件良好的情况下， SDK 定时向后台同步。

返回值

结果回调。

queryUsersStatus

void queryUsersStatus(ArrayList\<String\> userIDs, ZIMUsersStatusQueriedCallback callback)

批量查询其他用户的用户状态。

Declared in ZIM.java

参数

名称	类型	描述
userIDs	ArrayList<String>	查询目标用户列表。
callback	ZIMUsersStatusQueriedCallback	查询用户状态的回调方法。

详情

批量查询其他用户的用户状态。

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

支持版本：2.18.0
注意事项：不可以查询未注册的用户。

返回值

结果回调。

subscribeUsersStatus

void subscribeUsersStatus(ArrayList\<String\> userIDs, ZIMUserStatusSubscribeConfig config, ZIMUsersStatusSubscribedCallback callback)

订阅其他用户的用户状态。

Declared in ZIM.java

参数

名称	类型	描述
userIDs	ArrayList<String>	被订阅的用户列表。
config	ZIMUserStatusSubscribeConfig	订阅相关的配置项。
callback	ZIMUsersStatusSubscribedCallback	订阅用户状态的操作回调。

详情

通过该接口订阅其他用户的用户状态。

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

支持版本：2.18.0
使用限制：单次订阅用户上限为 100 人，单个用户默认最多可以订阅 3000 人，当订阅人数达到上限后，新订阅的用户将会覆盖最早订阅的用户。
注意事项：不可以通过该接口订阅当前登录用户，被订阅的用户必须已注册。

返回值

结果回调。

unsubscribeUsersStatus

void unsubscribeUsersStatus(ArrayList\<String\> userIDs, ZIMUsersStatusUnsubscribedCallback callback)

用于批量取消订阅当前用户订阅列表中的目标用户。

Declared in ZIM.java

参数

名称	类型	描述
userIDs	ArrayList<String>	批量取消的用户列表。
callback	ZIMUsersStatusUnsubscribedCallback	批量取消的操作结果回调。

详情

批量取消订阅当前用户订阅列表中的目标用户。

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

支持版本：2.18.0
使用限制：单次传入的 userID 列表最大为 100 人。
注意事项：不可以取消不在当前用户订阅列表中的用户。

返回值

结果回调。

updateUserCustomStatus

ZIMUserCustomStatusUpdatedResult updateUserCustomStatus(String customStatus, ZIMUserCustomStatusUpdatedCallback callback)

用于更新用户自定义状态。

Declared in ZIM.java

参数

名称	类型	描述
customStatus	String	详情描述：用户自定义状态，默认最大值为 64 字节，默认过期时间为 1 天，过期后重置为空字符串。登录时，如果该字段为空字符串（默认为空字符串），那么不会修改当前用户的自定义状态。
callback	ZIMUserCustomStatusUpdatedCallback	更新自定义状态的回调。

详情

根据您业务需要，自行设置定义状态，例如请勿打扰、忙碌等。

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

支持版本：2.20.0 以及以后版本。
使用限制：1 次/秒。

返回值

更新自定义状态的异步结果。

updateUserOfflinePushRule

void updateUserOfflinePushRule(ZIMUserOfflinePushRule offlinePushRule, ZIMUserOfflinePushRuleUpdatedCallback callback)

修改离线推送的自定规则

Declared in ZIM.java

参数

名称	类型	描述
offlinePushRule	ZIMUserOfflinePushRule	用户离线推送规则信息，每次调用接口将会使用入参对象的成员属性全量更新。
callback	ZIMUserOfflinePushRuleUpdatedCallback	修改离线推送的结果回调。

详情

通过该接口修改离线推送的自定规则，作用范围为当前用户。

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

支持版本：2.15.0 以及以后版本。

返回值

修改离线推送的结果回调。

querySelfUserInfo

void querySelfUserInfo(ZIMSelfUserInfoQueriedCallback callback)

查询自身用户信息、用户规则。

Declared in ZIM.java

参数

名称	类型	描述
callback	ZIMSelfUserInfoQueriedCallback	查询自身用户信息、用户规则的结果回调。

详情

查询当前用户的信息、用户规则。离线状态下，可以用于查询本地数据。

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

支持版本：2.15.0 及以后版本。

返回值

查询自身用户信息、用户规则的结果回调。

setEventHandler

void setEventHandler(ZIMEventHandler handler)

设置事件通知回调，传 [null] 则清空已设置的回调。

Declared in ZIM.java

参数

名称	类型	描述
handler	ZIMEventHandler	事件通知回调。开发者应根据自身业务场景，重写回调的相关方法以关注特定的通知。

详情

设置事件通知回调，传 [null] 则清空已设置的回调。

调用时机：必须在调用 [create] 创建实例之后，通过该实例来调用此函数。
生命周期：在调用 [create] 之后设置此函数，能正常接收到 ZIM 相关的事件通知；在调用 [destroy] 之后，将不能再收到任何事件通知。
相关参考：详情请参考 https://doc-zh.zego.im/article/api?doc=zim_API~java_android~class~ZIMEventHandler 。

支持版本：1.1.0 及以上。
注意事项：若开发者多次调用此函数将覆盖上一次调用此函数设置的回调。

login

deprecated

void login(ZIMUserInfo userInfo, String token, ZIMLoggedInCallback callback)

Declared in ZIM.java

参数

名称	类型	描述
userInfo	ZIMUserInfo	用于标识用户的信息。包含用户的唯一 ID和用户名。注意 userID 在同一个 appID 下需唯一，否则会出现互踢的情况。注意：不支持通过此接口设置 ZIMUserInfo.userAvatarUrl。
token	String	由开发者业务服务器下发的鉴权 Token，用以保证登录的安全性。Token 有效时长不能超过 24 天。
callback	ZIMLoggedInCallback	开发者可以通过设置该回调来接收登录的状态。

详情

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

支持版本：1.1.0 及以上。
注意事项：在使用 ZIM 的单聊、房间、收发消息等功能之前，必须先调用此函数进行登录，通过登录结果可向用户展示 UI。

已废弃

此 API 自 2.13.0 起已弃用。请使用 [login] 函数代替。

返回值

登录的结果回调。

deprecated

void login(ZIMUserInfo userInfo, ZIMLoggedInCallback callback)

Declared in ZIM.java

参数

名称	类型	描述
userInfo	ZIMUserInfo	用于标识用户的信息。包含用户的唯一 ID和用户名。注意 userID 在同一个 appID 下需唯一，否则会出现互踢的情况。注意：不支持通过此接口设置 ZIMUserInfo.userAvatarUrl。
callback	ZIMLoggedInCallback	开发者可以通过设置该回调来接收登录的状态。

详情

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

支持版本：2.4.0 及以上。
注意事项：在使用 ZIM 的单聊、房间、收发消息等功能之前，必须先调用此函数进行登录，通过登录结果可向用户展示 UI。

已废弃

此 API 自 2.13.0 起已弃用。请使用 [login] 函数代替。

返回值

登录的结果回调。

login

void login(String userID, ZIMLoginConfig config, ZIMLoggedInCallback callback)

Declared in ZIM.java

参数

名称	类型	描述
userID	String	用于标识用户的信息，用户的唯一 ID。
config	ZIMLoginConfig	用于特定登录行为的各项参数。
callback	ZIMLoggedInCallback	开发者可以通过设置该回调来接收登录的状态。

详情

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

支持版本：2.13.0 及以上。
注意事项：在使用 ZIM 的单聊、房间、收发消息等功能之前，必须先调用此函数进行登录，通过登录结果可向用户展示 UI。

返回值

登录的结果回调。

renewToken

void renewToken(String token, ZIMTokenRenewedCallback callback)

更新鉴权 Token。

Declared in ZIM.java

参数

名称	类型	描述
token	String	由开发者业务服务器下发的 Token，用以保证安全性。生成规则详见 ZEGO 官网文档。
callback	ZIMTokenRenewedCallback	更新 Token 的结果的回调。

详情

更新鉴权 Token，使鉴权 Token 在过期之后能够及时更新，以继续正常使用 ZIM 的功能。

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

支持版本：1.1.0 及以上。
注意事项：开发者在收到 [onTokenWillExpire] 回调后，开发者需要及时向自己的鉴权服务器请求重新生成一个 Token。

返回值

更新 Token 的结果的回调。

queryUsersInfo

void queryUsersInfo(ArrayList\<String> userIDs, ZIMUsersInfoQueryConfig config, onUsersInfoQueried callback)

查询用户信息。

Declared in ZIM.java

参数

名称	类型	描述
userIDs	ArrayList<String>	userID 数组。
config	ZIMUsersInfoQueryConfig	查询用户信息配置。
callback	onUsersInfoQueried	查询用户信息的操作回调，返回查询的结果。

详情

通过该接口可以通过 userID 来查询获得对应的 UserInfo。

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

支持版本：2.3.0 及以上。
使用限制：单次调用接口，查询 UserID 不能超过 10 个; 在 10 秒内,多次调用接口,所有查询的 UserID 累计总数不能超过 10 个。

返回值

查询用户信息的结果的回调。

updateUserName

void updateUserName(String userName, ZIMUserNameUpdatedCallback callback)

更新用户的用户名。

Declared in ZIM.java

参数

名称	类型	描述
userName	String	详情描述：需要设置的用户名称。取值范围：2.0.0 及以后版本，支持最大 256 字节的字符串。隐私保护声明：不要传入涉及个人隐私的敏感信息，包括但不限于手机号、身份证号、护照编号、真实姓名等。
callback	ZIMUserNameUpdatedCallback	修改用户名的回调函数。

详情

在用户登录后，调用该接口可以更新用户自身的用户名。

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

支持版本：2.2.0 及以上。
注意事项：该接口不支持修改房间内用户名。

返回值

修改用户名的回调结果。

updateUserAvatarUrl

void updateUserAvatarUrl(String userAvatarUrl, ZIMUserAvatarUrlUpdatedCallback callback)

更新用户的用户头像URL。

Declared in ZIM.java

参数

名称	类型	描述
userAvatarUrl	String	准备修改为的用户头像 URL。
callback	ZIMUserAvatarUrlUpdatedCallback	更新用户头像结果的回调。

详情

在用户登录后，调用该接口可以设置或者更新用户自身的用户头像 URL。

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

支持版本：2.3.0 及以上。
使用限制：无特殊字符限制，最大 500 字节。
注意事项：用户头像本身需要开发者自行存储，ZIM 只作为透传 URL 保存其用户信息。

返回值

修改用户头像 URL 的回调结果。

updateUserExtendedData

void updateUserExtendedData(String extendedData, ZIMUserExtendedDataUpdatedCallback callback)

更新用户的用户扩展字段。

Declared in ZIM.java

参数

名称	类型	描述
extendedData	String	准备修改为的用户扩展字段。
callback	ZIMUserExtendedDataUpdatedCallback	修改用户扩展字段的回调函数。

详情

在用户登录后，调用该接口可以更新用户自身的用户扩展字段。

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

支持版本：2.2.0 及以上。

返回值

修改用户扩展字段的回调结果。

uploadLog

void uploadLog(ZIMLogUploadedCallback callback)

上传日志，设置日志路径和创建实例后调用。

Declared in ZIM.java

参数

名称	类型	描述
callback	ZIMLogUploadedCallback	开发者可以通过设置该回调来接收日志上传的结果。

详情

默认情况下，SDK 会在 App 默认目录创建日志文件并打印，每个日志文件默认最大 5MB，三个日志文件循环覆盖写入。当调用此函数时 SDK 会自动将日志文件打包并上传到 ZEGO 服务器。

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

支持版本：1.2.0 及以上。
使用限制：10分钟内如果反复调用此接口，只有最后一次调用生效。
注意事项：在调用本接口上传日志后，如果过快的调用 [destory] 或退出 App，则可能存在失败的情况。建议等待几秒，等收到上传成功回调后，再调用 [destory] 或退出 App。

返回值

日志上传的结果。

logout

void logout()

登出 ZIM 服务。

Declared in ZIM.java

登出 ZIM 服务。

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

支持版本：1.1.0 及以上。
注意事项：在调用 [logout] 之后，将无法继续使用 ZIM 的单聊、房间、收发消息等功能。若开发者需要再次使用 ZIM 服务，必须先调用 [login] 再次登录。

destroy

void destroy()

销毁 ZIM 实例。

Declared in ZIM.java

释放 ZIM 实例使用的资源，在不再需要使用 ZIM 的时候必须调用此函数释放占用的内存资源，否则可能将发生内存泄漏的情况。

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

支持版本：1.1.0 及以上版本。
注意事项：在调用此函数之后，ZIM 内部功能将不可再使用，且所有回调通知都将不再触发。若需要继续使用 ZIM 功能，则请开发者重新调用 [create] 创建新的实例。

callInvite

void callInvite(ArrayList\<String> invitees, ZIMCallInviteConfig config, ZIMCallInvitationSentCallback callback)

发起呼叫邀请。

Declared in ZIM.java

参数

名称	类型	描述
invitees	ArrayList<String>	被邀请者列表。
config	ZIMCallInviteConfig	呼叫邀请相关配置。
callback	ZIMCallInvitationSentCallback	发起呼叫邀请的回调。

详情

当主叫发起呼叫邀请后，被叫可通过 [callAccept] 来接受呼叫邀请或者 [callReject] 来拒绝邀请。

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

支持版本：2.0.0 及以上。
注意事项：呼叫邀请有超时时间，超时时间到了呼叫邀请将结束，使用 [ZIMCallInviteConfig] 中的 timeout 来控制超时时间，范围为1-600，单位为秒。暂不支持离线呼叫邀请，接收或拒绝后呼叫邀请随即结束。invitees 最多为 9 人。

返回值

发起呼叫的结果回调。

callJoin

void callJoin(String callID, ZIMCallJoinConfig config, ZIMCallJoinSentCallback callback)

加入进阶模式呼叫，或者切换进阶模式呼叫的主设备（仅限多端登录）

Declared in ZIM.java

参数

名称	类型	描述
callID	String	欲加入的进阶模式呼叫邀请 ID。
config	ZIMCallJoinConfig	加入呼叫邀请的相关配置。
callback	ZIMCallJoinSentCallback	加入呼叫或切换主设备的回调。

详情

在实现进阶模式呼叫邀请后，可以调用该接口加入呼叫或者切换主设备。

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

支持版本：2.12.0。

返回值

加入呼叫或切换主设备的回调。

callCancel

void callCancel(List<String> invitees, String callID, ZIMCallCancelConfig config, ZIMCallCancelSentCallback callback)

取消呼叫邀请。

Declared in ZIM.java

参数

名称	类型	描述
invitees	List<String>	被邀请者列表。
callID	String	欲取消的呼叫邀请ID。
config	ZIMCallCancelConfig	取消呼叫邀请的相关配置。
callback	ZIMCallCancelSentCallback	取消呼叫邀请的回调。

详情

当主叫发起呼叫邀请后，在超时时间前可通过该接口取消该呼叫邀请。

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

支持版本：2.0.0 及以上。
注意事项：呼叫邀请的超时时间到后再取消呼叫邀请会失败。

返回值

呼叫取消的结果回调。

callAccept

void callAccept(String callID, ZIMCallAcceptConfig config, ZIMCallAcceptanceSentCallback callback)

接受呼叫邀请。

Declared in ZIM.java

参数

名称	类型	描述
callID	String	欲接受的呼叫邀请 ID。
config	ZIMCallAcceptConfig	接受呼叫邀请的相关配置。
callback	ZIMCallAcceptanceSentCallback	接受呼叫邀请的回调。

详情

当主叫发起呼叫邀请后，被叫可通过该接口接受这次呼叫邀请。

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

支持版本：2.0.0 及以上。
注意事项：被叫接受未被邀请的 callID 会失败。超时后接受会报错。

返回值

接收呼叫的结果回调。

callReject

void callReject(String callID, ZIMCallRejectConfig config, ZIMCallRejectionSentCallback callback)

拒绝呼叫邀请。

Declared in ZIM.java

参数

名称	类型	描述
callID	String	欲拒绝的呼叫邀请ID。
config	ZIMCallRejectConfig	拒绝呼叫邀请的相关配置。
callback	ZIMCallRejectionSentCallback	拒绝呼叫邀请的回调。

详情

当主叫发起呼叫邀请后，被叫可通过该接口拒绝这次呼叫邀请。

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

支持版本：2.0.0 及以上。
注意事项：被叫拒绝未被邀请的callid会失败，ZIM SDK在接受后无相关业务逻辑，开发者可以自定义拒绝后的开发逻辑。

返回值

拒绝呼叫的结果回调。

callQuit

void callQuit(String callID, ZIMCallQuitConfig config, ZIMCallQuitSentCallback callback)

退出当前呼叫邀请。

Declared in ZIM.java

参数

名称	类型	描述
callID	String	欲退出的呼叫邀请ID。
config	ZIMCallQuitConfig	退出呼叫邀请的相关配置。
callback	ZIMCallQuitSentCallback	退出呼叫的回调。

详情

退出进阶模式呼叫。

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

支持版本：2.9.0 及以上。
注意事项：被叫退出未接受的呼叫的 callid 会失败。ZIM SDK 在接受后无相关业务逻辑，开发者可以自定义退出呼叫后的开发逻辑。

返回值

退出呼叫的结果回调。

callEnd

void callEnd(String callID, ZIMCallEndConfig config, ZIMCallEndSentCallback callback)

结束呼叫邀请。

Declared in ZIM.java

参数

名称	类型	描述
callID	String	欲结束的呼叫ID。
config	ZIMCallEndConfig	结束呼叫邀请的相关配置。
callback	ZIMCallEndSentCallback	结束呼叫邀请的回调。

详情

结束进阶模式呼叫。

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

支持版本：2.9.0 及以上。
注意事项：不在呼叫内的用户调用会失败。ZIM SDK 无呼叫结束后的相关业务逻辑，开发者可以自定义结束后的开发逻辑。

返回值

结束呼叫邀请的结果回调。

callingInvite

void callingInvite(ArrayList\<String> invitees, String callID, ZIMCallingInviteConfig config, ZIMCallingInvitationSentCallback callback)

邀请其他用户加入呼叫邀请。

Declared in ZIM.java

参数

名称	类型	描述
invitees	ArrayList<String>	邀请的用户 ID 列表。
callID	String	当前进阶模式呼叫的 callID。
config	ZIMCallingInviteConfig	邀请加入呼叫的相关配置。
callback	ZIMCallingInvitationSentCallback	邀请加入当前呼叫的回调。

详情

在进阶模式下，当主叫发起呼叫邀请后，呼叫内的用户可通过该接口继续邀请其他用户加入呼叫。

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

支持版本：2.9.0 及以上。
注意事项：不在呼叫内的用户调用会失败。ZIM SDK 在接受后无相关业务逻辑，开发者可以自定义加入呼叫后的开发逻辑。呼叫默认最多只能包含 9 名用户。

返回值

邀请加入当前呼叫的结果回调。

queryCallInvitationList

void queryCallInvitationList(ZIMCallInvitationQueryConfig config, ZIMCallInvitationListQueriedCallback callback)

查询呼叫邀请列表。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMCallInvitationQueryConfig	查询呼叫邀请表的相关配置。
callback	ZIMCallInvitationListQueriedCallback	查询呼叫邀请列表的结果回调。

详情

用户可通过该查询呼叫邀请列表。

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

支持版本：2.9.0 及以上。

返回值

查询呼叫邀请列表的结果回调。

createGroup

void createGroup(ZIMGroupInfo groupInfo, List\<String> userIDs, ZIMGroupCreatedCallback callback)

创建并加入一个群组。

Declared in ZIM.java

参数

名称	类型	描述
groupInfo	ZIMGroupInfo	将要被创建的群的配置信息。
userIDs	List<String>	被邀请入群的用户列表。
callback	ZIMGroupCreatedCallback	创建群组的结果的回调。

详情

可调用该接口来创建一个群组，调用该接口的人为该群群主。群名不填则为空字符串。

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

支持版本：2.0.0及以上。
使用限制：登录后可用，登出后不可用。userIDs 最大 100 人。

searchLocalGroups

void searchLocalGroups(ZIMGroupSearchConfig config, ZIMGroupsSearchedCallback callback)

搜索本地群组。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMGroupSearchConfig	搜索群组的配置。
callback	ZIMGroupsSearchedCallback	搜索的结果回调。

详情

该方法用于搜索本地群组。

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

支持版本：2.9.0 及以上。
使用限制：登录后生效，登出后失效。

返回值

搜索的结果回调。

searchLocalGroupMembers

public void searchLocalGroupMembers(String groupID, ZIMGroupMemberSearchConfig config, ZIMGroupMembersSearchedCallback callback)

搜索本地群成员。

Declared in ZIM.java

参数

名称	类型	描述
groupID	String	已加入群组的 ID。
config	ZIMGroupMemberSearchConfig	搜索群成员的配置。
callback	ZIMGroupMembersSearchedCallback	搜索群成员的结果回调。

详情

该方法用于搜索群成员。

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

支持版本：2.9.0 及以上。
使用限制：登录后生效，登出后失效。

返回值

搜索群成员的结果回调。

createGroup

void createGroup(ZIMGroupInfo groupInfo, List<String> userIDs, ZIMGroupAdvancedConfig config, ZIMGroupCreatedCallback callback)

创建并加入一个带群属性的群组。

Declared in ZIM.java

参数

名称	类型	描述
groupInfo	ZIMGroupInfo	将要被创建的群的配置信息。
userIDs	List<String>	被邀请入群的用户列表。
config	ZIMGroupAdvancedConfig	创建群组的相关配置。
callback	ZIMGroupCreatedCallback	创建群组的结果的回调。

详情

可调用该接口来创建一个群组，调用该接口的人为该群群主。

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

支持版本：2.0.0及以上。
使用限制：登录后可用，登出后不可用。 userIDs 最大为 100 人，一个群最大支持 500 人。

返回值

创建群组的结果的回调。

joinGroup

void joinGroup(String groupID, ZIMGroupJoinedCallback callback)

加入群组。

Declared in ZIM.java

参数

名称	类型	描述
groupID	String	将要加入的群组ID。
callback	ZIMGroupJoinedCallback	加入群组的结果的回调。

详情

当一个群组被创建后，其他用户可以通过 [joinGroup] 加入此群组，如果群组不存在，则加入失败。

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

支持版本：2.0.0 及以上。
使用限制：登录后可用，登出后不可用。若已在群中加入会返回加入成功。人满后加入失败。

返回值

加入群组的结果的回调。

leaveGroup

void leaveGroup(String groupID, ZIMGroupLeftCallback callback)

离开群组。

Declared in ZIM.java

参数

名称	类型	描述
groupID	String	将要离开的群组ID。
callback	ZIMGroupLeftCallback	离开群组的结果的回调。

详情

当用户加入一个群组后，用户可以通过该接口离开此群组。

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

支持版本：2.0.0 及以上。
使用限制：登录后可用，登出后不可用。
注意事项：群主退出群组时，群主身份将自动转让给加入本群组最早的那个成员；所有成员退出群组时，群组自动解散。

返回值

离开群组的结果的回调。

dismissGroup

void dismissGroup(String groupID, ZIMGroupDismissedCallback callback)

解散群组。

Declared in ZIM.java

参数

名称	类型	描述
groupID	String	将要解散的群组ID。
callback	ZIMGroupDismissedCallback	解散群组的结果的回调。

详情

当一个群组被创建后，用户可通过 [dismissGroup] 解散此群组。

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

支持版本：2.0.0 及以上。
使用限制：非群主不能解散群。

返回值

解散群组的结果的回调。

kickGroupMembers

void kickGroupMembers(List\<String> userIDs, String groupID, ZIMGroupMemberKickedCallback callback)

踢出群组。

Declared in ZIM.java

参数

名称	类型	描述
userIDs	List<String>	被踢出群的用户列表。
groupID	String	将要踢出成员的群组ID。
callback	ZIMGroupMemberKickedCallback	踢出群组的结果的回调。

详情

当用户加入群组后，可以通过此方法将其踢出群组。

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

支持版本：2.0.0 及以上。
使用限制：非群主不能踢人。
注意事项：该接口无需对方同意，也无需对方在线，踢出后无法接受群相关回调。被踢出后历史消息和会话都会保留，且仍可进入该群。

返回值

踢出群组的结果的回调。

inviteUsersIntoGroup

void inviteUsersIntoGroup(List\<String> userIDs, String groupID, ZIMGroupUsersInvitedCallback callback)

邀请用户进入群组。

Declared in ZIM.java

参数

名称	类型	描述
userIDs	List<String>	被邀请进群的用户列表，单次操作最多支持数量为 100。
groupID	String	将用户邀请进入的群组ID。
callback	ZIMGroupUsersInvitedCallback	邀请用户进入群组的结果的回调。

详情

当需要邀请用户加入群组，可以通过此方法将其邀请加入群组，如果群组不存在，则邀请失败。

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

支持版本：2.0.0 及以上。
使用限制：非群主不能邀请。
注意事项：该接口无需对方同意，也无需对方在线。

返回值

邀请用户进入群组的结果的回调。

transferGroupOwner

void transferGroupOwner(String toUserID, String groupID, ZIMGroupOwnerTransferredCallback callback)

转让群主。

Declared in ZIM.java

参数

名称	类型	描述
toUserID	String	转换后的群主ID。
groupID	String	将要更换群主的群组ID。
callback	ZIMGroupOwnerTransferredCallback	转让群主的结果的回调。

详情

当一个群组被创建后，群主可以通过此方法将群主转让给指定用户。

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

支持版本：2.0.0 及以上。
使用限制：非群主不能转让群主。

返回值

转让群主的结果的回调。

updateGroupAlias

void updateGroupAlias(String groupAlias, String groupID, ZIMGroupAliasUpdatedCallback callback)

更新群备注。

Declared in ZIM.java

参数

名称	类型	描述
groupAlias	String	新的群备注。最大长度 256 字节。
groupID	String	将要被更新群备注的群组 ID。
callback	ZIMGroupAliasUpdatedCallback	更新群备注的结果的回调。

详情

当用户成为某个群的成员后，改用户可通过调用该方法对该群添加/修改备注，群备注仅对修改者生效，不会影响其他群成员。

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

支持版本：2.18.0 及以上。

返回值

更新群备注的结果的回调。

updateGroupName

void updateGroupName(String groupName, String groupID, ZIMGroupNameUpdatedCallback callback)

更新群名称。

Declared in ZIM.java

参数

名称	类型	描述
groupName	String	需要更新的群名称。
groupID	String	将要被更新群名的群组ID。
callback	ZIMGroupNameUpdatedCallback	更新群名称的结果的回调。

详情

当一个群组被创建后，用户可通过调用该方法修改群名称。

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

支持版本：2.0.0 及以上。
使用限制：群成员与群主可修改群名称，名称最大长度100字节。

返回值

更新群名称的结果的回调。

muteGroup

void muteGroup(boolean isMute, String groupID, ZIMGroupMuteConfig config, ZIMGroupMutedCallback callback)

禁言群组。

Declared in ZIM.java

参数

名称	类型	描述
isMute	boolean	标识行为是禁言群组或是解除群组禁言。
groupID	String	将要被更新禁言状态的群组 ID。
config	ZIMGroupMuteConfig	群组禁言配置。
callback	ZIMGroupMutedCallback	更新群组禁言的结果的回调。

详情

当一个群组被创建后，群组的管理者可以调用该接口实行群组禁言与解除群组禁言。

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

支持版本：2.14.0 及以上。
使用限制：仅限群组的管理者可调用。

返回值

更新群禁言状态的结果的回调。

muteGroupMembers

void muteGroupMembers(boolean isMute, ArrayList\<String> userIDs, String groupID, ZIMGroupMemberMuteConfig config, ZIMGroupMembersMutedCallback callback)

禁言群成员。

Declared in ZIM.java

参数

名称	类型	描述
isMute	boolean	标识行为是禁言群组成员或是解除群组成员禁言。
userIDs	ArrayList<String>	需要修改禁言状态的群成员 ID。
groupID	String	将要被更新成员禁言状态的群组 ID。
config	ZIMGroupMemberMuteConfig	群组成员禁言配置。
callback	ZIMGroupMembersMutedCallback	更新群组成员禁言的结果的回调。

详情

当一个群组被创建后，群组的管理者可以调用该接口实行群组成员禁言与解除群组成员禁言。

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

支持版本：2.14.0 及以上。
使用限制：群主与群管理员可调用。

返回值

更新群成员禁言状态的结果的回调。

updateGroupAvatarUrl

void updateGroupAvatarUrl(String groupAvatarUrl, String groupID, ZIMGroupAvatarUrlUpdatedCallback callback)

更新群头像 URL。

Declared in ZIM.java

参数

名称	类型	描述
groupAvatarUrl	String	需要更新的群头像 URL。使用限制: 无特殊字符限制，最大 500 字节。
groupID	String	将要被更新群头像 URL 的群组ID。
callback	ZIMGroupAvatarUrlUpdatedCallback	更新群头像 URL 的结果的回调。

详情

当一个群组被创建后，用户可通过调用该方法修改群头像 URL。

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

支持版本：2.3.0 及以上。
使用限制：群成员与群主可修改群头像，最大长度500字节。

返回值

更新群头像 URL 的结果的回调。

updateGroupNotice

void updateGroupNotice(String groupNotice, String groupID, ZIMGroupNoticeUpdatedCallback callback)

更新群公告。

Declared in ZIM.java

参数

名称	类型	描述
groupNotice	String	预更新的群公告。
groupID	String	将要被更新群公告的群组ID。
callback	ZIMGroupNoticeUpdatedCallback	更新群公告的结果的回调。

详情

当一个群组被创建后，用户可以通过此方法更新群公告。

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

支持版本：2.0.0 及以上。
使用限制：只有群成员才能更新群公告，最大字节数为300字节，无特殊字符限制。

返回值

更新群公告的结果的回调。

updateGroupJoinMode

void updateGroupJoinMode(ZIMGroupJoinMode mode, String groupID, ZIMGroupJoinModeUpdatedCallback callback)

更新入群模式。

Declared in ZIM.java

参数

名称	类型	描述
mode	ZIMGroupJoinMode	加群验证模式。
groupID	String	群组ID。
callback	ZIMGroupJoinModeUpdatedCallback	更新操作的结果的回调。

详情

当一个群组被创建后，群主和管理员可以通过此方法更新入群模式。

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

支持版本：2.15.0 及以上。

返回值

更新操作的结果的回调。

updateGroupInviteMode

void updateGroupInviteMode(ZIMGroupInviteMode mode, String groupID, ZIMGroupInviteModeUpdatedCallback callback)

更新邀请模式。

Declared in ZIM.java

参数

名称	类型	描述
mode	ZIMGroupInviteMode	邀请入群验证模式。
groupID	String	群组ID。
callback	ZIMGroupInviteModeUpdatedCallback	更新操作的结果的回调。

详情

当一个群组被创建后，群主和管理员可以通过此方法更新邀请模式。

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

支持版本：2.15.0 及以上。

返回值

更新操作的结果的回调。

acceptGroupInviteApplication

void acceptGroupInviteApplication(String inviterUserID, String groupID, ZIMGroupInviteApplicationAcceptConfig config, ZIMGroupInviteApplicationAcceptedCallback callback)

同意邀请入群申请。

Declared in ZIM.java

参数

名称	类型	描述
inviterUserID	String	邀请人 ID。
groupID	String	群组ID。
config	ZIMGroupInviteApplicationAcceptConfig	同意邀请入群申请的配置。
callback	ZIMGroupInviteApplicationAcceptedCallback	操作的结果的回调。

详情

当一个群组的 beInviteMode 模式为 Auth 时，群组外部用户收到入群邀请后，可以通过此方接受邀请，成为群组成员。

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

支持版本：2.15.0 及以上。

返回值

操作的结果的回调。

acceptGroupJoinApplication

void acceptGroupJoinApplication(String userID, String groupID, ZIMGroupJoinApplicationAcceptConfig config, ZIMGroupJoinApplicationAcceptedCallback callback)

同意加群申请。

Declared in ZIM.java

参数

名称	类型	描述
userID	String	申请人 ID。
groupID	String	群组ID。
config	ZIMGroupJoinApplicationAcceptConfig	同意加群申请的配置。
callback	ZIMGroupJoinApplicationAcceptedCallback	操作的结果的回调。

详情

当一个群组的 joinMode 为需要 Auth 时，外部用户发出入群申请后，群主或管理员可以通过此方法同意申请。

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

支持版本：2.15.0 及以上。

返回值

操作的结果的回调。

queryGroupApplicationList

void queryGroupApplicationList(ZIMGroupApplicationListQueryConfig config, ZIMGroupApplicationListQueriedCallback callback)

查询入群申请列表。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMGroupApplicationListQueryConfig	查询申请列表的配置。
callback	ZIMGroupApplicationListQueriedCallback	操作的结果的回调。

详情

查询结果包含自己的入群申请和自己被邀请入群的申请。当用户是群主或管理员时，查询结果还会包含他人的入群申请和自己邀请他人入群的申请。

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

支持版本：2.15.0 及以上。

返回值

操作的结果的回调。

rejectGroupInviteApplication

void rejectGroupInviteApplication(String inviterUserID, String groupID, ZIMGroupInviteApplicationRejectConfig config, ZIMGroupInviteApplicationRejectedCallback callback)

拒绝邀请入群申请。

Declared in ZIM.java

参数

名称	类型	描述
inviterUserID	String	邀请人 ID。
groupID	String	群组ID。
config	ZIMGroupInviteApplicationRejectConfig	拒绝邀请入群申请的配置。
callback	ZIMGroupInviteApplicationRejectedCallback	操作的结果的回调。

详情

当一个群组的 beInviteMode 为需要 Auth 时，被邀请入群的用户可以通过此方法拒绝邀请。

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

支持版本：2.15.0 及以上。

返回值

操作的结果的回调。

rejectGroupJoinApplication

void rejectGroupJoinApplication(String userID, String groupID, ZIMGroupJoinApplicationRejectConfig config, ZIMGroupJoinApplicationRejectedCallback callback)

拒绝加群申请。

Declared in ZIM.java

参数

名称	类型	描述
userID	String	申请人 ID。
groupID	String	群组ID。
config	ZIMGroupJoinApplicationRejectConfig	拒绝加群申请的配置。
callback	ZIMGroupJoinApplicationRejectedCallback	操作的结果的回调。

详情

当一个群组的 joinMode 为 Auth 时，群主或管理员可以通过此方法拒绝用户的加群申请。

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

支持版本：2.15.0 及以上。

返回值

操作的结果的回调。

sendGroupInviteApplications

void sendGroupInviteApplications(ArrayList\<String> userIDs, String groupID, ZIMGroupInviteApplicationSendConfig config, ZIMGroupInviteApplicationsSentCallback callback)

发送邀请入群申请。

Declared in ZIM.java

参数

名称	类型	描述
userIDs	ArrayList<String>	被邀请用户列表，单次操作最多支持数量为 20。
groupID	String	群组ID。
config	ZIMGroupInviteApplicationSendConfig	邀请申请的配置。
callback	ZIMGroupInviteApplicationsSentCallback	操作的结果的回调。

详情

当一个群组的被邀请入群验证模式为需要被邀请人审批时，群成员可以通过此方法发送邀请入群。

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

支持版本：2.15.0 及以上。

返回值

操作的结果的回调。

sendGroupJoinApplication

void sendGroupJoinApplication(String groupID, ZIMGroupJoinApplicationSendConfig config, ZIMGroupJoinApplicationSentCallback callback)

发送加群申请。

Declared in ZIM.java

参数

名称	类型	描述
groupID	String	群组ID。
config	ZIMGroupJoinApplicationSendConfig	加群申请配置。
callback	ZIMGroupJoinApplicationSentCallback	操作的结果的回调。

详情

当一个群组的 joinMode 为 Auth 时，用户可以通过此方法申请加入群组。

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

支持版本：2.15.0 及以上。

返回值

操作的结果的回调。

updateGroupBeInviteMode

void updateGroupBeInviteMode(ZIMGroupBeInviteMode mode, String groupID, ZIMGroupBeInviteModeUpdatedCallback callback)

更新邀请目标验证模式。

Declared in ZIM.java

参数

名称	类型	描述
mode	ZIMGroupBeInviteMode	被邀请入群验证模式。
groupID	String	群组ID。
callback	ZIMGroupBeInviteModeUpdatedCallback	更新操作的结果的回调。

详情

当一个群组被创建后，群主和管理员可以通过此方法更新邀请目标入群验证模式。

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

支持版本：2.15.0 及以上。

返回值

更新操作的结果的回调。

queryGroupInfo

void queryGroupInfo(String groupID, ZIMGroupInfoQueriedCallback callback)

查询群组信息。

Declared in ZIM.java

参数

名称	类型	描述
groupID	String	将要被查询群信息的群组ID。
callback	ZIMGroupInfoQueriedCallback	查询群组信息的结果的回调。

详情

查询一个已被创建的群组信息。

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

支持版本：2.0.0 及以上。
使用限制：登录后可用，登出后不可用。

返回值

查询群组信息的结果的回调。

queryGroupList

void queryGroupList(ZIMGroupListQueriedCallback callback)

查询群列表。

Declared in ZIM.java

参数

名称	类型	描述
callback	ZIMGroupListQueriedCallback	查询群列表的结果的回调。

详情

查询当前所有群列表。

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

支持版本：2.0.0 及以上。
使用限制：登录后可用，登出后不可用。

返回值

查询群列表的结果的回调。

setGroupAttributes

void setGroupAttributes(HashMap<String, String> groupAttributes, String groupID, ZIMGroupAttributesOperatedCallback callback)

设置群属性。

Declared in ZIM.java

参数

名称	类型	描述
groupAttributes	HashMap<String, String>	群属性。
groupID	String	被设置群属性的groupID.
callback	ZIMGroupAttributesOperatedCallback	设置群组属性的回调。

详情

当一个群组已存在时，所有该群用户可以该方法设置群属性。

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

支持版本：2.0.0 及以上。
使用限制：只有群成员才可设置群属性。

返回值

设置群组属性的回调。

deleteGroupAttributes

void deleteGroupAttributes(List<String> keys, String groupID, ZIMGroupAttributesOperatedCallback callback)

删除群属性。

Declared in ZIM.java

参数

名称	类型	描述
keys	List<String>	欲删除的群属性的key。
groupID	String	将要被删除群属性的群组ID。
callback	ZIMGroupAttributesOperatedCallback	删除群组属性的结果的回调。

详情

当一个群组已存在时，用户可以调用该方法删除群属性，该接口群主与群内成员均可调用。

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

支持版本：2.0.0 及以上。
使用限制：只有群成员才可删除群属性。

返回值

删除群组属性的结果的回调。

queryGroupAttributes

void queryGroupAttributes(List\<String> keys, String groupID, ZIMGroupAttributesQueriedCallback callback)

查询群属性。

Declared in ZIM.java

参数

名称	类型	描述
keys	List<String>	欲查询的群属性的key。
groupID	String	将要被查询群属性的群组ID。
callback	ZIMGroupAttributesQueriedCallback	查询群属性的结果的回调。

详情

当一个群组被创建后，可以通过此方法查询指定的群属性。

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

支持版本：2.0.0及以上。
使用限制：登录后可用，登出后不可用。

返回值

查询群属性的结果的回调。

queryGroupAllAttributes

void queryGroupAllAttributes(String groupID, ZIMGroupAttributesQueriedCallback callback)

查询群组全部属性。

Declared in ZIM.java

参数

名称	类型	描述
groupID	String	将要被查询全部群属性的群组ID。
callback	ZIMGroupAttributesQueriedCallback	查询群组全部属性的结果的回调。

详情

当一个群组被创建后，可以通过此方法查询所有的群属性。

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

支持版本：2.0.0 及以上。

返回值

查询群组全部属性的结果的回调。

setGroupMemberRole

void setGroupMemberRole(int role, String forUserID, String groupID, ZIMGroupMemberRoleUpdatedCallback callback)

设置群成员角色。

Declared in ZIM.java

参数

名称	类型	描述
role	int	设置的群角色。 - 2: 管理员。 - 3: 普通成员。 - 其他值：可自定义群角色，权限与普通成员一致，建议取值大于 100。
forUserID	String	被设置群角色的用户ID。
groupID	String	将要被设置群角色的群组ID。
callback	ZIMGroupMemberRoleUpdatedCallback	设置群成员角色的结果的回调。

详情

当一个群组被创建后，用户可以通过该方法设置群成员角色。

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

支持版本：2.0.0 及以上。
使用限制：非群主不可用。
注意事项：群主 role 为1 、管理员 role 为 2、普通成员 role 为 3。可调用该接口修改，role 不可修改为 1。如需自定义 role，建议将数值设置为 100 以后，其权限与普通成员一致。

返回值

设置群成员角色的结果的回调。

setGroupMemberNickname

void setGroupMemberNickname(String nickname, String forUserID, String groupID, ZIMGroupMemberNicknameUpdatedCallback callback)

设置群成员昵称。

Declared in ZIM.java

参数

名称	类型	描述
nickname	String	设置的成员昵称。
forUserID	String	被设置群昵称的用户ID。
groupID	String	被设置群成员昵称的群组ID。
callback	ZIMGroupMemberNicknameUpdatedCallback	设置群成员昵称的结果的回调。

详情

当一个群组被创建后，用户可以通过该方法设置群成员昵称。

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

支持版本：2.0.0 及以上。
使用限制：登录后可用，登出后不可用。群主可以修改自己和群内成员的昵称，群内成员只能修改自己的昵称。
注意事项：群成员昵称限制最大长度为 100，无特殊字符限制。

返回值

设置群成员昵称的结果的回调。

queryGroupMemberInfo

void queryGroupMemberInfo(String userID, String groupID, ZIMGroupMemberInfoQueriedCallback callback)

查询群成员信息。

Declared in ZIM.java

参数

名称	类型	描述
userID	String	被查询成员信息的用户ID。
groupID	String	将要被查询成员信息的群组ID。
callback	ZIMGroupMemberInfoQueriedCallback	查询群成员信息的结果的回调。

详情

当一个群组被创建后，用户可以通过该方法查询指定群成员信息。

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

支持版本：2.0.0 及以上。
使用限制：登录后可用，登出后不可用。

返回值

查询群成员信息的结果的回调。

queryGroupMemberList

void queryGroupMemberList(String groupID, ZIMGroupMemberQueryConfig config, ZIMGroupMemberListQueriedCallback callback)

查询群成员列表。

Declared in ZIM.java

参数

名称	类型	描述
groupID	String	将要被查询群成员列表的群组ID。
config	ZIMGroupMemberQueryConfig	群成员查询的配置。
callback	ZIMGroupMemberListQueriedCallback	查询群成员列表的回调。

详情

当一个群组被创建后，用户可以通过该方法查询群成员列表。

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

支持版本：2.0.0 及以上。
使用限制：登录后可用，登出后不可用。

返回值

查询群成员列表的回调。

queryGroupMemberMutedList

void queryGroupMemberMutedList(String groupID, ZIMGroupMemberMutedListQueryConfig config, ZIMGroupMemberMutedListQueriedCallback callback)

查询群禁言成员列表。

Declared in ZIM.java

参数

名称	类型	描述
groupID	String	将要被查询群禁言成员列表的群组ID。
config	ZIMGroupMemberMutedListQueryConfig	群禁言成员查询的配置。
callback	ZIMGroupMemberMutedListQueriedCallback	查询群禁言成员列表的回调。

详情

当一个群组被创建后，用户可以通过该方法查询群禁言成员列表。

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

支持版本：2.14.0 及以上。
使用限制：登录后可用，登出后不可用。

返回值

查询群禁言成员列表的回调。

queryGroupMemberCount

void queryGroupMemberCount(String groupID, ZIMGroupMemberCountQueriedCallback callback)

查询指定群内的群成员数量。

Declared in ZIM.java

参数

名称	类型	描述
groupID	String	需要查询群人数的群的 ID。
callback	ZIMGroupMemberCountQueriedCallback	查询群人数的回调。

详情

用户仅需要展示群内人数且不需要拉取群成员列表时，可通过该接口获取群内人数。

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

支持版本：2.2.0 及以上。
使用限制：该函数仅可查询用户当前已进入的群。

返回值

查询群人数的回调。

queryConversation

void queryConversation(String conversationID, ZIMConversationType conversationType, ZIMConversationQueriedCallback callback)

查询单个会话。

Declared in ZIM.java

参数

名称	类型	描述
conversationID	String	会话ID.
conversationType	ZIMConversationType	会话类型。
callback	ZIMConversationQueriedCallback	会话查询的回调。

详情

该方法可以查询指定会话。

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

支持版本：2.8.0 及以上。
使用限制：没有使用频率的限制,登录后可用，登出后不可用。

返回值

查询会话的结果回调。

queryConversationList

void queryConversationList(ZIMConversationQueryConfig config, ZIMConversationListQueriedCallback callback)

查询会话列表。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMConversationQueryConfig	会话查询的配置。
callback	ZIMConversationListQueriedCallback	会话查询的回调。

详情

该方法可以查询已登录用户的会话列表。

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

支持版本：2.0.0 及以上。
使用限制：没有使用频率的限制,登录后可用，登出后不可用。
注意事项：nextConversation 为查询消息的铆点，首次查询时可以传空，后续查询时可以将最早的一条 conversation 做为 nextconversation 来查询更早以前的会话，分页查询时，[ZIMConversationQueryConfig] 中的 count 填每次拉取的会话数量。

返回值

查询会话列表的结果回调。

queryConversationList

void queryConversationList(ZIMConversationQueryConfig config, ZIMConversationFilterOption option, ZIMConversationListQueriedCallback callback)

按照过滤项查询会话列表。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMConversationQueryConfig	会话查询的配置。
option	ZIMConversationFilterOption	会话列表查询的过滤项。
callback	ZIMConversationListQueriedCallback	会话查询的回调。

详情

该方法可以按照过滤项查询已登录用户的会话列表。

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

支持版本：2.17.0 及以上。
使用限制：没有使用频率的限制,登录后可用，登出后不可用。
注意事项：nextConversation 为查询消息的铆点，首次查询时可以传空，后续查询时可以将最早的一条 conversation 做为 nextconversation 来查询更早以前的会话，分页查询时，[ZIMConversationQueryConfig] 中的 count 填每次拉取的会话数量。

返回值

查询会话列表的结果回调。

queryConversationPinnedList

void queryConversationPinnedList(ZIMConversationQueryConfig config, ZIMConversationPinnedListQueriedCallback callback)

查询置顶会话列表。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMConversationQueryConfig	会话查询的配置。
callback	ZIMConversationPinnedListQueriedCallback	置顶会话列表查询的回调。

详情

该方法可以查询已登录用户的置顶会话列表。

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

支持版本：2.8.0 及以上。
使用限制：没有使用频率的限制，登录后可用，登出后不可用。
注意事项：nextConversation 为查询消息的铆点，首次查询时可以传空，后续查询时可以将最早的一条 conversation 做为 nextConversation 来查询更早以前的会话，分页查询时，[ZIMConversationQueryConfig] 中的 count 填每次拉取的会话数量。

queryConversationTotalUnreadMessageCount

void queryConversationTotalUnreadMessageCount(ZIMConversationTotalUnreadMessageCountQueryConfig config, ZIMConversationTotalUnreadMessageCountQueriedCallback callback)

按照配置项查询会话未读消息总数。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMConversationTotalUnreadMessageCountQueryConfig	会话未读消息总数查询的配置。
callback	ZIMConversationTotalUnreadMessageCountQueriedCallback	会话未读消息总数查询的回调。

详情

该方法可以按照配置项查询已登录用户的会话未读消息总数。

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

支持版本：2.17.0 及以上。
使用限制：没有使用频率的限制,登录后可用，登出后不可用。

返回值

会话未读消息总数查询的回调。

updateConversationPinnedState

void updateConversationPinnedState(boolean isPinned, String conversationID, ZIMConversationType conversationType, ZIMConversationPinnedStateUpdatedCallback callback)

修改会话置顶状态。

Declared in ZIM.java

参数

名称	类型	描述
isPinned	boolean	会话是否置顶，true 为置顶，false 为取消置顶。
conversationID	String	会话 ID。
conversationType	ZIMConversationType	会话类型。
callback	ZIMConversationPinnedStateUpdatedCallback	更新会话置顶的回调。

详情

该方法可以修改已登录用户指定会话的置顶状态。

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

支持版本：2.8.0 及以上。
使用限制：登录后可用，登出后不可用。

deleteAllConversations

void deleteAllConversations(ZIMConversationDeleteConfig config, ZIMConversationsAllDeletedCallback callback)

删除全部会话。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMConversationDeleteConfig	删除全部会话的配置。
callback	ZIMConversationsAllDeletedCallback	删除全部会话的回调。

详情

需要删除会话时，调用此接口,会话内成员均可调用该接口。

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

支持版本：2.12.0 及以上。

返回值

删除全部会话的结果回调。

deleteConversation

void deleteConversation(String conversationID, ZIMConversationType conversationType, ZIMConversationDeleteConfig config, ZIMConversationDeletedCallback callback)

删除会话。

Declared in ZIM.java

参数

名称	类型	描述
conversationID	String	会话ID。
conversationType	ZIMConversationType	会话类型。
config	ZIMConversationDeleteConfig	删除会话的配置。
callback	ZIMConversationDeletedCallback	删除会话的回调。

详情

需要删除某个会话时，调用此接口,会话内成员均可调用该接口。

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

支持版本：2.0.0 及以上。

返回值

删除会话的结果回调。

setConversationDraft

void setConversationDraft(String draft, String conversationID, ZIMConversationType conversationType, ZIMConversationDraftSetCallback callback)

设置会话草稿。

Declared in ZIM.java

参数

名称	类型	描述
draft	String	会话需要设置的文本消息草稿。
conversationID	String	会话 ID。
conversationType	ZIMConversationType	会话类型。仅支持“单聊”和“群聊”会话。
callback	ZIMConversationDraftSetCallback	设置会话草稿的回调。

详情

需要为某个会话设置草稿时，调用此接口,会话内成员均可调用该接口。

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

支持版本：2.14.0 及以上。

返回值

设置会话草稿的回调。

clearConversationTotalUnreadMessageCount

void clearConversationTotalUnreadMessageCount(ZIMConversationTotalUnreadMessageCountClearedCallback callback)

清除全部会话未读数。

Declared in ZIM.java

参数

名称	类型	描述
callback	ZIMConversationTotalUnreadMessageCountClearedCallback	清除全部会话未读数的回调。

详情

用于清除全部会话的未读数。

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

支持版本：2.12.0 及以上。
使用限制：登录后生效，登出后失效。

返回值

清除全部会话未读数的回调。

clearConversationUnreadMessageCount

void clearConversationUnreadMessageCount(String conversationID, ZIMConversationType conversationType, ZIMConversationUnreadMessageCountClearedCallback callback)

清除会话未读数。

Declared in ZIM.java

参数

名称	类型	描述
conversationID	String	会话ID。
conversationType	ZIMConversationType	会话类型。
callback	ZIMConversationUnreadMessageCountClearedCallback	删除会话未读数的回调。

详情

用于清除当前用户目标会话的未读数。

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

支持版本：2.0.0 及以上。
使用限制：登录后生效，登出后失效。

返回值

清除会话未读消息数的结果回调。

setConversationMark

void setConversationMark(Integer markType, boolean enable, ArrayList<ZIMConversationBaseInfo> conversationInfos, ZIMConversationMarkSetCallback callback)

设置或取消设置会话标记。

Declared in ZIM.java

参数

名称	类型	描述
markType	Integer	标记类型。数值范围为 [1, 20]。
enable	boolean	会话标记操作。true 为设置标记，false 为取消标记。
conversationInfos	ArrayList<ZIMConversationBaseInfo>	需要被修改会话标记的会话简要信息列表。最大可传入 100 个会话。
callback	ZIMConversationMarkSetCallback	设置会话标记的回调。

详情

该方法可以对会话设置标记。

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

支持版本：2.17.0 及以上。

返回值

设置会话标记的回调。

setConversationNotificationStatus

void setConversationNotificationStatus(ZIMConversationNotificationStatus status, String conversationID, ZIMConversationType conversationType, ZIMConversationNotificationStatusSetCallback callback)

设置会话通知状态。

Declared in ZIM.java

参数

名称	类型	描述
status	ZIMConversationNotificationStatus	会话通知状态。
conversationID	String	会话ID。当前仅支持为“群组”会话和“单聊”（需 2.14.0 版本或以上SDK）设置免打扰状态。群聊会话时，conversationID 为群组的 groupID。单聊会话时，conversationID 为对端用户的 userID。
conversationType	ZIMConversationType	会话类型。当前仅支持为“群组”会话和“单聊”（需 2.14.0 版本或以上SDK）设置免打扰状态。
callback	ZIMConversationNotificationStatusSetCallback	设置会话通知状态的回调。

详情

该方法可以选择目标会话的未读数是否在收到消息时更新，从而实现免打扰功能。

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

支持版本：2.0.0 及以上。
使用限制：登录后生效，登出后失效。

返回值

设置会话通知状态的结果回调。

cancelSendingMessage

void cancelSendingMessage(ZIMMessage message, ZIMSendingMessageCancelConfig config, ZIMSendingMessageCancelledCallback callback)

取消媒体消息发送。

Declared in ZIM.java

参数

名称	类型	描述
message	ZIMMessage	要取消发送的消息对象。
config	ZIMSendingMessageCancelConfig	取消发送消息的相关配置。
callback	ZIMSendingMessageCancelledCallback	取消发送消息的结果的回调。

详情

此方法可用于取消上传中的本地媒体文件消息的发送。

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

支持版本：2.22.0 及以上。

返回值

取消发送消息的结果的回调。

editMessage

void editMessage(ZIMMessage message, ZIMMessageEditConfig config, ZIMMessageSentFullCallback callback)

编辑消息。

Declared in ZIM.java

参数

名称	类型	描述
message	ZIMMessage	要编辑的消息对象。
config	ZIMMessageEditConfig	编辑消息的相关配置。
callback	ZIMMessageSentFullCallback	消息的编辑结果的回调。

详情

此方法可用于单聊、群聊中编辑自己发送成功的消息。

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

支持版本：2.20.0 及以上。

返回值

消息的编辑结果的回调。

pinMessage

void pinMessage(ZIMMessage message, boolean isPinned, ZIMMessagePinnedCallback callback)

置顶或取消消息。

Declared in ZIM.java

参数

名称	类型	描述
message	ZIMMessage	要置顶或取消置顶的消息对象。
isPinned	boolean	置顶或取消置顶。
callback	ZIMMessagePinnedCallback	置顶或取消置顶结果的回调。

详情

此方法可用于单聊、群聊中置顶或取消置顶自己发送成功的消息。

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

支持版本：2.25.0 及以上。

返回值

消息的置顶或取消置顶结果的回调。

sendMessage

void sendMessage(ZIMMessage message, String toConversationID, ZIMConversationType conversationType, ZIMMessageSendConfig config, ZIMMessageSentCallback callback)

发送消息。

Declared in ZIM.java

参数

名称	类型	描述
message	ZIMMessage	要发送的消息，使用时，请根据消息类型修改 message 的类型。例如，发送文本消息时，请使用 ZIMTextMessage。
toConversationID	String	消息需要发送的会话 ID。
conversationType	ZIMConversationType	会话类型，支持单聊、房间以及群聊。
config	ZIMMessageSendConfig	发送消息的相关配置。
callback	ZIMMessageSentCallback	消息的发送结果的回调。

详情

此方法可用于单聊、房间和群聊中发送消息。

业务场景：登录后需要向目标用户、目标房间、目标群聊发送消息时，通过该接口发送。
调用时机：登录后即可调用。
相关回调：[ZIMMessageSentCallback]、[onReceivePeerMessage]、[onReceiveRoomMessage]、[onReceiveGroupMessage]、[onConversationChanged]、[onConversationTotalUnreadMessageCountUpdated]。
相关接口：[queryHistoryMessage]、[deleteAllMessage]、[deleteMessages]、[sendMediaMessage]。

支持版本：2.4.0 及以上。
使用限制：两次发送消息的间隔要大于 100ms。登录后可用，注销后不可用。

sendMediaMessage

void sendMediaMessage(zim_handle handle, ZIMMediaMessage message, String toConversationID, ZIMConversationType conversationType, ZIMMessageSendConfig config, ZIMMessageSentCallback callback)

发送媒体消息。

Declared in ZIM.java

参数

名称	类型	描述
handle	zim_handle	实例的句柄。
message	ZIMMediaMessage	要发送的消息，使用时，请根据多媒体消息类型，修改 message 的类型。例如，发送图片消息时，请使用 ZIMImageMessage。
toConversationID	String	消息接收方的会话 ID，支持单聊、房间以及群聊。
conversationType	ZIMConversationType	会话类型，支持单聊、房间以及群聊。
config	ZIMMessageSendConfig	发送消息的相关配置。
callback	ZIMMessageSentCallback	发送媒体消息的结果回调。

详情

该方法可用于发送单聊、房间以及群聊消息。

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

支持版本：2.4.0 及以上。
使用限制：不得超过10条/s，登录后可用，登出后不可用；仅支持视频编码格式为 H264 和 H265 的视频文件在消息发送成功后获取该视频首帧的宽、高信息。
注意事项：pushconfig 只有需要使用离线推送功能时才需要填写。若向房间发送媒体消息，则不支持离线推送，也不支持回调 [onConversationChanged] 和 [onConversationTotalUnreadMessageCountUpdated]。

返回值

发送媒体消息的结果。

insertMessageToLocalDB

void insertMessageToLocalDB(ZIMMessage message, String conversationID, ZIMConversationType conversationType, String senderUserID, ZIMMessageInsertedCallback callback)

向本地 DB 插入一条消息。

Declared in ZIM.java

参数

名称	类型	描述
message	ZIMMessage	要插入的消息。
conversationID	String	会话 ID。
conversationType	ZIMConversationType	会话类型。
senderUserID	String	该消息的发送者 ID。
callback	ZIMMessageInsertedCallback	插入消息的结果回调。

详情

该方法可以在客户端直接向本地 DB 插入一条消息。

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

支持版本：2.4.0 及以上。
使用限制：不支持插入“信令”消息。如需插入“房间”消息，请将 SDK 升级到 2.13.0 及以上。

返回值

插入消息的结果。

clearLocalFileCache

void clearLocalFileCache(ZIMFileCacheClearConfig config, ZIMFileCacheClearedCallback callback)

清理当前用户本地消息缓存。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMFileCacheClearConfig	清理缓存的配置。
callback	ZIMFileCacheClearedCallback	清理缓存的结果的返回。

详情

该方法用于清理当前用户本地消息缓存。

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

支持版本：2.15.0 及以上。
使用限制：登录后生效，登出后失效。

queryLocalFileCache

void queryLocalFileCache(ZIMFileCacheQueryConfig config, ZIMFileCacheQueriedCallback callback)

查询当前用户本地消息缓存。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMFileCacheQueryConfig	查询缓存的配置。
callback	ZIMFileCacheQueriedCallback	查询缓存的结果的返回。

详情

该方法用于查询当前用户本地消息缓存。

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

支持版本：2.15.0 及以上。
使用限制：登录后生效，登出后失效。

exportLocalMessages

void exportLocalMessages(String folderPath, ZIMMessageExportConfig config, ZIMMessageExportingProgress progress, ZIMMessageExportedCallback callback)

导出当前用户本地消息。

Declared in ZIM.java

参数

名称	类型	描述
folderPath	String	请填入文件保存地址，路径为绝对路径。
config	ZIMMessageExportConfig	导出消息的配置。
progress	ZIMMessageExportingProgress	导出消息进度的返回。
callback	ZIMMessageExportedCallback	导出消息结果的返回。

详情

该方法用于导出当前用户本地消息。

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

支持版本：2.15.0 及以上。
使用限制：登录后生效，登出后失效。
注意事项：本接口导出的消息文件名称为 zim_backup_msg_text。如果多次调用本接口时，传入的路径相同，ZIM SDK 会自行将旧的 zim_backup_msg_text 文件更名，以确保最新导出的文件名称为 zim_backup_msg_text。

importLocalMessages

void importLocalMessages(String folderPath, ZIMMessageImportConfig config, ZIMMessageImportingProgress progress, ZIMMessageImportedCallback callback)

导入当前用户本地消息。

Declared in ZIM.java

参数

名称	类型	描述
folderPath	String	请填入导入文件所在目录的地址，路径为绝对路径，不包括文件名。
config	ZIMMessageImportConfig	导入消息的配置。
progress	ZIMMessageImportingProgress	导出消息进度的返回。
callback	ZIMMessageImportedCallback	导入消息结果的返回。

详情

该方法用于导入当前用户本地消息。

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

支持版本：2.15.0 及以上。
使用限制：登录后生效，登出后失效。
注意事项：ZIM SDK 默认读取目录中名称为 zim_backup_msg_text 的文件。如果该路径下存在多份备份，请确认待导入的文件名称是否为 zim_backup_msg_text。

sendConversationMessageReceiptRead

void sendConversationMessageReceiptRead(String conversationID, ZIMConversationType conversationType, ZIMConversationMessageReceiptReadSentCallback callback)

设置会话所有已接收的回执已读。

Declared in ZIM.java

参数

名称	类型	描述
conversationID	String	会话的ID。
conversationType	ZIMConversationType	会话类型，仅支持 Peer 类型。
callback	ZIMConversationMessageReceiptReadSentCallback	设置会话已读回调。

详情

设置会话所有已接收的回执已读。

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

支持版本：2.5.0及以上。
注意事项：只允许单聊的会话使用。

返回值

设置会话已读回调。

sendMessageReceiptsRead

void sendMessageReceiptsRead(List<ZIMMessage> messageList, String conversationID, ZIMConversationType conversationType, ZIMMessageReceiptsReadSentCallback callback)

设置一批消息的回执变成已读。

Declared in ZIM.java

参数

名称	类型	描述
messageList	List<ZIMMessage>	要设置已读的消息列表，所含消息不能超过 10 条。
conversationID	String	会话 ID。
conversationType	ZIMConversationType	会话类型。
callback	ZIMMessageReceiptsReadSentCallback	设置消息已读的结果回调。

详情

该方法可以设置一批消息的回执变成已读。

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

支持版本：2.5.0 及以上。
使用限制：仅支持对收到的，且回执状态为 PROCESSING 的消息设置。

返回值

设置消息已读的结果回调。

queryMessageReceiptsInfo

void queryMessageReceiptsInfo(List<ZIMMessage> messageList, String conversationID, ZIMConversationType conversationType, ZIMMessageReceiptsInfoQueriedCallback callback)

查询一批消息的回执信息。

Declared in ZIM.java

参数

名称	类型	描述
messageList	List<ZIMMessage>	要查询的消息列表。
conversationID	String	会话 ID。
conversationType	ZIMConversationType	会话类型。
callback	ZIMMessageReceiptsInfoQueriedCallback	查询消息回执信息的结果回调。

详情

该方法可以查询一批消息的回执信息，包括状态、未读用户数和已读用户数。

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

支持版本：2.5.0 及以上。
使用限制：仅支持查询回执状态不为 NONE 的消息。

返回值

查询消息回执信息的结果回调。

queryGroupMessageReceiptReadMemberList

void queryGroupMessageReceiptReadMemberList(ZIMMessage message, String groupID, ZIMGroupMessageReceiptMemberQueryConfig config, ZIMGroupMessageReceiptMemberListQueriedCallback callback)

查询群消息已读成员列表。

Declared in ZIM.java

参数

名称	类型	描述
message	ZIMMessage	要查询的消息。
groupID	String	群组 ID。
config	ZIMGroupMessageReceiptMemberQueryConfig	查询的配置。
callback	ZIMGroupMessageReceiptMemberListQueriedCallback	查询具体已读成员列表的结果回调。

详情

该方法可以查询一个群某一条自己发的消息的具体已读成员列表。

业务场景：开发者可通过这个方法，查询一条自己发的消息的具体已读成员列表。
调用时机：登录后可调用。
相关回调：[ZIMGroupMessageReceiptMemberListQueriedCallback]。
相关接口：如果需要查询某一条消息的回执状态或只需要查询已读/未读数，通过接口 [queryMessageReceiptsInfo] 查询。

支持版本：2.5.0 及以上。
使用限制：仅支持查询本端发送的消息，且消息的回执状态不为 NONE。如果该用户不在群组，或已被踢出群组，则无法查到对应的成员列表。

返回值

查询具体已读成员列表的结果回调。

queryGroupMessageReceiptUnreadMemberList

void queryGroupMessageReceiptUnreadMemberList(ZIMMessage message, String groupID, ZIMGroupMessageReceiptMemberQueryConfig config, ZIMGroupMessageReceiptMemberListQueriedCallback callback)

查询群消息未读成员列表。

Declared in ZIM.java

参数

名称	类型	描述
message	ZIMMessage	要查询的消息。
groupID	String	群组 ID。
config	ZIMGroupMessageReceiptMemberQueryConfig	查询的配置。
callback	ZIMGroupMessageReceiptMemberListQueriedCallback	查询具体未读成员列表的的结果回调。

详情

该方法可以查询一个群某一条自己发的消息的具体未读成员列表。

业务场景：开发者可通过这个方法，查询一条自己发的消息的具体未读成员列表。
调用时机：登录后可调用。
相关回调：[ZIMGroupMessageReceiptMemberListQueriedCallback]。
相关接口：如果需要查询某一条消息的回执状态或只需要查询已读/未读数，通过接口 [queryMessageReceiptsInfo] 查询。

支持版本：2.5.0 及以上。
使用限制：仅支持查询本端发送的消息，且消息的回执状态不为 NONE。如果该用户不在群组，或已被踢出群组，则无法查到对应的成员列表。

返回值

查询具体未读成员列表的的结果回调。

searchLocalMessages

void searchLocalMessages(String conversationID, ZIMConversationType conversationType, ZIMMessageSearchConfig config, ZIMMessagesSearchedCallback callback)

搜索本地消息列表。

Declared in ZIM.java

参数

名称	类型	描述
conversationID	String	要搜索的本地消息的会话 ID。
conversationType	ZIMConversationType	会话类型。
config	ZIMMessageSearchConfig	搜索本地消息的配置。
callback	ZIMMessagesSearchedCallback	搜索本地消息的的结果的返回。

详情

该方法用于搜索本地消息。

业务场景：当需要通过关键字等条件搜索以往的本地消息，可以调用该接口来分页搜索本地消息。
相关回调：[ZIMMessagesSearchedCallback]

支持版本：2.9.0 及以上。
使用限制：登录后生效，登出后失效。房间场景（conversationType=1）下不支持搜索。

返回值

搜索本地消息的的结果的返回。

searchLocalConversations

void searchLocalConversations(ZIMConversationSearchConfig config, ZIMConversationsSearchedCallback callback)

基于本地消息搜索本地会话。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMConversationSearchConfig	全局搜索会话的配置。
callback	ZIMConversationsSearchedCallback	搜索会话的的结果的返回。

详情

该方法用于基于本地消息搜索本地会话。

业务场景：当需要通过关键字等条件进行全局搜索会话时，可以调用该接口进行搜索。
调用时机/通知时机：需要通过关键字等条件进行搜索会话时调用。
相关回调：[ZIMConversationsSearchedCallback]

支持版本：2.9.0 及以上。
使用限制：登录后生效，登出后失效。房间场景（conversationType=1）下不支持搜索。

返回值

搜索会话的的结果的返回。

searchGlobalLocalMessages

void searchGlobalLocalMessages(ZIMMessageSearchConfig config, ZIMMessagesGlobalSearchedCallback callback)

搜索全局本地消息列表。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMMessageSearchConfig	全局搜索本地消息的配置。
callback	ZIMMessagesGlobalSearchedCallback	全局搜索本地消息的的结果的返回。

详情

该方法用于全局搜索本地消息。

业务场景：当需要通过关键字等条件进行全局搜索以往的本地消息，可以调用该接口按会话进行分组来搜索本地消息。
相关回调：[ZIMMessagesGlobalSearchedCallback]

支持版本：2.9.0 及以上。
使用限制：登录后生效，登出后失效。房间场景（conversationType=1）下不支持搜索。

返回值

全局搜索本地消息的的结果的返回。

replyMessage

void replyMessage(ZIMMessage message, ZIMMessage toOriginalMessage, ZIMMessageSendConfig config, ZIMMessageSentFullCallback callback)

发送回复消息。

Declared in ZIM.java

参数

名称	类型	描述
message	ZIMMessage	要发送的消息，使用时，请根据消息类型修改 message 的类型。例如，发送文本消息时，请使用 ZIMTextMessage。仅支持：ZIMTextMessage(1)、ZIMImageMessage(11)、ZIMFileMessage(12)、ZIMAudioMessage(13)、ZIMVideoMessage(14)、ZIMCombineMessage(100)、ZIMCustomMessage(200)。
toOriginalMessage	ZIMMessage	引用的源消息。仅支持：ZIMTextMessage(1)、ZIMImageMessage(11)、ZIMFileMessage(12)、ZIMAudioMessage(13)、ZIMVideoMessage(14)、ZIMCombineMessage(100)、ZIMCustomMessage(200)。
config	ZIMMessageSendConfig	发送消息的相关配置。
callback	ZIMMessageSentFullCallback	消息的发送结果的回调。

详情

此方法可用于单聊、群聊中发送回复消息。

业务场景：登录后需要向目标用户、目标群聊发送回复消息时，通过该接口发送。
调用时机：登录后即可调用。
相关回调：[onReceivePeerMessage]、[onReceiveGroupMessage]。
相关接口：[queryHistoryMessage]、[sendMessage]、[sendMediaMessage]。

支持版本：2.17.0 及以上。
使用限制：两次发送消息的间隔要大于 100ms。登录后可用，注销后不可用。

queryMessageRepliedList

void queryMessageRepliedList(ZIMMessage message, ZIMMessageRepliedListQueryConfig config, ZIMMessageRepliedListQueriedCallback callback)

查询回复列表。

Declared in ZIM.java

参数

名称	类型	描述
message	ZIMMessage	传入回复列表中的某一条消息。
config	ZIMMessageRepliedListQueryConfig	查询回复列表的配置。
callback	ZIMMessageRepliedListQueriedCallback	查询结果的回调。

详情

查询回复消息列表。

业务场景：开发者可通过这个方法，查询整个回复消息树。
调用时机：登录后可调用。

支持版本：2.17.0 及以上。

返回值

查询结果的回调。

sendMediaMessage

void sendMediaMessage(ZIMMediaMessage message, String toConversationID, ZIMConversationType conversationType, ZIMMessageSendConfig config, ZIMMediaMessageSentCallback callback)

发送媒体消息。

Declared in ZIM.java

参数

名称	类型	描述
message	ZIMMediaMessage	要发送的消息。
toConversationID	String	消息接收方的会话 ID，支持单聊、房间以及群聊。
conversationType	ZIMConversationType	会话类型，支持单聊、房间以及群聊。
config	ZIMMessageSendConfig	发送消息的相关配置。
callback	ZIMMediaMessageSentCallback	发送媒体消息的结果回调。

详情

该方法可用于发送单聊、房间以及群聊消息。

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

支持版本：2.1.0 及以上。
使用限制：不得超过10条/s，登录后可用，登出后不可用。
注意事项：pushconfig 只有需要使用离线推送功能时才需要填写。若向房间发送媒体消息，则不支持离线推送，也不支持回调 [onConversationChanged] 和 [onConversationTotalUnreadMessageCountUpdated]。

返回值

发送媒体消息的结果。

downloadMediaFile

void downloadMediaFile(ZIMMessage message, ZIMMediaFileType fileType, ZIMMediaDownloadConfig config, ZIMMediaDownloadedCallback callback)

下载媒体文件的内容。

Declared in ZIM.java

参数

名称	类型	描述
message	ZIMMessage	要下载的媒体文件消息。
fileType	ZIMMediaFileType	媒体文件类型。
config	ZIMMediaDownloadConfig	下载配置对象。
callback	ZIMMediaDownloadedCallback	下载媒体文件的结果回调。

详情

该方法可用于下载媒体文件的内容，包含图片消息原图、大图、缩略图，文件消息，音频消息，视频消息以及其首帧图。

业务场景：用户收到消息之后，若该消息包含媒体文件，则可以调用本接口下载其内容。
调用时机/通知时机：登录后且收到包含媒体文件的消息之后可调用。
相关回调：[ZIMMediaDownloadedCallback]、[ZIMMediaDownloadingProgress]。

支持版本：2.19.0 及以上。
使用限制：若下载的是外部 URL，则最大只能下载 200MB 的资源，如需配置，请联系 ZEGO 技术支持。

返回值

下载媒体文件的结果。

downloadMediaFile

deprecated

void downloadMediaFile(ZIMMediaMessage message, ZIMMediaFileType fileType, ZIMMediaDownloadedCallback callback)

下载媒体消息内容。

Declared in ZIM.java

参数

名称	类型	描述
message	ZIMMediaMessage	要下载的媒体消息。
fileType	ZIMMediaFileType	媒体文件类型。
callback	ZIMMediaDownloadedCallback	下载媒体文件的结果回调。

详情

该方法可用于下载媒体消息内容，包含图片消息原图、大图、缩略图，文件消息，音频消息，视频消息以及其首帧图。

业务场景：用户收到消息之后，若该消息为媒体消息，则可以调用本接口下载其内容。
调用时机/通知时机：登录后且收到媒体消息之后可调用。
相关回调：[ZIMMediaDownloadedCallback]、[ZIMMediaDownloadingProgress]。

支持版本：2.1.0 及以上。
使用限制：若下载的是外部 URL，则最大只能下载 200MB 的资源，如需配置，请联系 ZEGO 技术支持。
注意事项：若 [sendMediaMessage] 发送的是网络 URL，则 2.9.0 版本以前的 SDK 无法通过此接口下载。

已废弃

此 API 自 2.19.0 起已弃用，请改用同名接口 [downloadMediaFile]。

返回值

下载媒体文件的结果。

sendPeerMessage

deprecated

void sendPeerMessage(ZIMMessage message, String toUserID, ZIMMessageSendConfig config, ZIMMessageSentCallback callback)

发送点对点消息。

Declared in ZIM.java

参数

名称	类型	描述
message	ZIMMessage	要发送的消息。
toUserID	String	消息接收方的用户 ID。
config	ZIMMessageSendConfig	发送单聊消息的相关配置。
callback	ZIMMessageSentCallback	消息的发送结果的回调。

详情

调用此函数后会向指定用户发送消息，同时将收到 [onMessageSent] 回调，可用于判断是否发送成功。

业务场景：在进行 1v1 聊天时的场景时需要用到该功能。
调用时机：初始化 ZIM，登录以后，用户需要发送单聊消息时调用。

支持版本：1.1.0 及以上。
注意事项：发送时需要注意 [onMessageSent] 回调，如果因为某些原因发送失败可以通过该回调用于判断。

已废弃

此 API 自 2.4.0 起已弃用，请改用 [sendMessage]。

返回值

发送消息的结果的回调。

sendRoomMessage

deprecated

void sendRoomMessage(ZIMMessage message, String toRoomID, ZIMMessageSendConfig config, ZIMMessageSentCallback callback)

发送房间消息。

Declared in ZIM.java

参数

名称	类型	描述
message	ZIMMessage	要发送的消息。
toRoomID	String	消息接收方的房间 ID。
config	ZIMMessageSendConfig	发送房间消息的相关配置。
callback	ZIMMessageSentCallback	消息的发送结果的回调。

详情

调用此函数后会指定房间内发送消息，同时将收到 [onMessageSent] 回调，可用于判断是否发送成功。

业务场景：在进行房间内多人聊天时的场景时需要用到该功能。
调用时机：初始化 ZIM，登录成功并创建或加入房间后，用户需要发送房间消息时调用该方法。

支持版本：1.1.0 及以上。
注意事项：发送时需要注意 [onMessageSent] 回调，如果因为某些原因发送失败可以通过该回调用于判断。

已废弃

此 API 自 2.4.0 起已弃用，请改用 [sendMessage]。

返回值

消息的发送结果的回调。

sendGroupMessage

deprecated

void sendGroupMessage(ZIMMessage message, String toGroupID, ZIMMessageSendConfig config, ZIMMessageSentCallback callback)

发送群组消息。

Declared in ZIM.java

参数

名称	类型	描述
message	ZIMMessage	要发送的消息。
toGroupID	String	消息接收方的用户 ID。
config	ZIMMessageSendConfig	发送单聊消息的相关配置。
callback	ZIMMessageSentCallback	消息的发送结果的回调。

详情

需要发送群聊消息时，调用该接口。

业务场景：发送群消息时，可使用该接口。
调用时机/通知时机：需要发送群聊消息时调用此接口。
影响范围：使用该方法会触发消息接收方的 onReceiveGroupMessage 回调，会触发发送方和接收方的 onConversationChanged 回调，若该消息所在会话未设置消息免打扰，会触发 onConversationTotalUnreadMessageCountUpdated 回调。
相关回调：[ZIMMessageSentCallback]、[onReceiveGroupMessage]、[onConversationChanged]、[onConversationTotalUnreadMessageCountUpdated]。
相关接口：[queryHistoryMessage]、[deleteMessage]

支持版本：2.0.0 及以上。
使用限制：不得超过10条/s，登录后可用，登出后不可用。
注意事项：pushconfig 只有需要使用离线推送功能时才需要填写。

已废弃

此 API 自 2.4.0 起已弃用，请改用 [sendMessage]。

返回值

发送消息的结果的回调。

queryHistoryMessage

void queryHistoryMessage(String conversationID, ZIMConversationType conversationType, ZIMMessageQueryConfig config, ZIMMessageQueriedCallback callback)

查询历史消息。

Declared in ZIM.java

参数

名称	类型	描述
conversationID	String	被查询历史消息的会话ID。
conversationType	ZIMConversationType	会话类型。
config	ZIMMessageQueryConfig	查询历史消息的配置。
callback	ZIMMessageQueriedCallback	查询历史消息的的结果的返回。

详情

该方法用于查询历史消息。

业务场景：当需要获得以往的历史消息，可以调用该接口来分页查询历史消息。
调用时机/通知时机：需要查询历史消息时调用。
相关回调：[ZIMMessageQueriedCallback]

支持版本：2.0.0 及以上。
使用限制：登录后生效，登出后失效。默认房间场景（conversationType=1）下不开通离线消息缓存，如需开通请联系对应技术支持。

返回值

查询历史消息的结果回调。

queryPinnedMessageList

void queryPinnedMessageList(String conversationID, ZIMConversationType conversationType, ZIMMessageQueriedCallback callback)

查询置顶消息列表。

Declared in ZIM.java

参数

名称	类型	描述
conversationID	String	被查询置顶消息的会话ID。
conversationType	ZIMConversationType	会话类型。
callback	ZIMMessageQueriedCallback	查询历史消息的的结果的返回。

详情

该方法用于查询置顶消息列表。

业务场景：当需要展示置顶消息时，可以调用该接口来查询会话内置顶消息列表。
调用时机：需要查询置顶消息时调用。
相关回调：[ZIMPinnedMessageListQueriedCallback]

支持版本：2.25.0 及以上。
使用限制：已登录 SDK 且支持消息置顶功能才能使用。

返回值

查询置顶消息的结果回调。

queryMessages

void queryMessages(ArrayList<Long> messageSeqs, String conversationID, ZIMConversationType conversationType, ZIMMessageQueriedCallback callback)

根据消息seq列表查询消息。

Declared in ZIM.java

参数

名称	类型	描述
messageSeqs	ArrayList<Long>	查询的消息seq列表。
conversationID	String	被查询消息的会话ID。
conversationType	ZIMConversationType	会话类型。
callback	ZIMMessageQueriedCallback	查询消息的的结果的返回。

详情

根据消息seq列表查询一批消息。

业务场景：在聊天页面跳转到回复消息引用的源消息位置。

支持版本：2.17.0 及以上。

返回值

查询消息的的结果的返回。

deleteAllConversationMessages

void deleteAllConversationMessages(ZIMMessageDeleteConfig config, ZIMConversationMessagesAllDeletedCallback callback)

删除所有会话的所有消息。

Declared in ZIM.java

参数

名称	类型	描述
config	ZIMMessageDeleteConfig	删除消息的配置。
callback	ZIMConversationMessagesAllDeletedCallback	删除全部会话的全部消息的结果的结果回调。

详情

该方法实现了删除所有会话的所有消息的功能。

业务场景：用户需要将所有消息删除时，可用此方法，此方法不会将会话删除。
调用时机/通知时机：需要删除所有会话的所有消息时调用。
影响范围：调用该接口触发 [onMessageDeleted] 回调，若此时存在未读的消息，则会触发 [onConversationTotalUnreadMessageCountUpdated] 回调。
相关回调：[ZIMConversationMessagesAllDeletedCallback]、[onMessageDeleted]、[onConversationTotalUnreadMessageCountUpdated]。

支持版本：2.14.0 及以上。
使用限制：登录后才能使用。
注意事项：isAlsoDeleteServerMessage 决定是否删除服务器消息，无论是否删除服务器消息，删除消息的影响范围都仅限于本账号，不会删除其他账号的消息。

返回值

删除全部会话的全部消息的结果的结果回调。

queryCombineMessageDetail

public void queryCombineMessageDetail(ZIMCombineMessage message, ZIMCombineMessageDetailQueriedCallback callback)

拉取合并消息详情

Declared in ZIM.java

参数

名称	类型	描述
message	ZIMCombineMessage	需要被拉取子消息的合并消息。
callback	ZIMCombineMessageDetailQueriedCallback	查询合并消息详情的回调参数。

详情

该方法用于查询合并消息下具体有哪些子消息。

业务场景：当需要获得合并消息下具体有哪些子消息，可以调用该接口来查询。
调用时机/通知时机：需要查询合并消息下具体有哪些子消息时调用。

支持版本：2.14.0 及以上。
使用限制：登录后生效，登出后失效。

返回值

合并消息详情拉取结果。

revokeMessage

void revokeMessage(ZIMMessage message, ZIMMessageRevokeConfig config, ZIMMessageRevokedCallback callback)

撤回消息。

Declared in ZIM.java

参数

名称	类型	描述
message	ZIMMessage	需要被撤回的消息。
config	ZIMMessageRevokeConfig	撤回消息的配置。
callback	ZIMMessageRevokedCallback	撤回消息的结果的返回。

详情

该方法实现了撤回消息的功能。该接口只能撤回 2 分钟内的消息，如需撤回更早之前的消息，请联系技术支持。

业务场景：用户需要撤回某条消息，当用户不想让其他用户看到该信息时，可用此方法撤回。
影响范围：若撤回的消息为会话的最新一条消息，会触发 [conversationChanged] 回调，若此条消息未读，则会触发 [conversationTotalUnreadMessageCountUpdated] 回调。
相关回调：[receiveMessageRevoked]、[conversationChanged]、[conversationTotalUnreadMessageCountUpdated]。

支持版本：2.5.0 及以上。
使用限制：登录后才能使用。如需群主撤回群内其他成员消息，需要使用 2.9.0 及以上版本。
注意事项：不支持房间消息撤回。

返回值

撤回消息的结果回调。

deleteMessages

void deleteMessages(List<ZIMMessage> messageList, String conversationID, ZIMConversationType conversationType, ZIMMessageDeleteConfig config, ZIMMessageDeletedCallback callback)

删除消息。

Declared in ZIM.java

参数

名称	类型	描述
messageList	List<ZIMMessage>	被删除的消息列表。
conversationID	String	被删除消息的会话ID。
conversationType	ZIMConversationType	会话类型。
config	ZIMMessageDeleteConfig	删除消息的配置。
callback	ZIMMessageDeletedCallback	删除消息的结果的返回。

详情

该方法实现了删除消息的功能。

业务场景：用户需要删除某条消息，当用户无需展示某条消息时，可用此方法删除。
调用时机/通知时机：需要删除消息时调用。
影响范围：若删除的消息为会话的最新一条消息，会触发 [conversationChanged] 回调，若此条消息未读，则会触发 [conversationTotalUnreadMessageCountUpdated] 回调。
相关回调：[ZIMMessageDeletedCallback]、[conversationChanged]、[conversationTotalUnreadMessageCountUpdated]。

支持版本：2.0.0 及以上。
使用限制：登录后才能使用。
注意事项：isAlsoDeleteServerMessage 决定是否删除服务器消息，无论是否删除服务器消息，删除消息的影响范围都仅限于本账号，不会删除其他账号的消息。

返回值

删除消息的结果回调。

addMessageReaction

void addMessageReaction(String reactionType, ZIMMessage message, ZIMMessageReactionAddedCallback callback)

增加消息表态

Declared in ZIM.java

参数

名称	类型	描述
reactionType	String	表态类型，由您定义，长度上限为 32 字节。
message	ZIMMessage	需要被表态的消息。
callback	ZIMMessageReactionAddedCallback	添加消息表态的结果回调。

详情

消息表态，是指用户对消息的反应。一般可用于对单聊或群聊的消息添加或删除表情，也可用于发起群组投票、确认群组结果等操作。

业务场景：用户需要对某条消息进行表态，例如点赞，可用此方法进行表态。
相关回调：若表态成功，则会触发 [onMessageReactionsChanged] 回调；若表态的消息为会话的最新一条消息，成功后还会触发 [onConversationChanged] 回调。

支持版本：2.10.0 及以上。
使用限制：登录后才能使用。且仅支持单聊和群聊的消息表态。
注意事项：不支持房间消息表态。

返回值

增加消息表态的结果回调。

deleteMessageReaction

void deleteMessageReaction(String reactionType, ZIMMessage message, ZIMMessageReactionDeletedCallback callback)

删除消息表态

Declared in ZIM.java

参数

名称	类型	描述
reactionType	String	表态类型，必须为本端用户所作的表态类型。
message	ZIMMessage	需要被删除表态的消息。
callback	ZIMMessageReactionDeletedCallback	撤回消息的结果的返回。

详情

删除本端添加的表态。

业务场景：用户需要对某条已表态的消息进行表态删除，可用此方法。
相关回调：若删除成功，则会触发 [onMessageReactionsChanged] 回调；若相关消息为会话的最新一条消息，成功后还会触发 [onConversationChanged] 回调。

支持版本：2.10.0 及以上。
使用限制：登录后才能使用。且仅支持单聊和群聊的消息表态
注意事项：不支持房间消息表态操作。

返回值

删除消息表态的结果回调。

queryMessageReactionUserList

public void queryMessageReactionUserList(ZIMMessage message, ZIMMessageReactionUserQueryConfig config, ZIMMessageReactionUserListQueriedCallback callback)

拉取消息表态用户列表

Declared in ZIM.java

参数

名称	类型	描述
message	ZIMMessage	需要被拉取表态用户详情的消息。
config	ZIMMessageReactionUserQueryConfig	拉取表态用户配置。
callback	ZIMMessageReactionUserListQueriedCallback	拉取表态用户返回的结果。

详情

该方法用于查询消息某个表态下的具体用户信息。

业务场景：当需要获得消息某个表态下的具体用户信息，可以调用该接口来分页查询表态用户消息。
调用时机/通知时机：需要查询表态用户信息时调用。

支持版本：2.10.0 及以上。
使用限制：登录后生效，登出后失效。不支持查询房间消息的表态详情。

返回值

消息表态用户详情拉取结果。

deleteAllMessage

void deleteAllMessage(String conversationID, ZIMConversationType conversationType, ZIMMessageDeleteConfig config, ZIMMessageDeletedCallback callback)

通过会话ID删除消息。

Declared in ZIM.java

参数

名称	类型	描述
conversationID	String	将要被删除消息的会话ID。
conversationType	ZIMConversationType	会话类型。
config	ZIMMessageDeleteConfig	删除会话配置。
callback	ZIMMessageDeletedCallback	通过会话ID删除消息的结果的返回。

详情

当你需要删除目标会话下的所有消息时，调用该方法。

业务场景：如想要实现一个群设置页面的清空当前会话下的聊天信息，可调用该接口。
调用时机/通知时机：目标会话存在、并且用户属于此会话的一员。
影响范围：触发 [conversationChanged] 回调，若存在未读消息，则会触发 [conversationTotalUnreadMessageCountUpdated] 回调。
相关回调：[ZIMMessageDeletedCallback]。

支持版本：2.0.0 及以上。
使用限制：登录后生效，登出后失效。
注意事项：isAlsoDeleteServerMessage 决定是否删除服务器消息，无论是否删除服务器消息，删除消息的影响范围都仅限于本账号，不会删除其他账号的消息。

返回值

删除消息的结果的返回。

updateMessageLocalExtendedData

void updateMessageLocalExtendedData(String localExtendedData, ZIMMessage message, ZIMMessageLocalExtendedDataUpdatedCallback callback)

更新消息的本地拓展字段。

Declared in ZIM.java

参数

名称	类型	描述
localExtendedData	String	仅本端可见的消息拓展字段，可附带额外的信息存储到本地，目前长度的限制是 128K。如有特殊需求，可联系 ZEGO 技术支持进行配置。
message	ZIMMessage	需要更新的消息体。
callback	ZIMMessageLocalExtendedDataUpdatedCallback	修改本地扩展字段的回调函数。

详情

在用户登录后，调用该接口可以更新消息本地扩展字段。

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

支持版本：2.9.0 及以上。

返回值

修改用户扩展字段的回调结果。

createRoom

void createRoom(ZIMRoomInfo roomInfo, ZIMRoomCreatedCallback callback)

创建并加入一个房间。

Declared in ZIM.java

参数

名称	类型	描述
roomInfo	ZIMRoomInfo	将要被创建的房间的配置信息。
callback	ZIMRoomCreatedCallback	创建房间的结果的回调。

详情

用户可以通过该接口，创建且加入房间，其他用户可通过 [joinRoom] 加入此房间。

业务场景：需要创建多人聊天场景时，可通过该接口创建并加入房间。
调用时机：登录后可调用。
相关回调：通过 [ZIMRoomCreatedCallback] 回调可拿到创建房间的结果。
相关接口：可通过 [joinRoom] 加入房间，[leaveRoom] 离开房间。

支持版本：1.1.0 及以上。
注意事项：当所有人都离开房间后，此房间将被自动销毁，一个用户最多同时在 5 个房间内。如果房间已存在，调用此接口将会出错，具体请参考返回的错误码处理。

queryRoomMembers

void queryRoomMembers(ArrayList\<String\> userIDs, String roomID, ZIMRoomMembersQueriedCallback callback)

查询指定房间中的最多 10 名用户的信息。

Declared in ZIM.java

参数

名称	类型	描述
userIDs	ArrayList<String>	需要查询的用户 ID 列表。最多 10 名用户。
roomID	String	指定房间的房间 ID。
callback	ZIMRoomMembersQueriedCallback	查询房间用户信息的回调。

详情

该方法可以查询指定房间中最多 10 名用户的信息。

业务场景：需要得知指定房间内的用户信息时，这时可以调用该接口来获得数据源。可以确认用户是否在房间中。
调用时机/通知时机：登录后可调用。

支持版本：2.8.0 及以上。
使用限制：登录后可用，登出后不可用，一次最多查询 10 名用户。

setRoomMembersAttributes

void setRoomMembersAttributes(HashMap<String, String> attributes, ArrayList<String> userIDs, String roomID, ZIMRoomMemberAttributesSetConfig config, ZIMRoomMembersAttributesOperatedCallback callback)

设置房间成员属性（增加、改变房间属性均用此接口）。

Declared in ZIM.java

参数

名称	类型	描述
attributes	HashMap<String, String>	欲设置的房间成员属性。
userIDs	ArrayList<String>	批量设置的 userID 列表。
roomID	String	房间 ID。
config	ZIMRoomMemberAttributesSetConfig	该操作的行为配置。
callback	ZIMRoomMembersAttributesOperatedCallback	设置房间成员属性的操作回调。

详情

调用该 API 来设置房间内成员的房间用户属性。

业务场景：如需要为房间内成员设置一个等级，设置一个状态时，可用此接口来设置。
默认值：[ZIMRoomMemberAttributesSetConfig] 默认构造 isDeleteAfterOwnerLeft 为 true。
调用时机：登录后，并处于相关房间内调用。
相关回调：[ZIMRoomMembersAttributesOperatedCallback]、[onRoomMemberAttributesUpdated]。
相关接口：[queryRoomMembersAttributes]、[queryRoomMemberAttributesList]。

支持版本：2.4.0 及以上。
使用限制：每个房间中，最多允许设置 500 个用户的用户属性，以 Key-Value 的方式进行存储。开发者如果需要提高属性上限，请联系 ZEGO 技术支持。房间内的每个用户，所拥有的用户属性 Key-Value 的总长度不超过 144 字节，且 Key-Value 的个数不超过 30 对。单个 Key-Value 的长度，Key 不超过 8 字节、Value 不超过 64 字节。开发者如果需要提高上限，请联系 ZEGO 技术支持。房间销毁后，设置的自定义用户属性也会同时销毁。

返回值

设置房间属性的操作结果。

queryRoomMembersAttributes

void queryRoomMembersAttributes(ArrayList<String> userIDs, String roomID, ZIMRoomMembersAttributesQueriedCallback callback)

批量查询房间内成员的房间用户属性。

Declared in ZIM.java

参数

名称	类型	描述
userIDs	ArrayList<String>	需要查询的 userID 列表。
roomID	String	房间 ID。
callback	ZIMRoomMembersAttributesQueriedCallback	批量查询房间用户属性的结果回调。

详情

调用该 API 来批量查询房间内成员的房间用户属性。

调用时机：当需要指定查询部分房间用户的时候使用该接口。
相关回调：[ZIMRoomMembersAttributesQueriedCallback]。
相关接口：[setRoomMembersAttributes]、[queryRoomMemberAttributesList]。
生命周期：登录并加入对应房间后可用，离开对应房间后不可用。

支持版本：2.4.0 及以上。
使用限制：最大调用频率默认 30 秒内 5 次，一次最大查询 100 人。

返回值

批量查询房间用户属性的结果。

queryRoomMemberAttributesList

void queryRoomMemberAttributesList(String roomID, ZIMRoomMemberAttributesQueryConfig config, ZIMRoomMemberAttributesListQueriedCallback callback)

分页查询房间内拥有房间属性成员的房间用户属性。

Declared in ZIM.java

参数

名称	类型	描述
roomID	String	房间 ID。
config	ZIMRoomMemberAttributesQueryConfig	该操作的行为配置。
callback	ZIMRoomMemberAttributesListQueriedCallback	查询房间内成员属性的结果回调。

详情

分页查询房间内拥有房间属性成员的房间用户属性。

调用时机：当需要指定查询全部房间用户的时候使用该接口。
相关回调：[ZIMRoomMemberAttributesListQueriedCallback]。
相关接口：[setRoomMembersAttributes]、[queryRoomMembersAttributes]。
生命周期：登录并加入对应房间后可用，离开对应房间后不可用。

支持版本：2.4.0 及以上。
使用限制：最大调用频率默认 30 秒内 5 次，一页的 count 最大 100 人。

返回值

分页查询房间用户属性的结果。

createRoom

void createRoom(ZIMRoomInfo roomInfo, ZIMRoomAdvancedConfig config, ZIMRoomCreatedCallback callback)

创建带高级设置的房间。

Declared in ZIM.java

参数

名称	类型	描述
roomInfo	ZIMRoomInfo	将要被创建的房间的配置信息。
config	ZIMRoomAdvancedConfig	将要被创建的房间的高级属性。
callback	ZIMRoomCreatedCallback	创建房间的结果的回调。

详情

用户可以通过该接口，创建且加入房间，其他用户可通过 [joinRoom] 加入此房间。

业务场景：需要创建具有自定义属性的多人聊天场景时，可通过该接口创建并加入房间。
调用时机：登录后可调用。
相关回调：通过 [onRoomCreated] 回调可拿到创建房间的结果。
相关接口：可通过 [joinRoom] 加入房间，[leaveRoom] 离开房间。

支持版本：1.3.0。
注意事项：当所有人都离开房间后，此房间将被自动销毁，一个用户最多同时在 5 个房间内。如果房间已存在，调用此接口将会出错，具体请参考返回的错误码处理。

返回值

创建房间的结果的回调。

enterRoom

void enterRoom(ZIMRoomInfo roomInfo, ZIMRoomAdvancedConfig config, ZIMRoomEnteredCallback callback)

进入房间。若房间不存在，则自动创建。

Declared in ZIM.java

参数

名称	类型	描述
roomInfo	ZIMRoomInfo	将要被创建的房间的配置信息。只有第一个进入房间的用户创建 roomName 生效。
config	ZIMRoomAdvancedConfig	将要被创建的房间的高级属性。只有第一个进入房间的用户配置生效。
callback	ZIMRoomEnteredCallback	进入房间的结果的回调。

详情

调用该 API 后，如果房间已存在，则直接加入房间；如果房间不存在，则创建一个房间并加入。同时，如果房间不存在时，调用该接口后，用户设置的房间高级属性生效。

业务场景：需要进入具有自定义属性的多人聊天场景，同时不需要区分房间是被创建还是被加入时，可通过该接口进入一个房间。
调用时机：登录后可调用。
相关回调：通过 [onRoomEntered] 回调可拿到进入房间的结果。
相关接口：可通过 [enterRoom] 进入房间，[leaveRoom] 离开房间。

支持版本：2.1.0。
注意事项：当所有人都离开房间后，此房间将被自动销毁，一个用户最多同时在 5 个房间内。[enterRoom] 相当于 [createRoom] 或 [joinRoom] 的作用，因此两者只需选用其中一种 API 即可。

返回值

进入房间的结果的回调。

switchRoom

void switchRoom(String fromRoomID, ZIMRoomInfo toRoomInfo, boolean isCreateWhenRoomNotExisted, ZIMRoomAdvancedConfig config, ZIMRoomSwitchedCallback callback)

从一个房间切换至另一个房间，若房间不存在，会根据传入参数决定是否创建对应房间。

Declared in ZIM.java

参数

名称	类型	描述
fromRoomID	String	将要被创建的房间的配置信息。只有第一个进入房间的用户创建 roomName 生效。
toRoomInfo	ZIMRoomInfo	需要切换至的房间的基本信息。其中的 roomName 字段，仅在切换至的房间不存在，且 isCreateWhenRoomNotExisted 字段为 true 的情况下生效。
isCreateWhenRoomNotExisted	boolean	当需要切换至的房间不存在时，基于该字段决定是否要创建对应房间。
config	ZIMRoomAdvancedConfig	如果 isCreateWhenRoomNotExisted 字段为 true，且需要切换至的房间不存在时，创建对应房间所使用的房间进阶属性配置。
callback	ZIMRoomSwitchedCallback	切换房间的结果的回调。

详情

从一个房间切换至另一个房间；如果房间不存在，则根据传入参数决定是否创建对应房间。

业务场景：需要快速从一个房间切换至另一房间的场景。
调用时机：登录后可调用。
相关回调：通过 [ZIMRoomSwitchedCallback] 回调可拿到切换房间的结果。

支持版本：2.18.0。

返回值

切换房间的结果的回调。

joinRoom

void joinRoom(String roomID, ZIMRoomJoinedCallback callback)

加入一个房间。

Declared in ZIM.java

参数

名称	类型	描述
roomID	String	将要加入的房间 ID。
callback	ZIMRoomJoinedCallback	加入房间的结果的回调。

详情

若房间不存在，则加入失败，需要先调用 [createRoom] 创建房间。

业务场景：多人聊天场景下，用户需要加入房间时可调用该接口进入房间。
调用时机：通过 [create] 创建 ZIM 实例后可调用。
相关回调：通过 [onRoomJoined] 回调可获得加入房间的结果。
相关接口：可通过 [createRoom] 创建房间，[leaveRoom] 离开房间。

支持版本：1.1.0 及以上。
注意事项：当所有人都离开房间后，此房间将被自动销毁。一个用户最多同时在 5 个房间内。

返回值

加入房间的结果的回调

leaveRoom

void leaveRoom(String roomID, ZIMRoomLeftCallback callback)

离开一个房间。

Declared in ZIM.java

参数

名称	类型	描述
roomID	String	将要离开的房间 ID。
callback	ZIMRoomLeftCallback	离开房间的结果的回调。

详情

当房间中的用户需要离开房间时，通过 [leaveRoom] 离开此房间，若房间不存在，则离开失败。

业务场景：多人聊天场景下，房间中的用户需要离开房间时，可通过该接口离开房间。
调用时机：通过 [create] 创建 ZIM 实例后，且该用户位于房间中时可调用。
相关回调：通过 [onRoomLeft] 回调可拿到离开房间的结果。
相关接口：可通过 [createRoom] 创建房间，[joinRoom] 加入房间。

支持版本：1.1.0 及以上。
注意事项：若当前用户不在此房间内，则离开失败。当所有人都离开房间后，此房间将被自动销毁。

返回值

离开房间的结果的回调。

leaveAllRoom

void leaveAllRoom(ZIMRoomAllLeftCallback callback)

离开所有已进入的房间。

Declared in ZIM.java

参数

名称	类型	描述
callback	ZIMRoomAllLeftCallback	离开所有房间结果回调。

详情

调用此接口可以一次性退出已进入的所有房间。

调用时机：登录后可调用。
相关回调：通过 [ZIMRoomAllLeftCallback] 回调获取离开的房间列表。

支持版本：2.15 及以上。

返回值

离开所有房间的结果的回调。

queryRoomMemberList

void queryRoomMemberList(String roomID, ZIMRoomMemberQueryConfig config, ZIMRoomMemberQueriedCallback callback)

查询房间内的成员列表。

Declared in ZIM.java

参数

名称	类型	描述
roomID	String	将要查询的房间 ID。
config	ZIMRoomMemberQueryConfig	查询房间成员操作的配置。
callback	ZIMRoomMemberQueriedCallback	查询房间成员的结果的回调。

详情

当加入了一个房间后，可通过此函数获取房间内的成员列表。

业务场景：当开发者需要获取房间成员列表以做其他业务操作时，可调用该接口以获得成员列表。
调用时机：通过 [create] 创建 ZIM 实例后，且该用户位于需要查询的房间中时可调用该接口。
相关回调：通过 [onMemberQueried] 回调可拿到查询房间成员列表的结果。
相关接口：可通过 [queryRoomOnlineMemberCount] 查询房间在线人数。

支持版本：1.1.0 及以上。
注意事项：如需使用此功能，请联系 ZEGO 技术支持开通服务。若用户当前不在此房间内，则查询失败。当房间成员超过 500 人时，查询房间成员列表的结果最多只能包含 500 名成员的信息。

返回值

查询房间成员的结果的回调。

queryRoomOnlineMemberCount

void queryRoomOnlineMemberCount(String roomID, ZIMRoomOnlineMemberCountQueriedCallback callback)

查询房间内在线成员的数量。

Declared in ZIM.java

参数

名称	类型	描述
roomID	String	将要查询的房间 ID。
callback	ZIMRoomOnlineMemberCountQueriedCallback	查询房间内在线成员数量的结果回调。

详情

当加入了一个房间后，可通过此函数获取房间内在线成员的数量。

业务场景：当开发者需要获取房间在线的房间成员人数时，可以调用此接口。
调用时机：通过 [create] 创建 ZIM 实例后，且该用户位于需要查询的房间中时可调用该接口。
相关回调：通过 [onRoomOnlineMemberCountQueried] 回调可拿到查询房间成员在线人数的的结果。
相关接口：可通过 [queryRoomMember] 查询房间成员。

支持版本：1.1.0 及以上。
注意事项：若用户当前不在此房间内，则查询失败。

返回值

查询房间内在线成员数量的结果回调。

queryRoomAllAttributes

void queryRoomAllAttributes(String roomID, ZIMRoomAttributesQueriedCallback callback)

查询房间所有属性。

Declared in ZIM.java

参数

名称	类型	描述
roomID	String	需要查询自定义属性的房间号。
callback	ZIMRoomAttributesQueriedCallback	查询房间属性的回调。

详情

用于查询房间属性。

调用时机：登录后，并处于相关房间内调用。
业务场景：语聊房需要查询麦位时，可以使用该接口。
相关回调：[ZIMRoomAttributesQueriedCallback]。
相关接口：[deleteRoomAttributes]，删除房间属性。[setRoomAttributes]，设置房间属性。

支持版本：1.3.0。

返回值

查询房间属性的回调。

setRoomAttributes

void setRoomAttributes(HashMap<String, String> roomAttributes, String roomID, ZIMRoomAttributesSetConfig config, ZIMRoomAttributesOperatedCallback callback)

设置房间属性（增加、改变房间属性均用此接口）。

Declared in ZIM.java

参数

名称	类型	描述
roomAttributes	HashMap<String, String>	欲设置的房间属性。
roomID	String	需要进行房间属性修改的房间号。
config	ZIMRoomAttributesSetConfig	该操作的行为配置。
callback	ZIMRoomAttributesOperatedCallback	设置房间属性的操作回调。

详情

用于设置房间属性。

业务场景：语聊房需要设置麦位时，可以使用该接口。
调用时机：登录后，并处于相关房间内调用。

数量限制: 每个房间中，最多允许设置 20 个属性。

大小限制: 房间属性的key-value，默认 key 的长度是 16，默认 value 的长度是 1024。

默认值：[ZIMRoomAttributesSetConfig] 传空时的默认配置是非强制操作，且不更新拥有者，且涉及到的房间属性在拥有者退出后不自动删除。
隐私保护声明：尽量不要在房间属性中传入涉及个人隐私的敏感信息，包括但不限于手机号、身份证号、护照编号、真实姓名等。
影响范围：新增或修改现有房间的房间属性。
相关回调：[ZIMRoomAttributesOperatedCallback]。
相关接口：[DeleteRoomAttributes]，删除房间属性。[QueryRoomAllAttributes]，查询房间属性。

支持版本：1.3.0。

返回值

设置房间属性的操作回调。

deleteRoomAttributes

void deleteRoomAttributes(List\<String> keys, String roomID, ZIMRoomAttributesDeleteConfig config, ZIMRoomAttributesOperatedCallback callback)

删除房间属性。

Declared in ZIM.java

参数

名称	类型	描述
keys	List<String>	欲删除的房间属性的key。
roomID	String	欲修改房间属性的房间号
config	ZIMRoomAttributesDeleteConfig	该操作的行为配置。
callback	ZIMRoomAttributesOperatedCallback	设置房间属性的操作回调。

详情

用于删除房间属性。

业务场景：语聊房需要删除麦位时，可以使用该接口。
调用时机：登录后，并处于相关房间内调用。
默认值：[ZIMRoomAttributesDeleteConfig] 传空时的默认配置是非强制操作。
影响范围：删除现有房间的房间属性。
相关回调：[ZIMRoomAttributesOperatedCallback]。
相关接口：[setRoomAttributes]，设置房间属性。[queryRoomAllAttributes]，查询房间属性。

支持版本：1.3.0。

返回值

设置房间属性的操作回调。

beginRoomAttributesBatchOperation

void beginRoomAttributesBatchOperation(String roomID, ZIMRoomAttributesBatchOperationConfig config)

开启组合房间属性操作。

Declared in ZIM.java

参数

名称	类型	描述
roomID	String	需要开启组合操作的房间号。
config	ZIMRoomAttributesBatchOperationConfig	组合操作的配置。

详情

用于开启房间属性的组合操作，一个组合操作视为一次原子操作。

业务场景：语聊房需要切换麦位时，可以使用该接口发起组合操作以完成，如先下麦，然后抢占其他麦位，若抢占失败再回到原来麦位，这期间原来的麦位是锁定的，保证了原来的麦位不会被其他用户上麦。
调用时机：登录后，并处于相关房间内调用。
影响范围：开启后设置、删除房间属性操作会被纳入到本次组合操作中。
相关接口：[endRoomAttributesBatchOperation]，完成本次组合操作。

支持版本：1.3.0。
注意事项：开启房间属性的组合操作后，直到调用完成组合操作接口前，所有的设置与删除操作均会纳入到组合操作中。连续调用开启组合操作接口，会重置状态。若不执行[endRoomAttributesBatchOperation]视为没有操作。

endRoomAttributesBatchOperation

void endRoomAttributesBatchOperation(String roomID, ZIMRoomAttributesBatchOperatedCallback callback)

完成组合房间属性操作。

Declared in ZIM.java

参数

名称	类型	描述
roomID	String	需要进行房间属性修改的房间号。
callback	ZIMRoomAttributesBatchOperatedCallback	组合操作的回调。

详情

完成组合房间属性操作，会将该房间上次调用 [beginRoomAttributesBatchOperation] 到本次操作期间的所有设置/删除操作组合完成。

业务场景：语聊房需要切换麦位时，可以使用该接口。
调用时机：登录后，在 [beginRoomAttributesBatchOperation] 执行后执行该操作。
影响范围：同房间内的设置，删除房间属性。
相关回调：[ZIMRoomAttributesBatchOperatedCallback]。
相关接口：[beginRoomAttributesBatchOperation]，开启组合操作。

支持版本：1.3.0。
使用限制：需要该房间中已开启组合操作。
注意事项：在 [beginRoomAttributesBatchOperation] 未执行时调用，会返还错误。若执行[beginRoomAttributesBatchOperation]后不执行[endRoomAttributesBatchOperation]视为没有操作。

返回值

组合操作的回调。

ZIMAudio

方法

getVersion

static

getVersion

String getVersion()

获取 ZIM Audio SDK 版本号

如果在 SDK 运行过程中遇到异常情况，您可以通过该接口将问题、日志等信息提交给 ZEGO 技术人员进行定位和排查。开发者也可以通过此 API 收集当前 SDK 的版本信息，方便进行应用程序运行统计和相关问题处理。

调用时机：任何时候。

支持版本：ZIM Audio SDK 1.0.0

SDK 当前版本号。

setAdvancedConfig

static

setAdvancedConfig

void setAdvancedConfig(String key, String value)

实现高级配置

参数

名称	类型	描述
key	String	进阶配置的 key。
value	String	进阶配置的 value。

详情

当 SDK 的默认行为无法满足开发者的使用场景时，可以调用此 API 实现开发者定义的高级配置。

调用时机：必须在 [init] 之前调用，否则将在下一次 [init] 后生效。

支持版本：ZIM Audio SDK1.0.0
使用限制：无。
注意事项：使用前请先联系 ZEGO 技术支持。

getInstance

static

getInstance

ZIMAudio getInstance()

获取单例对象。

在使用 ZIMAudio SDK 时，开发者应直接调用此 API 获取内部的单例对象，而不需要自行创建和维护该对象。

调用时机：任何时候。

支持版本：ZIM Audio SDK 1.0.0

init

void init(String license)

初始化 ZIM Audio SDK

参数

名称	类型	描述
license	String	鉴权文件。如果仅实现录制和播放音频，此字段可传空。当需要使用音量增益和噪声等进阶功能时，需要传入此字段。如何获取鉴权文件，请参考在线鉴权。

详情

在使用 ZIMAudio SDK 的其他功能接口时，必须首先调用此 API 进行初始化。

调用时机：在调用其他 API 之前调用。

支持版本：ZIM Audio SDK 1.0.0
使用限制：当没有传递认证信息或认证信息不正确时，SDK 的初始化可以正常进行，但对于一些需要认证的后续功能的使用将会受到限制。

uninit

void uninit()

反初始化 ZIM Audio SDK

当您不再需要使用 ZIMAudio SDK 时，可以调用此 API 进行反初始化并释放内存资源。

支持版本：ZIM Audio SDK 1.0.0

setEventHandler

void setEventHandler(ZIMAudioEventHandler eventHandler)

设置 ZIM Audio SDK 事件通知回调

参数

名称	类型	描述
eventHandler	ZIMAudioEventHandler	事件通知回调。开发者应根据自身业务场景，重写回调的相关方法以关注特定的通知。

详情

设置事件通知回调，以监控录音机和播放器生命周期等回调事件。

调用时机：在 [init] 之后调用。

支持版本：ZIM Audio SDK 1.0.0
注意事项：当多次调用该 API 并传入不同的 eventHandler 对象时，最后一个对象将覆盖先前设置的对象；当 API 传入的 eventHandler 对象为空时，将取消事件回调通知。

enableANS

void enableANS(boolean enable)

开启噪声控制功能

参数

名称	类型	描述
enable	boolean	是否开启此功能。

详情

开启此功能后，可以使人声更清晰。该功能较好地抑制持续性噪音（如雨声等白噪音）。

使用场景：当需要噪音抑制以改善录制音频的音质和用户体验时，可以开启此功能。

调用时机：在 [init] 后且 [startPlay] 期间调用。

支持版本：ZIM Audio SDK 1.0.0
注意事项：只有在认证处于合法使用期内，或者认证信息中允许使用时，才能正常调用此 API；否则，将报告认证已过期或不支持该功能的错误消息。

enableAGC

void enableAGC(boolean enable)

开启音量增益功能

参数

名称	类型	描述
enable	boolean	是否开启此功能。

详情

开启此功能后，SDK 可以自动调节麦克风音量，以适应远近拾音并保持音量稳定。

使用场景：当需要确保音量稳定以改善录制音频的音质和用户体验时，可以开启此功能。

调用时机：在 [init] 后且 [startPlay] 期间调用。

支持版本：ZIM Audio SDK 1.0.0
注意事项：只有在认证处于合法使用期内，或者认证信息中允许使用时，才能正常调用此 API；否则，将报告认证已过期或不支持该功能的错误消息。

setANSParam

void setANSParam(ZIMAudioANSParam param)

设置 ANS 参数

参数

名称	类型	描述
param	ZIMAudioANSParam	ANS 参数

详情

当使用 [enableANS] 开启噪音抑制时，您可以使用此函数在不同的噪音抑制模式之间切换，以控制噪音抑制的程度。

使用场景：当默认的噪音抑制效果不符合期望时，您可以使用此函数来调整噪音抑制模式。

默认值：当未调用此函数时，默认的噪音抑制模式为 [Medium]。
调用时机：在 [init] 后的任何时候调用。

支持版本：ZIM Audio SDK 1.0.0
使用限制：无。
注意事项：只有在 License 鉴权文件处于合法使用期内，或者认证信息中允许使用时，才能正常调用此 API；否则，将报告认证已过期或不支持该功能的错误消息。

startRecord

void startRecord(ZIMAudioRecordConfig config)

开始录制音频文件。

参数

名称	类型	描述
config	ZIMAudioRecordConfig	音频录制配置。

详情

开始录制音频文件。SDK 将向系统申请使用麦克风设备收集音频并将其写入本地文件。使用场景：在用户需要发送语音消息之前，他们可以调用此 API 收集并生成发送所需的语音文件。录制文件最终将保存到本地设置的路径中。

调用时机：在 [init] 后调用。
相关接口：当调用此 API 开始录制时，SDK 将抛出 [onRecorderStarted] 通知。只有在收到此回调通知后，开发者才能认为录制已正式开始并更新 UI 显示；之后，SDK 将通过 [onRecorderProgress] 回调录制进度；在异常情况下，SDK 还可能抛出 [onRecorderFailed] 通知，请开发者根据需要监控并警告用户发生异常。

支持版本：ZIM Audio SDK 1.0.0
使用限制：不能同时使用与录制相关的 API 和与播放相关的 API。同时，SDK 内部只能执行录制或播放之一。因此，在需要开始录制之前，开发者需要主动停止播放功能，否则在 SDK 开始录制之前也会停止播放相关功能。
注意事项：开发者在使用此 API 前请确保已获得应用程序的音频收集权限；当 SDK 开始录制时，它将独占使用音频设备，因此会中断其他第三方应用程序的播放和其他行为。

completeRecord

void completeRecord()

完成录制音频文件。

完成录制音频文件。调用此 API 后，录制文件将在传递给 [startRecord] 的文件路径中生成并保存。

使用场景：完成录制后，开发者可以将录制文件作为即时消息发送。例如，将其传递给 ZIM 的 AudioMessage 以发送语音消息。

调用时机：[startRecord] 录制生效时。
相关接口：当调用此 API 并成功完成录制时，SDK 将抛出 [onRecorderCompleted] 通知。开发者必须在发送语音消息之前接收此回调通知。

支持版本：ZIM Audio SDK 1.0.0
使用限制：不能同时使用与录制相关的 API 和与播放相关的 API。同时，SDK 内部只能执行录制或播放之一。
注意事项：如果开发者在 [startRecord] 生效时不调用此 API 结束录制，则当达到 [startRecord] 的最大录制持续时间时，录制仍将完成并保存文件。完成录制后，SDK 将释放对音频设备的占用。

cancelRecord

void cancelRecord()

中断录制音频

中断录制音频文件。调用此 API 后，录制将停止，并且 SDK 将在内部删除本地文件。

使用场景：在录制过程中需要提前停止录制且不需要发送语音消息时，可以调用此 API 取消录制。

调用时机：[startRecord] 录制生效时。
相关接口：当调用此 API 取消录制时，SDK 将抛出 [onRecorderCancelled] 通知。开发者可以根据此通知清理相关资源并更新 UI 显示。

支持版本：ZIM Audio SDK 1.0.0
使用限制：不能同时使用与录制相关的 API 和与播放相关的 API。同时，SDK 内部只能执行录制或播放之一。
注意事项：取消录制后，SDK 将释放音频设备的占用。

isRecording

boolean isRecording()

获取 ZIM Audio SDK 是否正在录制音频

获取当前时刻 SDK 是否正在录制。

使用场景：当开发者需要在某一时刻获取和检测录制状态时，可以调用此 API 获取录制状态。

调用时机：在 [init] 后的任何时候调用。

支持版本：ZIM Audio SDK 1.0.0

setAudioRouteType

void setAudioRouteType(ZIMAudioRouteType routeType)

设置音频路由类型

参数

名称	类型	描述
routeType	ZIMAudioRouteType	路由类型。

详情

设置音频路由类型，选择是使用扬声器还是耳机听取音频。

使用场景：当开发者需要为用户提供选择音频播放位置的选项时，可以调用此 API 更改当前正在播放的音频路由类型。

调用时机：在 [init] 后的任何时候调用。

支持版本：ZIM Audio SDK 1.0.0
使用限制：无。
注意事项：当用户当前使用耳机进行音频播放时，此 API 的设置将不会生效。

startPlay

void startPlay(ZIMAudioPlayConfig config)

开始播放音频文件

参数

名称	类型	描述
config	ZIMAudioPlayConfig	音频播放配置。

详情

开始播放音频文件。SDK 将读取指定路径中的音频文件并进行播放。

使用场景：用户接收到语音消息后，可以调用此 API 播放已在本地下载并保存的音频文件。

调用时机：在 [init] 后调用。
相关接口：当调用此 API 开始播放时，SDK 将抛出 [onPlayerStarted] 通知。只有在收到此回调通知后，开发者才能认为播放已正式开始并更新 UI 显示；之后，SDK 将通过 [onPlayerProgress] 回调播放进度；在异常情况下，SDK 还可能抛出 [onPlayerFailed] 通知，请开发者根据需要监控并警告用户发生异常。

支持版本：ZIM Audio SDK 1.0.0
使用限制：不能同时使用与播放相关的 API 和与录制相关的 API。同时，SDK 内部只能执行录制或播放之一。因此，在需要启用播放之前，开发者必须首先确保此时没有使用录制功能，否则播放将失败。
注意事项：当 SDK 开始播放时，它将独占使用音频设备，因此会中断其他第三方应用程序的播放，并且不会与其他应用程序的音频输出混合。

stopPlay

void stopPlay()

停止音频播放

停止 SDK 当前正在播放的音频。

使用场景：在播放过程中需要提前停止音频播放时，可以调用此 API 停止播放。如果用户需要立即播放下一段音频，则需要停止前一段音频的播放；或者当用户即将离开播放页面时，也应该停止当前的播放。

调用时机：在 [startPlay] 播放期间调用。
相关接口：当调用此 API 停止播放时，SDK 将抛出 [onPlayerStopped] 通知。开发者可以根据此回调通知更新 UI 显示。

支持版本：ZIM Audio SDK1.0.0
使用限制：不能同时使用与播放相关的 API 和与录制相关的 API。同时，SDK 内部只能执行录制或播放之一。因此，在需要启用播放之前，开发者必须首先确保此时没有使用录制功能，否则播放将失败。
注意事项：停止播放或完成播放后，SDK 将释放音频设备的占用。

isPlaying

boolean isPlaying()

获取 ZIM Audio SDK 是否正在播放音频

获取 ZIM Audio SDK 是否正在播放音频。使用场景：当开发者需要在某一时刻获取和检测播放状态时，可以调用此 API 获取播放状态。

调用时机：在 [init] 后的任何时候调用。

支持版本：ZIM Audio SDK 1.0.0

ZIMAudioEventHandler

方法

onError

void onError(ZIMAudioError errorInfo)

异常回调

参数

名称	类型	描述
errorInfo	ZIMAudioError	错误信息。

详情

当 SDK 内部检测到异常时，将通过此回调抛出通知。

使用场景：用于方便开发者收集 SDK 问题并对其进行故障排除。建议监控回调并进行适当的日志打印或事件报告。

支持版本：ZIM Audio SDK1.0.0
注意事项：不建议开发者在收到此回调后执行逻辑。仅建议用于收集和排查问题。

onRecorderStarted

void onRecorderStarted()

录音开始回调

当开发者调用 [startRecord] 并且 SDK 已经内部准备好音频设备并即将开始录制时，将回调此通知。

使用场景：由开发者用于更新 UI。

相关接口：在调用 [startRecord] 后将回调此通知。

支持版本：ZIM Audio SDK 1.0.0
注意事项：无。

onRecorderCompleted

void onRecorderCompleted(int totalDuration)

录音完成回调

参数

名称	类型	描述
totalDuration	int	音频时长（以毫秒为单位）。

详情

当开发者调用 [completeRecord] 并且 SDK 完成录制并保存录音文件时，将回调此通知。

使用场景：由开发者用于更新 UI 和发送后续语音消息。

相关接口：在调用 [completeRecord] 后将回调此通知。

支持版本：ZIM Audio SDK 1.0.0
注意事项：开发者必须在发送语音消息之前收到此回调通知。

onRecorderCancelled

void onRecorderCancelled()

录音取消回调

当开发者调用 [cancelRecord] 并且 SDK 停止录制并不保留已录制数据时，将回调此通知。

使用场景：由开发者用于更新 UI。

相关接口：在调用 [cancelRecord] 后将回调此通知。

支持版本：1.0.0
注意事项：无。

onRecorderProgress

void onRecorderProgress(int currentDuration)

录制进度通知回调

参数

名称	类型	描述
currentDuration	int	当前记录持续时间（以毫秒为单位）。

详情

录制进度通知。当录制已经开始时，SDK 每 500 毫秒会回调进度通知。用例：用于开发者更新用户界面。

支持版本：ZIM Audio SDK 1.0.0
注意事项：无。

onRecorderFailed

void onRecorderFailed(ZIMAudioErrorCode errorCode)

音频录制失败回调

参数

名称	类型	描述
errorCode	ZIMAudioErrorCode	错误码，请参考 ZIM Audio 错误码文档获取解决建议。

详情

当录制开始或录制过程中发生异常导致录制失败时，将使用此回调通知您。

使用场景：由开发者用于更新 UI。建议开发者监听此回调并向用户提供必要的提示。

支持版本：ZIM Audio SDK 1.0.0
注意事项：无。

onPlayerStarted

void onPlayerStarted(int totalDuration)

音频播放开始回调

参数

名称	类型	描述
totalDuration	int	总播放时间（以毫秒为单位）。

详情

当开发者调用 [startPlay] 并且 SDK 已经内部准备好音频设备并即将开始播放时，将回调此通知。

使用场景：由开发者用于更新 UI。

相关接口：在调用 [startPlay] 后将回调此通知。

支持版本：ZIM Audio SDK 1.0.0
注意事项：无。

onPlayerEnded

void onPlayerEnded()

音频播放完成回调

当音频文件播放完成时，将回调此通知。

使用场景：由开发者用于更新 UI。

支持版本：ZIM Audio SDK 1.0.0
注意事项：无。

onPlayerStopped

void onPlayerStopped()

音频播放停止回调

当开发者调用 [stopPlay] 时，SDK 将立即停止当前正在播放的音频并回调此通知。

使用场景：由开发者用于更新 UI。

相关接口：在调用 [stopPlay] 后将回调此通知。

支持版本：ZIM Audio SDK 1.0.0
注意事项：无。

onPlayerProgress

void onPlayerProgress(int currentDuration)

音频播放进度回调

参数

名称	类型	描述
currentDuration	int	当前播放时间，以毫秒为单位。

详情

当播放已经开始时，SDK 将每 500 毫秒调用进度通知回调。

使用场景：由开发者用于更新 UI。

支持版本：ZIM Audio SDK 1.0.0
注意事项：无。

onPlayerInterrupted

void onPlayerInterrupted()

音频播放中断回调

当播放被其他操作中断时，SDK 将调用此通知。例如，在播放过程中开始录制，播放过程中收到系统的来电事件，播放过程中音频设备被其他应用程序抢占等。

使用场景：由开发者用于更新 UI。

支持版本：ZIM Audio SDK 1.0.0
注意事项：无。

onPlayerFailed

void onPlayerFailed(ZIMAudioErrorCode errorCode)

音频播放失败回调

参数

名称	类型	描述
errorCode	ZIMAudioErrorCode	错误码，请参考 ZIM Audio 错误码文档获取解决建议。

详情

当播放开始或播放过程中发生异常导致播放失败时，将使用此回调通知您。

使用场景：由开发者用于更新 UI。建议开发者监听此回调并向用户提供必要的提示。

支持版本：ZIM Audio SDK 1.0.0
注意事项：无。

ZIMEventHandler

详情

回调。

Declared in callback/ZIMEventHandler.java

方法

onBlacklistChanged

void onBlacklistChanged(ZIM zim, ArrayList<ZIMUserInfo> userList, ZIMBlacklistChangeAction action)

当黑名单列表发生变化时会回调当前方法

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
userList	ArrayList<ZIMUserInfo>	黑名单列表变更的用户信息集合
action	ZIMBlacklistChangeAction	接收到黑名单列表的变更时可用该值判断是删除动作还是新增的动作

详情

当黑名单列表发生变化时会回调当前方法

调用时机：通过 [create] 创建ZIM实例后。
相关接口：[addUsersToBlacklist]。

支持版本：2.13.0 及以上。

onFriendListChanged

void onFriendListChanged(ZIM zim, ArrayList<ZIMFriendInfo> friendInfoList, ZIMFriendListChangeAction action)

当好友列表发生变化时会回调当前方法

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
friendInfoList	ArrayList<ZIMFriendInfo>	好友列表变更的用户信息集合
action	ZIMFriendListChangeAction	接收到好友列表的变更时可用该值判断是删除动作还是新增的动作

详情

当好友列表发生变化时会回调当前方法

调用时机：通过 [create] 创建ZIM实例后。
相关接口：[addFriend]。

支持版本：2.14.0 及以上。

onFriendApplicationListChanged

void onFriendApplicationListChanged(ZIM zim, ArrayList<ZIMFriendApplicationInfo> friendApplicationInfoList, ZIMFriendApplicationListChangeAction action)

当好友申请列表发生变化时会回调当前方法

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
friendApplicationInfoList	ArrayList<ZIMFriendApplicationInfo>	好友申请列表变更的数据
action	ZIMFriendApplicationListChangeAction	接收到好友列表的变更时可用该值判断是删除动作还是新增的动作

详情

当好友列表发生变化时会回调当前方法

调用时机：通过 [create] 创建ZIM实例后。
相关接口：[sendFriendApplication]。

支持版本：2.14.0 及以上。

onFriendApplicationUpdated

void onFriendApplicationUpdated(ZIM zim, ArrayList<ZIMFriendApplicationInfo> friendApplicationInfoList)

当好友申请列表发生更新时会回调当前方法

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
friendApplicationInfoList	ArrayList<ZIMFriendApplicationInfo>	好友申请列表更新的数据。

详情

当好友申请列表发生更新时会回调当前方法

调用时机：通过 [create] 创建ZIM实例后。
相关接口：[acceptFriendApplication] [rejectFriendApplication]。

支持版本：2.14.0 及以上。

onFriendInfoUpdated

void onFriendInfoUpdated(ZIM zim, ArrayList<ZIMFriendInfo> friendInfoList)

当好友信息更新时候会触发该回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
friendInfoList	ArrayList<ZIMFriendInfo>	好友信息更新数据

详情

当好友信息更新时候会触发该回调。

调用时机：通过 [create] 创建ZIM实例后。
相关接口：[updateFriendAlias] [updateFriendAttributes]。

支持版本：2.14.0 及以上。

onUserStatusUpdated

void onUserStatusUpdated(ZIM zim, ArrayList<ZIMUserStatus> userStatusList)

用户在线状态变更通知。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	zim 实例。
userStatusList	ArrayList<ZIMUserStatus>	携带用户在线状态数据的列表。

详情

用户在线状态变更通知。

业务场景：当业务上需关注某些人的在线状态，比如展示在线的群成员，通过 subscribeUsersStatus 接口订阅这些用户后，这些用户的在线状态以及订阅有效期间在线状态发生的变更将通过此接口通知给您。
调用时机/通知时机：当前用户首次订阅目标用户后，如果目标用户首次被添加到订阅列表，或者被订阅的用户的在线状态、在线平台列表时，该事件将会被触发。此外，当前用户如果开通了多端登录，并且在线平台发生了变更时，该回调也会被触发。

支持版本：2.18.0
注意事项：当 userStatusUpdated 回调返回当前用户的 userStatus 信息时，其中的 onlineStatus 将为 unknown, lastUpdateTime 为 0,并不能真实反馈在线状态，请根据 connectionStateChanged 来映射当前用户的在线状态。

onError

void onError(ZIM zim, ZIMError errorInfo)

错误信息回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
errorInfo	ZIMError	错误信息，详情请参考常见错误码文档。

详情

SDK 出现异常时，会通过该回调提示详细的异常信息。

业务场景：建议开发者在接入 SDK 后，在调试阶段中监听此回调通知并将错误信息打印到控制台中，用于及时知悉开发过程中发生的错误，及时修改。
通知时机：SDK 内部发生错误时，SDK 会通过此函数回调通知开发者。

支持版本：1.1.0 及以上。

onConnectionStateChanged

void onConnectionStateChanged(ZIM zim, ZIMConnectionState state, ZIMConnectionEvent event, JSONObject extendedData)

连接状态发生改变的事件回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
state	ZIMConnectionState	连接状态变更后的当前状态。
event	ZIMConnectionEvent	导致连接状态发生变更的事件。
extendedData	JSONObject	事件发生时的额外信息，标准 JSON 格式数据。

详情

连接状态发生改变时会通过该回调将目前的状态与事件通知用户。

业务场景：需要监测连接状态，以及使得连接状态改变的事件时，可通过该回调中的 [ZIMConnectionState] 和 [ZIMConnectionEvent] 以完成不同的业务逻辑。
通知时机：连接状态发生改变时会回调此函数通知。

支持版本：1.1.0 及以上。

onTokenWillExpire

void onTokenWillExpire(ZIM zim, int second)

Token 将要过期的提醒回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
second	int	Token 即将过期的剩余时间，单位秒。

详情

当收到此回调时，开发者应当及时调用 [renewToken] 函数更新 Token。

通知时机：在鉴权 Token 只剩下 30秒时，SDK 会回调此函数通知开发者更新鉴权 Token。若开发者 [login] 时传入的鉴权 Token 不足 30秒的有效期，则在 [login] 成功之后即会回调出来。
相关参考：详情请参考鉴权 Token 生成 https://doc-zh.zego.im/article/11611 。

支持版本：1.1.0 及以上。

onUserInfoUpdated

void onUserInfoUpdated(ZIM zim, ZIMUserFullInfo info)

用户信息更新的回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
info	ZIMUserFullInfo	更新后的用户信息。

详情

多端登录场景时，用户在 A 设备修改自己的信息后，其他在线的多端设备会收到此回调。对于离线设备，用户上线后，需要调用 [queryUsersInfo] 接口，主动查询用户信息。

支持版本：2.11.0 及以上。

onUserRuleUpdated

void onUserRuleUpdated(ZIM zim, ZIMSelfUserRule userRule)

用户规则变更的回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
userRule	ZIMSelfUserRule	更新后的用户规则信息。

详情

用户规则变更的回调。

通知时机：当前用户的用户规则发生变更时，会通过该回调通知所有端。

支持版本：2.15.0 及以后版本。

onCallInvitationReceived

void onCallInvitationReceived(ZIM zim, ZIMCallInvitationReceivedInfo info, String callID)

被邀请者收到的呼叫邀请的通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
info	ZIMCallInvitationReceivedInfo	已接收到的呼叫邀请的相关信息。
callID	String	已接收到的CallID。

详情

邀请者发起呼叫邀请后，当被邀请者在线时，将会收到此回调。

业务场景：被邀请者会在邀请者发送呼叫邀请后，会收到此回调。
调用时机：通过 [create] 创建ZIM实例后。
相关接口：[callInvite]。

支持版本：2.0.0 及以上。
注意事项：若用户不在邀请列表里面或者不在线，则不会收到该回调。

onCallInvitationCreated

void onCallInvitationCreated(ZIM zim, ZIMCallInvitationCreatedInfo info, String callID)

邀请者创建的呼叫邀请回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
info	ZIMCallInvitationCreatedInfo	创建的呼叫邀请的相关信息。
callID	String	创建的CallID。

详情

邀请者发起呼叫邀请后，当邀请者在线时，将会收到此回调。

业务场景：邀请者会在发送呼叫邀请后，会收到此回调。
调用时机：通过 [create] 创建ZIM实例后。
相关接口：[callInvite]。

支持版本：2.13.0 及以上。
注意事项：若用户不在邀请列表里面或者不在线，则不会收到该回调。

onCallInvitationCancelled

void onCallInvitationCancelled(ZIM zim, ZIMCallInvitationCancelledInfo info, String callID)

被邀请者收到的取消邀请的通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
info	ZIMCallInvitationCancelledInfo	已取消的呼叫邀请的相关信息。
callID	String	已取消的callID。

详情

邀请者取消呼叫邀请后，当被邀请者在线时，将会收到此回调。

业务场景：被邀请者会在邀请者取消呼叫邀请后，会收到此回调。
调用时机：通过 [create] 创建ZIM实例后。
相关接口：[callCancel]。

支持版本：2.0.0 及以上。
注意事项：若用户不在取消邀请列表里面或者不在线，则不会收到该回调。

onCallInvitationTimeout

void onCallInvitationTimeout(ZIM zim, ZIMCallInvitationTimeoutInfo info, String callID)

被邀请者的呼叫邀请超时的通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
info	ZIMCallInvitationTimeoutInfo	有关超时通知的信息类。
callID	String	超时的callID。

详情

当呼叫邀请超时后，被邀请者没有响应，被邀请者会收到此回调。

业务场景：被邀请者没有在超时时间前响应，被邀请者会收到此回调。
调用时机：通过 [create] 创建ZIM实例后。
相关接口：[callInvite]、[callAccept]、 [callReject]。

支持版本：2.0.0 及以上。
注意事项：若用户不在邀请列表或者不在线，则不会收到该回调。

onCallInvitationAccepted

deprecated

void onCallInvitationAccepted(ZIM zim, ZIMCallInvitationAcceptedInfo info, String callID)

邀请者收到的接受邀请的通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
info	ZIMCallInvitationAcceptedInfo	已被接受的呼叫邀请的相关信息。
callID	String	已被接受的callID。

详情

被邀请者接受呼叫邀请后，当邀请者在线时，将会收到此回调。

业务场景：邀请者会在邀请者接受呼叫邀请后，会收到此回调。
调用时机：通过 [create] 创建ZIM实例后。
相关接口：[callAccept]。

支持版本：2.0.0 及以上。
注意事项：若用户不是发起这次呼叫邀请的邀请者或者不在线，则不会收到该回调。

已废弃

该接口已在 ZIM 2.9.0 废弃，请使用 [onCallUserStateChanged] 代替。

onCallInvitationRejected

deprecated

void onCallInvitationRejected(ZIM zim, ZIMCallInvitationAcceptedInfo info, String callID)

邀请者收到的被邀请者拒绝邀请的通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
info	ZIMCallInvitationAcceptedInfo	已拒绝的呼叫邀请的相关信息。
callID	String	已拒绝的呼叫邀请的callID。

详情

被邀请者拒绝呼叫邀请后，当邀请者在线时，将会收到此回调。

业务场景：邀请者会在邀请者拒绝呼叫邀请后，会收到此回调。
调用时机：通过 [create] 创建ZIM实例并登录后。
相关接口：[callReject]。

支持版本：2.0.0 及以上。
注意事项：若用户不是发起这次呼叫邀请的邀请者或者不在线，则不会收到该回调。

已废弃

该接口已在 ZIM 2.9.0 废弃，请使用 [onCallUserStateChanged] 代替。

onCallInviteesAnsweredTimeout

deprecated

void onCallInviteesAnsweredTimeout(ZIM zim, ArrayList\<String> invitees)

邀请者呼叫邀请超时的通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
invitees	ArrayList<String>	超时的被邀请者ID。

详情

当呼叫邀请超时后，被邀请者没有响应，邀请者会收到此回调。

业务场景：被邀请者没有在超时时间前响应，邀请者会收到此回调。
调用时机：通过 [create] 创建ZIM实例后。
相关接口：[callInvite]、[callAccept]、 [callReject]。

支持版本：2.0.0 及以上。
注意事项：若用户不是发起这次呼叫邀请的邀请者或者不在线，则不会收到该回调。

已废弃

该接口已在 ZIM 2.9.0 废弃，请使用 [onCallUserStateChanged] 代替。

onCallInvitationEnded

void onCallInvitationEnded(ZIM zim, ZIMCallInvitationEndedInfo info, String callID)

呼叫结束的通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
info	ZIMCallInvitationEndedInfo	事件回调携带的信息。
callID	String	超时的被邀请者ID。

详情

当进阶模式呼叫邀请建立后，某一参与者结束呼叫后，所有参与者会收到此回调。

相关接口：[callEnd]

支持版本：2.9.0 及以上。
注意事项：若用户不是发起这次呼叫的参与者或者不在线，则不会收到该回调。

onCallUserStateChanged

void onCallUserStateChanged(ZIM zim, ZIMCallUserStateChangeInfo info, ArrayList\<String> callID)

呼叫邀请内的用户状态的通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
info	ZIMCallUserStateChangeInfo	呼叫成员状态变化的信息。
callID	ArrayList<String>	本次呼叫的唯一标识符。

详情

监听呼叫用户状态变化。

通知时机：当呼叫邀请发起后，呼叫中有新的成员被邀请，或者成员接受、拒绝、退出，或者成员应答超时，当前呼叫邀请中所有用户状态为 "Inviting"、"Accepted" 和 "Received" 的用户可在此处收到此回调。若通知时成员不在线，登录成功时呼叫仍然未结束，离线期间的所有成员的状态变更会一次补发给这名用户。详细流程请阅读 https://doc-zh.zego.im/article/13930。
相关接口：[callInvite]、[callingInvite]、[callAccept]、 [callReject]、[callQuit]。

支持版本：2.9.0 及以上。
注意事项：若用户不是这次呼叫的成员（主叫和被叫)，则不会收到该回调。

onGroupStateChanged

void onGroupStateChanged(ZIM zim, ZIMGroupState state, ZIMGroupEvent event, ZIMGroupOperatedInfo operatedInfo, ZIMGroupFullInfo groupInfo)

群状态变更通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
state	ZIMGroupState	群变更后的状态。
event	ZIMGroupEvent	群相关事件。
operatedInfo	ZIMGroupOperatedInfo	已操作的群信息。
groupInfo	ZIMGroupFullInfo	发生群状态变更的信息。

详情

群组状态发生变更通知回调。

业务场景：需要根据群组状态进行交互的场景。
通知时机：群组创建、加入、离开、解散操作时会触发通知。
相关接口：[createGroup]，创建群组。[joinGroup]，加入群组。[leaveGroup]，离开群组。[dismissGroup]，解散群组。

onGroupAliasUpdated

void onGroupAliasUpdated

群备注更新通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
groupAlias	String	更新后的群备注。
operatedUserID	String	修改群备注的用户 ID。
groupID	String	目标群组 ID

详情

群组备注变更通知回调。

业务场景：群组备注发生变更时，此通知向修改操作用户的所有端同步最新群备注。
通知时机：群组备注发生变更。
相关接口：[updateGroupAlias]，更新群组备注。

onGroupNameUpdated

void onGroupNameUpdated

群名称更新通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
groupName	String	更新后的群名称。
operatedInfo	ZIMGroupOperatedInfo	群名称更新后的操作信息。
groupID	String	发生群名称更新的groupID。

详情

群组名称发生变更通知回调。

业务场景：群组名称发生变更时，需要同步最新群名称。
通知时机：群组名称发生变更。
相关接口：[updateGroupName]，更新群组名称。

onGroupAvatarUrlUpdated

void onGroupAvatarUrlUpdated(ZIM zim, String groupAvatarUrl, ZIMGroupOperatedInfo operatedInfo, String groupID)

群头像 URL 更新通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
groupAvatarUrl	String	更新后的群头像 URL。
operatedInfo	ZIMGroupOperatedInfo	群头像 URL 更新后的操作信息。
groupID	String	发生群名称更新的groupID。

详情

群组头像 URL 发生变更通知回调。

业务场景：群组头像 URL 发生变更时，需要同步最新群头像 URL 。
通知时机：群组头像 URL 发生变更。
相关接口：[updateGroupAvatarUrl]，更新群组头像 URL 。

onGroupNoticeUpdated

void onGroupNoticeUpdated

群公告更新的通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
groupNotice	String	更新后的群公告。
operatedInfo	String	群公告更新后的操作信息。
groupID	String	发生群公告更新的groupID。

详情

群组公告发生变更通知回调。

业务场景：群组公告发生变更时，需要同步最新公告内容。
通知时机：群组公告发生变更。
相关接口：[updateGroupNotice]，更新群组公告。

onGroupMutedInfoUpdated

void onGroupMutedInfoUpdated(ZIM zim, ZIMGroupMuteInfo muteInfo, String operatedInfo, String groupID)

群禁言更新的通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
muteInfo	ZIMGroupMuteInfo	群组禁言信息。
operatedInfo	String	群禁言变更的操作信息。
groupID	String	发生群禁言变更的 groupID。

详情

群组禁言信息发生变更通知回调。

业务场景：群组禁言信息发生变更时获知变更详情。
通知时机：群组禁言信息发生变更。
相关接口：[muteGroup]，群组禁言。

onGroupVerifyInfoUpdated

void onGroupVerifyInfoUpdated(ZIM zim, ZIMGroupVerifyInfo verifyInfo, ZIMGroupOperatedInfo operatedInfo, String groupID)

入群验证模式更新的通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
verifyInfo	ZIMGroupVerifyInfo	入群验证模式信息。
operatedInfo	ZIMGroupOperatedInfo	入群验证模式变更的操人信息。
groupID	String	发生入群验证模式变更的 groupID。

详情

入群验证模式发生变更通知回调。

通知时机：入群验证模式发生变更。
相关接口：[updateGroupJoinMode，updateGroupInviteMode，updateGroupBeInviteMode]，更新入群验证模式。

onGroupAttributesUpdated

void onGroupAttributesUpdated(ZIM zim, ArrayList<ZIMGroupAttributesUpdateInfo> infos, ZIMGroupOperatedInfo operatedInfo, String groupID)

群属性更新通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
infos	ArrayList<ZIMGroupAttributesUpdateInfo>	群属性更新后的信息。
operatedInfo	ZIMGroupOperatedInfo	群属性更新后的操作信息。
groupID	String	发送群属性更新的groupID。

详情

群组属性发生变更通知回调。

业务场景：群组属性发生变更时，需要同步最新群属性内容。
通知时机：设置、更新、删除群组属性时触发。
相关接口：[setGroupAttributes]，更新群组属性。[deleteGroupAttributes]，删除群组属性。

onGroupMemberStateChanged

void onGroupMemberStateChanged(ZIM zim, ZIMGroupMemberState state, ZIMGroupMemberEvent event, ArrayList<ZIMGroupMemberInfo> userList, ZIMGroupOperatedInfo operatedInfo, String groupID)

群成员状态变更通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
state	ZIMGroupMemberState	更新后的成员状态。
event	ZIMGroupMemberEvent	更新后的成员事件。
userList	ArrayList<ZIMGroupMemberInfo>	更新后的成员信息。
operatedInfo	ZIMGroupOperatedInfo	更新后的操作信息。
groupID	String	发生成员状态变更的groupID。

详情

群成员状态发生变更通知回调。

业务场景：需要根据群成员状态进行交互的场景。
通知时机：群组创建、加入、离开、解散，邀请用户进群、将用户踢出群组操作时会触发通知。
相关接口：[createGroup]，创建群组。[joinGroup]，加入群组。[leaveGroup]，离开群组。[dismissGroup]，解散群组。[intiveUsersIntoGroup]，邀请用户进入群组。[kickGroupMembers]，将用户踢出群组。

onGroupMemberInfoUpdated

void onGroupMemberInfoUpdated(ZIM zim, ArrayList<ZIMGroupMemberInfo> groupMemberInfos, ZIMGroupOperatedInfo operatedInfo, String groupID)

群成员基本信息变更通知。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
groupMemberInfos	ArrayList<ZIMGroupMemberInfo>	更新后的成员信息。
operatedInfo	ZIMGroupOperatedInfo	更新后的操作信息。
groupID	String	发生群成员信息变更的groupID。

详情

群组成员基本信息变更操作结果的返回。

业务场景：群组成员基本信息发生变更后，需要在页面进行展示或其他交互。
通知时机：群组成员基本信息变更结束后的结果返回。
相关接口：[setGroupMemberNickname]，更新群成员昵称。[setGroupMemberRole]，更新群成员角色。[transferGroupOwner]，群主转让。

onGroupApplicationListChanged

void onGroupApplicationListChanged(ZIM zim, ArrayList<ZIMGroupApplicationInfo> applicationList, ZIMGroupApplicationListChangeAction action)

当入群申请列表发生变化时会回调当前方法

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
applicationList	ArrayList<ZIMGroupApplicationInfo>	入群申请列表变更的数据
action	ZIMGroupApplicationListChangeAction	接收到入群申请列表的变更时可用该值判断是删除动作还是新增的动作

详情

当入群申请列表发生变化时会回调当前方法

调用时机：通过 [create] 创建ZIM实例后。
相关接口：[sendGroupJoinApplication]，[sendGroupInviteApplications]。

支持版本：2.15.0 及以上。

onGroupApplicationUpdated

void onGroupApplicationUpdated(ZIM zim, ArrayList<ZIMGroupApplicationInfo> applicationList)

当入群申请列表发生变化时会回调当前方法

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
applicationList	ArrayList<ZIMGroupApplicationInfo>	入群申请列表变更的数据

详情

当入群申请列表发生变化时会回调当前方法

调用时机：通过 [create] 创建ZIM实例后。
相关接口：[acceptGroupJoinApplication]，[rejectGroupJoinApplication]，[acceptGroupInviteApplication]，[rejectGroupInviteApplication]。

支持版本：2.15.0 及以上。

onConversationChanged

void onConversationChanged(ZIM zim, ArrayList<ZIMConversationChangeInfo> conversationChangeInfoList)

收到会话更新的通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
conversationChangeInfoList	ArrayList<ZIMConversationChangeInfo>	会话变更的信息。

详情

当会话发生增加、删除、修改、置顶、取消置顶时，触发该回调返回会话更新的通知。

通知时机：当会话存在新的消息更新、或会话本身增加、删除、修改时触发通知。
相关接口：可通过 [sendPeerMessage] 、[sendGroupMessage]、[sendRoomMessage]、[deleteConversation]、[deleteMessage]、[deleteMessageByConversationID]、[updateConversationPinnedState] 触发。

支持版本：2.0.0 及以上。
注意事项：conversationID 与单聊的 toUserID、群聊的 GroupID 一致。

onConversationMessageReceiptChanged

void onConversationMessageReceiptChanged(ZIM zim, ArrayList<ZIMMessageReceiptInfo> infos)

收到回执的会话已读更新的通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
infos	ArrayList<ZIMMessageReceiptInfo>	回执信息。

详情

当消息接收方进行会话已读后，消息发送方通过此回调得知。

通知时机：当消息接收方进行会话已读时触发通知。
相关接口：当对端调用通过 [sendConversationMessageReceiptRead] 触发。

支持版本：2.5.0 及以上。

onConversationSyncStateChanged

void onConversationSyncStateChanged(ZIM zim, ZIMConversationSyncState state)

收到会话列表同步进度的通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
state	ZIMConversationSyncState	会话同步的状态。

详情

当 SDK 首次登录后开始从服务端同步会话的流程，以及流程完成或失败时，触发该回调返回会话更新的通知。

通知时机：当 SDK 确认需要从服务端拉取列表数据时触发通知。

支持版本：2.21.0 及以上。
注意事项：conversationID 与单聊的 toUserID、群聊的 GroupID 一致。

onConversationsAllDeleted

void onConversationsAllDeleted

收到全部会话删除的通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
info	ZIMConversationsAllDeletedInfo	全部会话被删除的信息。

详情

该回调返回全部会话被删除的通知。

通知时机：当其他端删除全部会话时，本端触发通知。
相关接口：可通过 [deleteAllConversations] 触发。

支持版本：2.12.0 及以上。

onMessageReceiptChanged

void onMessageReceiptChanged(ZIM zim, ArrayList<ZIMMessageReceiptInfo> infos)

收到回执的消息已读更新的通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
infos	ArrayList<ZIMMessageReceiptInfo>	回执信息。

详情

当消息接收方进行消息已读后，消息发送方通过此回调得知。

通知时机：当消息接收方进行消息已读时触发通知。
相关接口：当对端调用通过 [sendMessageReceiptsRead] 触发。

支持版本：2.5.0 及以上。

onConversationTotalUnreadMessageCountUpdated

void onConversationTotalUnreadMessageCountUpdated(ZIM zim, int totalUnreadMessageCount)

会话总未读数更新的通知回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
totalUnreadMessageCount	int	更新后的总未读数。

详情

该回调用于返回会话的总未读数。

通知时机：登录时、调用 [deleteConversation]、[deleteMessage]、[deleteAllMessage]、[clearConversationUnreadMessageCount] 、[clearConversationTotalUnreadMessageCount] 使消息未读数发生变化触发该回调。
相关接口：[deleteConversation]、[deleteMessage]、[deleteMessage]、[clearConversationUnreadMessageCount]、[clearConversationTotalUnreadMessageCount]

支持版本：2.0.0 及以上。

onGroupMessageReceived

void onGroupMessageReceived(ZIM zim, ArrayList<ZIMMessage> messageList, ZIMMessageReceivedInfo info, String fromGroupID)

收到群消息的回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
messageList	ArrayList<ZIMMessage>	收到的消息的列表。
info	ZIMMessageReceivedInfo	消息接收事件相关的信息。
fromGroupID	String	收到消息的群组 ID。

详情

用户在线时，可通过此回调接收在线群组消息。用户重新登录 ZIM SDK 后，可以通过通过此回调接收离线期间（最长7天）收到的所有群聊消息。

调用时机：通过 [create] 创建 ZIM 实例后，且所在群成员发送消息时，会收到该回调。
相关接口：可通过 [sendGroupMessage] 向其他群成员发送消息。

支持版本：2.18.0 及以上。

onPeerMessageReceived

void onPeerMessageReceived(ZIM zim, ArrayList<ZIMMessage> messageList, ZIMMessageReceivedInfo info, String fromUserID)

收到单聊消息的回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
messageList	ArrayList<ZIMMessage>	收到的消息的列表。
info	ZIMMessageReceivedInfo	接收消息事件的相关信息。
fromUserID	String	消息发送者的唯一标识符。

详情

用户在线时，可通过此回调接收在线单聊消息。用户重新登录 ZIM SDK 后，可以通过此回调接收离线期间（最长 7 天）收到的所有单聊消息。

调用时机：通过 [create] 创建 ZIM 实例后，且该其他用户向你发送消息时，会收到该回调。
相关接口：可通过 [sendPeerMessage] 向其他成员发送消息。

支持版本：2.18.0 及以上。

onRoomMessageReceived

void onRoomMessageReceived(ZIM zim, ArrayList<ZIMMessage> messageList, ZIMMessageReceivedInfo info, String fromRoomID)

收到房间消息的回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
messageList	ArrayList<ZIMMessage>	收到的消息的列表。
info	ZIMMessageReceivedInfo	消息接收事件携带的信息。
fromRoomID	String	收到消息的房间 ID。

详情

用户在线时，可通过此回调接收在线房间消息。用户从离线恢复到在线后，若仍在房间中，即可通过此回调接收离线期间内的所有房间消息。

调用时机：通过 [create] 创建 ZIM 实例后，且该其他用户向当前已经加入或创建的房间发送消息时，会收到该回调。
相关接口：可通过 [sendRoomMessage] 向其他房间成员发送消息。

支持版本：2.18.0 及以上。

onMessageEdited

void onMessageEdited(ZIM zim, ArrayList<ZIMMessage> messageList)

收到编辑消息的回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
messageList	ArrayList<ZIMMessage>	收到的消息的列表。

详情

当其他人编辑消息成功时，将会收到此回调。

调用时机：通过 [create] 创建 ZIM 实例后，且其他用户编辑消息成功时，会收到该回调。
相关接口：可通过 [editMessage] 编辑自己发送成功的消息。

支持版本：2.20.0 及以上。

onMessagePinStatusChanged

void onMessagePinStatusChanged(ZIM zim, ArrayList<ZIMMessagePinStatusChangeInfo> changeInfoList)

收到消息置顶状态变更的通知。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
changeInfoList	ArrayList<ZIMMessagePinStatusChangeInfo>	收到的消息置顶状态变更信息的列表。

详情

当会话内消息被置顶或取消置顶成功时，将会收到此通知。

调用时机：通过 [create] 创建 ZIM 实例后，且其他用户置顶或取消置顶消息成功时，会收到该回调。
相关接口：可通过 [pinMessage] 编辑自己发送成功的消息。

支持版本：2.25.0 及以上。

onMessageRevokeReceived

void onMessageRevokeReceived(ZIM zim, ArrayList<ZIMMessage> messageList)

收到撤回消息的回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
messageList	ArrayList<ZIMMessage>	收到的消息的列表。

详情

当其他人发来消息然后撤回时，将会收到此回调。

调用时机：通过 [create] 创建 ZIM 实例后，且该其他用户向你发送消息后撤回时，会收到该回调。
相关接口：可通过 [revokeMessage] 撤回向其他成员发送的消息。

支持版本：2.5.0 及以上。

onMessageSentStatusChanged

void onMessageSentStatusChanged(ZIM zim, ArrayList<ZIMMessageSentStatusChangeInfo> infos)

收到消息发送状态变化的回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
infos	ArrayList<ZIMMessageSentStatusChangeInfo>	收到的消息的列表。

详情

当消息发送状态发生变化时，将会收到此回调。

调用时机：发送消息状态发生变化时，会收到该回调。
相关接口：可通过 [sendMessage] 向其他成员发送的消息。

支持版本：2.6.0 及以上。

onBroadcastMessageReceived

void onBroadcastMessageReceived(ZIM zim, ZIMMessage message)

收到全员推送消息的回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
message	ZIMMessage	收到的消息。

详情

当收到服务端接口 [SendMessageToAllUsers] 发送的消息时收到该回调。

调用时机：登录 ZIM 服务后，且服务端调用接口 [SendMessageToAllUsers] 发送的消息时，会收到该回调。

支持版本：2.10.0 及以上。

onMessageReactionsChanged

void onMessageReactionsChanged(ZIM zim, ArrayList<ZIMMessageReaction> reactions)

收到表态变更的回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
reactions	ArrayList<ZIMMessageReaction>	变更的表态列表。

详情

当表态发生变更时收到该回调。

调用时机：通过 [create] 创建 ZIM 实例后且登录前，即可注册此回调。
通知时机：其他用户对单聊或群聊的消息添加或删除表态后。
相关接口：[addMessageReaction]、[deleteMessageReaction]。

支持版本：2.10.0 及以上。

onMessageDeleted

void onMessageDeleted

消息被删除的回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
deletedInfo	ZIMMessageDeletedInfo	被删除的消息信息。

详情

多端登录场景时，用户在 A 设备删除服务端消息后，其他在线的多端设备会收到此回调。

支持版本：2.11.0 及以上。

onReceivePeerMessage

deprecated

void onReceivePeerMessage(ZIM zim, ArrayList<ZIMMessage> messageList, String fromUserID)

收到点对点消息的回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
messageList	ArrayList<ZIMMessage>	收到的消息的列表。
fromUserID	String	消息发送方的用户 ID。与单聊会话 ID 一致。

详情

当收到其他人发来的点对点消息时，将会收到此回调。

调用时机：通过 [create] 创建 ZIM 实例后，且该其他用户向你发送消息时，会收到该回调。
相关接口：可通过 [sendPeerMessage] 向其他成员发送消息。

支持版本：1.1.0 及以上。

已废弃

该函数于 2.18.0 版本被废弃，请使用 [onPeerMessageReceived]。

onReceiveRoomMessage

deprecated

void onReceiveRoomMessage(ZIM zim, ArrayList<ZIMMessage> messageList, String fromRoomID)

收到房间消息的回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
messageList	ArrayList<ZIMMessage>	收到的消息的列表。
fromRoomID	String	收到消息的房间 ID。

详情

当收到房间内消息时，将会收到此回调。

调用时机：通过 [create] 创建 ZIM 实例后，且该其他用户向当前已经加入或创建的房间发送消息时，会收到该回调。
相关接口：可通过 [sendRoomMessage] 向其他房间成员发送消息。

支持版本：1.1.0 及以上。

已废弃

该函数于 2.18.0 版本被废弃，请使用 [onRoomMessageReceived]。

onMessageRepliedCountChanged

void onMessageRepliedCountChanged(ZIM zim, ArrayList< ZIMMessageRootRepliedCountInfo> infos)

回复消息树的数量发生变更的事件。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
infos	ArrayList< ZIMMessageRootRepliedCountInfo>	根消息的回复数量信息列表。

详情

有新的回复消息时，其对应的的根消息的回复数量通过此事件告知。

支持版本：2.17.0 及以上。

onMessageRepliedInfoChanged

void onMessageRepliedInfoChanged(ZIM zim, ArrayList<ZIMMessage> messageList)

回复消息的回复信息的变更事件。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
messageList	ArrayList<ZIMMessage>	收到的消息的列表。

详情

回复消息引用的源消息被删除和撤回后，收到的回复消息的变更事件。

支持版本：2.17.0 及以上。

onReceiveGroupMessage

deprecated

void onReceiveGroupMessage(ZIM zim, ArrayList<ZIMMessage> messageList, String fromGroupID)

收到群消息的回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
messageList	ArrayList<ZIMMessage>	收到的消息的列表。
fromGroupID	String	消息所属的 Group ID。

详情

当收到群消息时，将会收到此回调。

调用时机：通过 [create] 创建 ZIM 实例后，且所在群成员发送消息时，会收到该回调。
相关接口：可通过 [sendGroupMessage] 向其他群成员发送消息。

支持版本：2.0.0 及以上。

已废弃

该函数于 2.18.0 版本被废弃，请使用 [onGroupMessageReceived]。

onRoomStateChanged

void onRoomStateChanged(ZIM zim, ZIMRoomState state, ZIMRoomEvent event, String extendedData, String roomID)

房间连接状态发生改变的事件回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
state	ZIMRoomState	房间连接状态变更后的当前状态。
event	ZIMRoomEvent	导致房间连接状态发生变更的事件。
extendedData	String	事件发生时的额外信息，标准 JSON 字符串。
roomID	String	发生状态改变的房间 ID。

详情

房间连接状态发生改变的事件回调。

调用时机：用户位于房间中且房间状态改变时触发此回调。
相关接口：可通过 [onTokenWillExpire]，在token快要过期时会收到该回调。

支持版本：1.1.0 及以上。

onRoomMemberJoined

void onRoomMemberJoined(ZIM zim, ArrayList<ZIMUserInfo> memberList, String roomID)

其他成员加入房间的回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
memberList	ArrayList<ZIMUserInfo>	加入房间的成员列表。
roomID	String	发生此事件的房间 ID。

详情

加入一个房间后，当有其他成员也加入到此房间时，将会收到此回调。

业务场景：当房间内有其他成员加入时，会调用此回调。
调用时机：通过 [create] 创建ZIM实例后，且该用户位于其他成员加入的房间中时可调用该接口。
相关接口：可通过 [onRoomMemberLeft]，在有其他房间成员离开时，收到此回调。

支持版本：1.1.0 及以上。
注意事项：若用户当前不在此房间内，则不会调用该回调。

onRoomMemberLeft

void onRoomMemberLeft(ZIM zim, ArrayList<ZIMUserInfo> memberList, String roomID)

其他成员离开房间的回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例对象。
memberList	ArrayList<ZIMUserInfo>	离开房间的成员列表。
roomID	String	发生此事件的房间 ID。

详情

加入一个房间后，当有其他成员离开此房间时，将会收到此回调。

业务场景：当房间内有其他成员离开房间时，会调用此回调。
调用时机：通过 [create] 创建 ZIM 实例后，且该用户位于其他成员同一房间中时可调用该接口。
相关接口：可通过 [onRoomMemberJoined]，在有其他房间成员加入时，收到此回调。

支持版本：1.1.0 及以上。
注意事项：若用户当前不在此房间内，则不会调用该回调。

onRoomAttributesUpdated

void onRoomAttributesUpdated(ZIM zim, ZIMRoomAttributesUpdateInfo info, String roomID)

房间属性变更通知。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	zim实例。
info	ZIMRoomAttributesUpdateInfo	发生变更的房间属性。
roomID	String	发生房间属性变更的房间号。

详情

当房间中的房间属性发生变更时，通过该回调通知。

业务场景：语聊房场景下，有其他用户上下麦的通知。
通知时机：房间中的房间属性发生变更会触发该通知。

支持版本：1.3.0。

onRoomAttributesBatchUpdated

void onRoomAttributesBatchUpdated(ZIM zim, String roomID, ArrayList<ZIMRoomAttributesUpdateInfo> infos)

房间属性变更通知。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	zim实例。
roomID	String	发生房间属性变更的房间号。
infos	ArrayList<ZIMRoomAttributesUpdateInfo>	发生变更的房间属性。

详情

当房间中的房间属性发生变更时，通过该回调通知。

业务场景：语聊房场景下，有其他用户上下麦的通知。
通知时机：房间中的房间属性发生变更会触发该通知。

支持版本：1.3.0。

onRoomMemberAttributesUpdated

void onRoomMemberAttributesUpdated(ZIM zim, ArrayList<ZIMRoomMemberAttributesUpdateInfo> infos, ZIMRoomOperatedInfo operatedInfo, String roomID)

房间用户属性更新回调。

Declared in callback/ZIMEventHandler.java

参数

名称	类型	描述
zim	ZIM	ZIM 实例。
infos	ArrayList<ZIMRoomMemberAttributesUpdateInfo>	房间成员属性的更改信息。
operatedInfo	ZIMRoomOperatedInfo	房间操作信息。
roomID	String	房间 ID。

详情

当房间内有用户的属性发生变更时，将会收到该回调。

ZPNsManager

详情

ZPNs SDK 主类。

Declared in ZPNsManager.java

方法

getInstance

static

getInstance

ZPNsManager * getInstance()

获得 ZPNs 实例。

Declared in ZPNsManager.java

获取 ZPNs 实例。

业务场景：使用 ZPNs 时需要通过此方法获取 ZPNs 单例对象。

支持版本：2.0.0 及以上版本。

ZPNs 实例对象。

enableDebug

void enableDebug()

是否开启调试模式

Declared in ZPNsManager.java

是否开启调试模式

getPushConfig

ZPNsConfig getPushConfig()

获取 PushConfig 配置类。

Declared in ZPNsManager.java

用于获取 PushConfig 数据类对象。

业务场景：开发者需要获得 PushConfig 数据类对象时可调用该方法。
调用时机/通知时机：无调用时机限制，开发者需要时可调用。

支持版本：2.0.0 及以上版本。

PushConfig 配置类。

getZPNsMessage

ZPNsMessage getZPNsMessage(final Application context)

用户点击通知栏跳转 activity 时，可通过该接口获取 payload 等信息。

Declared in ZPNsManager.java

参数

名称	类型	描述
Application context	final	安卓上下文。

调用时机：在活动的 onCreate 或 onResume 方法中调用。

支持版本：2.5.0 及以上版本。

registerPush

void registerPush(final Application context)

该方法用于注册厂商离线推送。

Declared in ZPNsManager.java

参数

名称	类型	描述
Application context	final	安卓上下文。

详情

该方法用于注册厂商离线推送。

业务场景：当开发者需要使用离线推送时可调用该方法。

支持版本：ZPNs 2.0.0 及以上版本。

setApplicationIconBadgeNumber

void setApplicationIconBadgeNumber(Context context, int badgeNumber)

设置 app 本地角标数。

Declared in ZPNsManager.java

参数

名称	类型	描述
context	Context	有关应用程序环境的全局信息的接口。这是一个抽象类，它的实现由Android系统提供。它允许访问特定于应用程序的资源和类，以及对应用程序级操作(如启动活动、广播和接收意图等)的向上调用。
badgeNumber	int	需要设置的 app 本地角标数。

详情

设置 app 本地角标数。支持华为、VIVO、OPPO 的相关 API。

业务场景：开发者需要修改本地角标数时调用。
默认值：无。

支持版本：ZPNs 2.6.0 及以上版本。

setPushConfig

void setPushConfig(ZPNsConfig config)

设置各家厂商的推送设置项。

Declared in ZPNsManager.java

参数

名称	类型	描述
config	ZPNsConfig	ZPNs 配置类。

详情

设置各家厂商的推送设置项。

业务场景：开发者需要使用该方法来设置厂商推送的配置。
调用时机/通知时机：需要设置厂商推送时调用。

支持版本：2.0.0 及以上版本。

unregisterPush

void unregisterPush()

不需要离线推送时可调用此方法反注册。

Declared in ZPNsManager.java

不需要离线推送时可调用此方法反注册。

业务场景：当用户点击应用程序内的关闭消息通知时可调用该方法反注册。
调用时机/通知时机：需要反注册时调用。

支持版本：2.0.0 及以上版本。
使用限制：需要在 [registerPush] 调用后才可调用。

ZPNsMessageReceiver

详情

ZPNs回调。

Declared in ZPNsMessageReceiver.java

方法

onNotificationArrived

void onNotificationArrived(Context context, ZPNsMessage message)

厂商通知展示回调。

Declared in ZPNsMessageReceiver.java

参数

名称	类型	描述
context	Context	上下文。
message	ZPNsMessage	ZPNs 消息数据类.

详情

厂商通知展示回调。

通知时机：厂商通知展示回调触发时统一在此接口抛出。

支持版本：2.0.0 及以上版本。

onNotificationClicked

void onNotificationClicked(Context context, ZPNsMessage message)

厂商通知点击回调。

Declared in ZPNsMessageReceiver.java

参数

名称	类型	描述
context	Context	上下文。
message	ZPNsMessage	ZPNs 消息类对象。

详情

厂商通知点击回调。

通知时机：各厂商的通知点击回调，统一在此接口抛出。

支持版本：2.0.0 及以上版本。

onRegistered

void onRegistered(String Pushid, ZPNsRegisterMessage message)

生成 PushID 后触发的回调。

Declared in ZPNsMessageReceiver.java

参数

名称	类型	描述
Pushid	String	ZPNs 生成的 pushID,用于离线推送。
message	ZPNsRegisterMessage	离线推送消息对象。

详情

实现该回调可以在 [setDeviceToken] 调用后，会通过该回调返回 ZPNs 生成的 PushID。

业务场景：开发者在接入 SDK 后，若需要获得 PushID 可实现此回调。
通知时机：[setDeviceToken] 调用后触发此通知。

支持版本：2.0.0 及以上版本。

onThroughMessageReceived

void onThroughMessageReceived(Context context, ZPNsMessage message)

厂商透传消息回调。

Declared in ZPNsMessageReceiver.java

参数

名称	类型	描述
context	Context	上下文。
message	ZPNsMessage	ZPNs 消息类。

详情

厂商透传消息回调。

业务场景：各厂商返回的透传消息都会触发该接口，并在此接口抛出通知。
通知时机：推送到达时存在透传消息触发。

支持版本：2.0.0 及以上版本。