Easemob Chat Web API Reference

Easemob Chat Web SDK 是通过 HTML 网页加载的 JavaScript 和 Typescript 库。你可以使用 Agora Chat Web SDK 在网页浏览器中调用 API 实现 Chat 功能。

CHATSDK 是你引入的 SDK，包含了 SDK 的全部内容。

CHATROOM APIS 包含聊天室相关操作的 API。

方法	描述
joinChatRoom	加入聊天室。
leaveChatRoom	离开聊天室。
getChatRooms	分页获取聊天室列表。
listChatRoomMembers	分页列出聊天室的所有成员。
modifyChatRoom	修改聊天室详情。
fetchChatRoomAnnouncement	获取聊天室公告。
updateChatRoomAnnouncement	更新聊天室公告。
setChatRoomAdmin	设置聊天室管理员。该方法只有聊天室所有者才有权限调用。
removeChatRoomAdmin	移除聊天室管理员。该方法只有聊天室所有者才有权限调用。
getChatRoomAdmin	获取聊天室的所有管理员。
blockChatRoomMember	添加单个成员至聊天室黑名单。仅聊天室所有者和管理员有权限调用该方法。
unblockChatRoomMember	将单个用户从聊天室黑名单移除。仅聊天室所有者和管理员有权限调用该方法。
blockChatRoomMembers	批量添加成员至聊天室黑名单。仅聊天室所有者和管理员有权限调用该方法。
unblockChatRoomMembers	批量将成员从聊天室黑名单移除。仅聊天室所有者和管理员有权限调用该方法。
getChatRoomBlocklist	获取聊天室黑名单。
muteChatRoomMember	禁止聊天室用户发言。该方法只有聊天室所有者才有权限调用。
unmuteChatRoomMember	解除对聊天室用户的禁言。仅聊天室所有者和管理员有权限调用该方法。
disableSendChatRoomMsg	聊天室全员禁言。仅聊天室创建者和管理员可调用此方法。
enableSendChatRoomMsg	聊天室解除全员禁言。仅聊天室创建者和管理员可调用此方法。
getChatRoomMutelist	获取聊天室所有被禁言成员。
addUsersToChatRoomAllowlist	批量增加聊天室白名单成员。仅聊天室所有者和管理员有权限调用该方法。
removeChatRoomAllowlistMember	批量移除聊天室白名单成员。仅聊天室所有者和管理员有权限调用该方法。
isInChatRoomAllowlist	查询聊天室成员是否是在白名单中。普通成员可查询自己是否在聊天室白名单中；聊天室所有者和管理员可查询其他成员是否在白名单中。
getChatRoomAllowlist	获取聊天室白名单列表。仅聊天室所有者和管理员有权调用该方法。
setChatRoomAttribute	设置单个聊天室自定义属性。
setChatRoomAttributes	批量设置聊天室属性。
removeChatRoomAttribute	移除单个聊天室自定义属性。
removeChatRoomAttributes	批量移除聊天室属性。
getChatRoomAttributes	获取聊天室全部的自定义属性。

事件	描述
onChatroomEvent	当有聊天室事件时触发。

CONNECTION 是你需要实例化的一个类。

方法	描述
open	登录。
registerUser	注册用户。
isOpened	监测连接状态。-true：已连接；- false：未连接。
renewToken	更新 token。
send	发送消息。
addEventHandler	注册监听函数。
removeEventHandler	移除监听函数。

事件	描述
onConnected	当连接建立成功之后触发。
onDisconnected	当断开连接后触发。
onError	当发生错误时触发。
onMultiDeviceEvent	当在多个设备上操作时触发。
onOffline	当网络断开时触发。
onOnline	当网络连接成功时触发。
onTokenWillExpire	当 token 将要过期时触发。
onTokenExpired	当 token 过期后触发。

CONTACT APIS 包含联系人相关操作的 API。

方法	描述
addContact	添加好友。
deleteContact	删除指定好友。
declineContactInvite	拒绝好友申请。
acceptContactInvite	接受好友申请。
getContacts	获取联系人列表。
addUsersToBlocklist	添加联系人至黑名单。
removeUserFromBlocklist	将联系人从黑名单移除。
getBlocklist	获取黑名单列表。
fetchUserInfoById	查询用户属性。
updateUserInfo	修改当前用户的用户属性。
getConversationlist	获取会话列表。
deleteConversation	删除会话。
getHistoryMessages	获取对话历史消息。
addReaction	添加消息 Reaction。
deleteReaction	删除消息的 Reaction。
getReactionlist	获取消息的 Reaction 列表。
getReactionDetail	获取 Reaction 详情。

事件	描述
onContactInvited	当收到好友请求时触发。
onContactAgreed	当好友请求被接受时触发。
onContactRefuse	当好友请求被拒绝时触发。
onContactAdded	当添加好友成功后触发。
onContactDeleted	当删除好友成功后触发。
onReactionChange	当消息的 reaction 发生变化时触发。

EVENTHANDLER 是 SDK 注册监听事件的模块。

方法	描述
addEventHandler	添加监听事件。
removeEventHandler	移除监听事件。

GROUP APIS 包含群组相关操作的 API。

方法	描述
joinGroup	申请加入群组。
acceptGroupJoinRequest	同意用户加入群。仅群主和管理员可调用此方法。
rejectGroupJoinRequest	拒绝入群申请。仅群主和管理员可调用此方法。
inviteUsersToGroup	邀请用户加群。
acceptGroupInvite	接受入群邀请。
rejectGroupInvite	拒绝入群邀请。
leaveGroup	离开群组。
getJoinedGroups	列出某用户加入的所有群组。
getPublicGroups	分页获取公开群。
createGroup	创建群组。
destroyGroup	解散群组。仅群主可调用此方法。
changeGroupOwner	转让群组。仅群主可调用此方法。
modifyGroup	修改群信息。仅群组管理员可调用此方法。
getGroupInfo	获取群组详情。
fetchGroupAnnouncement	获取群公告。
updateGroupAnnouncement	更新群公告。
getGroupAdmin	获取群组下所有管理员。
setGroupAdmin	设置群管理员。仅群主可调用此方法。
removeGroupAdmin	移除群管理员。仅群主可调用此方法。
blockGroupMember	将单个成员加入群组黑名单。仅群主和管理员可调用此方法。
blockGroupMembers	批量添加成员至群组黑名单。仅群组管理员可调用此方法。
unblockGroupMember	将单个成员从群组黑名单移除。仅群组管理员可调用此方法。
unblockGroupMembers	将成员批量移出群组黑名单。仅群主和管理员可调用此方法。
getGroupBlocklist	获取群组黑名单。
muteGroupMember	将一个组成员禁言。仅群主和管理员可调用此方法。
unmuteGroupMember	解除禁言。仅群主和管理员可调用此方法。
getGroupMutelist	获取群组的禁言列表。
disableSendGroupMsg	设置全员禁言。仅群组管理员及以上身份可调用此方法。
enableSendGroupMsg	解除全员禁言。仅群组管理员及以上身份可调用此方法。
addUsersToGroupAllowlist	添加白名单。白名单里的成员可以在群禁言之后继续发言。仅群组管理员及以上身份可调用此方法。
removeGroupAllowlistMember	移除白名单。仅群组管理员及以上身份可调用此方法。
getGroupAllowlist	获取群组白名单列表。仅群组管理员及以上身份可调用此方法。
isInGroupAllowlist	检查当前用户是否在群组白名单中。app admin 可查询所有用户；app user 可查询自己。

事件	描述
onGroupEvent	当有群组事件发生时触发。

PRESENCE APIS 包含在线状态相关操作的 API。

方法	描述
publishPresence	发布自定义在线状态。
subscribePresence	订阅指定用户的在线状态。订阅成功后，在线状态变更时订阅者会收到回调通知。
unsubscribePresence	取消订阅指定用户的在线状态。
getSubscribedPresencelist	分页查询当前用户订阅了哪些用户的在线状态。
getPresenceStatus	查询指定用户的当前在线状态。

事件	描述
onPresenceStatusChange	当订阅的用户在线状态发生变化时触发。

SILENTMODE APIS 包含免打扰设置相关操作的 API。

方法	描述
setSilentModeForAll	设置当前登录用户的免打扰设置。
getSilentModeForAll	获取当前用户的免打扰设置。
setSilentModeForConversation	设置会话的免打扰。
clearRemindTypeForConversation	清除会话的离线推送提醒类型设置。
getSilentModeForConversation	获取会话的免打扰设置。
getSilentModeForConversations	批量获取指定会话的免打扰设置。
setPushPerformLanguage	设置用户推送翻译语言。
getPushPerformLanguage	获取用户设置的推送翻译语言。

THREAD APIS 包含消息子区相关操作的 API。

方法	描述
createChatThread	创建子区。
joinChatThread	加入子区。
leaveChatThread	退出子区。
destroyChatThread	解散子区。仅子区所属群组的群主和管理员可以调用该方法。
changeChatThreadName	修改子区名称。
getChatThreadMembers	分页获取子区成员。
removeChatThreadMember	移除子区成员。
getJoinedChatThreads	分页获取当前用户加入的子区列表。
getChatThreads	分页获取当前用户加入指定群组的子区列表。
getChatThreadLastMessage	批量获取指定子区中的最新一条消息。
getChatThreadDetail	获取子区详情。

事件	描述
onChatThreadChange	当子区发生变化时触发。

TRANSLATION APIS 包含翻译服务相关操作的 API。

方法	描述
getSupportedLanguages	获取翻译服务支持的语言。
translateMessage	翻译消息。

MESSAGE 是 SDK 构建消息的模块。

事件	描述
onTextMessage	当收到文本消息时触发。
onAudioMessage	当收到音频消息时触发。
onVideoMessage	当收到视频消息时触发。
onImageMessage	当收到图片消息时触发。
onCmdMessage	当收到透传消息时触发。
onCustomMessage	当收到自定义消息时触发。
onFileMessage	当收到文件消息时触发。
onLocationMessage	当收到位置消息时触发。
onStatisticMessage	当收到统计消息时触发。
onReceivedMessage	当收到消息已到达服务器的确认消息时触发。
onDeliveredMessage	当收到消息已被对方收到的确认消息时触发。
onReadMessage	当收到消息已被对方阅读的确认消息时触发。
onChannelMessage	当收到整个会话所有消息都置为已读的确认消息时触发。
onRecallMessage	当收到撤回消息通知时触发。

TYPES 是 SDK 类型声明的模块。

SERVER APIS 包含群组相关操作的 API。

方法	描述
acceptServerInvite	同意加入社区的邀请。
addServerTags	添加社区标签。
createServer	创建社区。
destroyServer	删除社区。
getJoinedServers	分页获取当前用户加入的社区。
getServerDetail	获取社区详情。
getServerMembers	分页获取社区成员。
getServerRole	获取当前用户在社区中的角色。
getServers	根据关键字搜索社区。
inviteUserToServer	邀请用户加入社区。
isInServer	查询当前用户是否在社区中。
joinServer	加入社区。
leaveServer	退出社区。
rejectServerInvite	拒绝加入社区的邀请。
removeServerAdmin	移除社区管理员。
removeServerMember	移除社区成员。
removeServerTags	移除社区标签。
setServerAdmin	设置社区管理员。
updateServer	更新社区。

事件	描述
onServerEvent	当有社区事件发生时触发。

CHANNEL APIS 包含频道相关操作的 API。

方法	描述
acceptChannelInvite	同意加入频道的邀请。
createChannel	创建频道。
destroyChannel	销毁频道。
getChannelDetail	获取频道详情。
getChannelMembers	分页获取频道成员。
getChannelMutelist	获取频道的禁言列表。
getPublicChannels	分页获取社区下的公开频道列表。
getPrivateChannels	分页获取可见的频道列表。
inviteUserToChannel	邀请用户加入频道。
isInChannel	查询当前用户是否在频道中。
joinChannel	加入频道。
leaveChannel	退出频道。
muteChannelMember	禁言频道成员。
rejectChannelInvite	拒绝加入频道的邀请。
removeChannelMember	移除频道成员。
unmuteChannelMember	解除禁言。
updateChannel	更新频道信息。

事件	描述
onChannelEvent	当有频道事件发生时触发。

CATEGORY APIS 包含频道分组相关操作的 API。

方法	描述
createCategory	创建频道分组。
updateCategory	更新频道分组信息。
getCategorylist	获取频道分组列表。
deleteCategory	销毁频道分组。
getCategoryPublicChannels	分页获取当前分组下的公开频道列表。
getCategoryPrivateChannels	分页获取当前分组下的私有频道列表。
transferChannel	将频道移动至其他分组。

事件	描述
onCategoryEvent	当有频道分组事件发生时触发。