IM 类,所有 API 交互都通过该类的实例来操作,实例化支持的参数参见 IMOption。
| 方法 | 描述 |
|---|---|
| init | 初始化 SDK。 初始化时会完成与服务端的消息游标同步和历史信息同步。 |
| getMessagesByUser | 拉取用户混链消息。 通常无需业务调用,SDK 内部会轮询。 |
| createCustomMessage | 创建自定义消息。 |
| createTextMessage | 创建文本消息。 |
| sendMessage | 发送消息。 目前仅支持直接发送普通文本消息,发送图片消息、视频消息、语音消息、文件消息前请联系技术支持同学进行配置。 |
| deleteMessage | 删除消息。 |
| recallMessage | 撤回消息。 |
| getMessageByServerId | 获取消息的实时信息。 |
| getMessageReferenceList | 获取引用消息链。 若消息 B 引用了消息 A,消息 C 引用了消息 B,那么 A -> B -> C 就是一条引用消息链。通过 A、B、C 任意一条消息都可以获取这条消息链。 |
| modifyMessageProperty | 设置消息属性,常见使用场景:给某条消息点赞、加急等。(直播群暂不支持) |
| getConversation | 获取指定单个本地会话。 |
| getConversationOnline | 请求服务端更新本地会话后,获取指定单个会话。 |
| getConversationList | 获取本地会话列表。 |
| getConversationListOnline | 请求服务端更新本地会话后,获取会话列表。直播群列表请使用 getLiveConversationListOnline。 |
| getMessagesByConversation | 从服务器获取会话内区间的消息,默认情况下从本地最早的消息开始拉取 (cursor = conversation.firstMessageIndex) (直播群不可用) |
| getUserConversationList | 请求服务器获取用户的会话列表。 |
| createConversation | 创建群聊。 |
| leaveConversation | 离开群组。 |
| deleteConversation | 删除会话。 |
| dissolveConversation | 解散群聊。 |
| setConversationSettingInfo | 设置会话附加信息,如置顶、免打扰、收藏等。 |
| setConversationWeakMuteConfig | 配置会话低打扰模式。 |
| upsertConversationSettingExtInfo | 更新 Setting ext 拓展信息。 |
| setConversationCoreInfo | 设置群聊信息。 |
| upsertConversationCoreExtInfo | 更新 Core ext 拓展信息。 |
| getConversationListByTop | 获取顶置会话。 |
| getConversationListByFavorite | 获取收藏会话。 |
| markConversationRead | 标记会话已读。 |
| addParticipants | 添加群成员。 |
| removeParticipants | 移除群成员/离开直播群/移除直播群成员,v1.1.0 新增直播群功能。 |
| updateParticipant | 更新群成员信息。 |
| getParticipants | 获取 SDK 本地维护的群成员列表。 |
| getParticipantsOnline | 获取群成员列表。 此方法会在 SDK 内部循环调用分页接口,直至没有更多数据,然后把所有群成员数据一次返回。当群成员较多时,此方法耗时较久。 |
| setConversationMute | 设置群禁言(会话维度)。 |
| setParticipantMuteTime | 设置群禁言(成员维度)。 |
| dispose | 手动卸载 SDK。 |
多媒体消息插件,在 IM 实例化时传入后,IM 实例增加发送媒体消息的方法。
| 方法 | 描述 |
|---|---|
| createImageMessage | 创建图片消息。 |
| createAudioMessage | 创建音频消息。 |
| createVideoMessage | 创建视频消息。 |
| createFileMessage | 创建文件消息。 |
| refreshFileUrl | 根据消息内容刷新文件 URL。 |
| validateFileUrl | 校验文件 URL 是否在有效期。 |
| getImageResizeUrls | 获取图片 URL(缩放、转码)。 |
直播群插件,在 IM 实例化时传入后,IM 实例增加直播群相关的方法。v1.1.0 新增。
| 方法 | 描述 |
|---|---|
| joinLiveGroup | 加入直播群,加入成功时会启动直播 ping 和断线恢复重进(接口基于 addParticipants) |
| leaveLiveGroup | 离开直播群,并且会停止直播 ping(接口基于 removeParticipants) |
| setParticipantBlockTime | 拉黑直播群成员。 |
| getMuteParticipantsOnline | 获取直播群禁言成员列表。 |
| getBlockParticipantsOnline | 获取直播群被拉黑成员列表。 |
| getLiveParticipantMuteWhiteListOnline | 获取直播群禁言白名单。 |
| addLiveParticipantMuteWhiteList | 添加指定成员到直播群禁言白名单。 |
| removeLiveParticipantMuteWhiteList | 从直播群禁言白名单移除指定成员。 |
| getLiveConversationListOnline | 获取直播群列表。 |
| getLiveParticipantsOnline | 获取直播群在线成员列表。 |
| getLiveParticipantCountOnline | 获取直播群在线人数 |
| getLiveParticipantInfoOnline | 获取直播群指定成员状态信息(例如是否在线、最后活跃时间),v1.1.2 新增。 |
| getLiveParticipantDetailOnline | 获取直播群指定成员资料(例如成员在群中的昵称、头像),v1.5.0 新增。 |
| getLiveGroupHistoryMessageListOnline | 获取直播群历史消息 |
| updateLiveConversationMarks | 更新直播群内的标记类型 |
| getLiveConversationMarksOnline | 获取直播群内的标记类型 |
| updateLiveParticipantsMarks | 更新直播群内指定成员的标记,需要先在群中创建好对应标记类型 |
联系人插件,提供好友关系等能力;在 IM 实例化时传入后,IM 实例增加联系人相关的方法。v1.2.0 新增。
| 方法 | 描述 |
|---|---|
| getFriendReceiveApplyListOnline | 获取好友申请列表。 |
| getFriendListOnline | 获取好友列表。 |
| applyFriend | 申请添加好友。 |
| deleteFriend | 删除好友。 |
| replyFriendApply | 回应好友申请。 |
| markFriendReceiveApplyAsRead | 标记好友申请已读。(用于同步申请未读数等场景) |
| addUserToBlack | 将指定用户加入黑名单 |
| removeUserFromBlack | 将指定用户从黑名单移除 |
| userIsInMyBlack | 检查用户是否在黑名单中 |
| updateBlackUserState | 更新指定用户黑名单条目(例如更新 ext) |
| getBlacklistOnline | 获取用户黑名单 |
| updateFriend | 更新好友信息 |
| getUserProfilesOnline | 获取用户资料 |
| setUserProfile | 设置用户资料 |
| 方法 | 描述 |
|---|---|
| subscribe | 创建一个事件订阅 |
| unsubscribe | 取消一个事件订阅 |