浏览 SDKs · Android
SDKsAndroid商业版

读取消息上下文

使用 Android SDK 读取一条消息前后的上下文。

复制

从搜索结果或引用消息跳入聊天上下文时,把已经取得的 Message 作为锚点。

参数说明

参数类型是否必填说明
conversationIDString锚点消息所在的会话 ID。
startMsgMessage已经取得的锚点消息。
typeViewType上下文查看类型;引用消息使用 ViewType.History,搜索结果使用 ViewType.Search
beforeint锚点之前最多读取的消息数量。
afterint锚点之后最多读取的消息数量。
messageManager.fetchSurroundingMessages(
    new OnBase<Messages>() {
        @Override
        public void onSuccess(Messages messages) {
            List<Message> surrounding = messages.getData();
            // surrounding 是目标消息及其上下文。
        }

        @Override
        public void onError(int code, String error) {
            // 处理失败
        }
    },
    conversationID,
    targetMessage,
    ViewType.Search,
    20,
    20
);

成功回调中的 messages.getData() 是锚点前后取得的消息列表,消息字段见消息概览

beforeafter 分别限制锚点前后的数量。锚点靠近历史边界或部分消息已经删除时,返回结果可能少于请求总数。需要先定位消息时,见按 ID 查找消息