V2NIMConversationService.java

浏览该文件的文档.

package com.netease.nimlib.sdk.v2.conversation;

import androidx.annotation.NonNull;
import com.netease.nimlib.sdk.v2.V2NIMError;
import com.netease.nimlib.sdk.v2.V2NIMFailureCallback;
import com.netease.nimlib.sdk.v2.V2NIMSuccessCallback;
import com.netease.nimlib.sdk.v2.V2NIMSyncResult;
import com.netease.nimlib.sdk.v2.conversation.enums.V2NIMConversationType;
import com.netease.nimlib.sdk.v2.conversation.model.V2NIMConversation;
import com.netease.nimlib.sdk.v2.conversation.option.V2NIMConversationOption;
import com.netease.nimlib.sdk.v2.conversation.params.V2NIMConversationFilter;
import com.netease.nimlib.sdk.v2.conversation.params.V2NIMConversationUpdate;
import com.netease.nimlib.sdk.v2.conversation.result.V2NIMConversationOperationResult;
import com.netease.nimlib.sdk.v2.conversation.result.V2NIMConversationResult;
import java.util.List;

public interface V2NIMConversationService {

    /**
     * 获取会话列表
     *
     * @param offset  分页偏移，首次传0，后续拉取采用上一次返回的offset
     * @param limit   分页拉取数量，不建议超过100;
     * @param success 成功回调
     * @param failure 失败回调
     */
    void getConversationList(long offset, int limit, V2NIMSuccessCallback<V2NIMConversationResult> success, V2NIMFailureCallback failure);

    /**
     * 根据查询参数获取会话列表
     *
     * @param offset  分页偏移，首次传0，后续拉取采用上一次返回的offset
     * @param limit   分页拉取数量，不建议超过100;
     * @param option  查询选项
     * @param success 成功回调
     * @param failure 失败回调
     */
    void getConversationListByOption(long offset, int limit, V2NIMConversationOption option, V2NIMSuccessCallback<V2NIMConversationResult> success,
            V2NIMFailureCallback failure);

    /**
     * 获取会话列表，通过会话id
     *
     * @param conversationId 会话id
     * @param success        成功回调
     * @param failure        失败回调
     */
    void getConversation(@NonNull String conversationId, V2NIMSuccessCallback<V2NIMConversation> success, V2NIMFailureCallback failure);

    /**
     * 根据会话id获取会话列表
     *
     * @param conversationIds 会话id列表
     * @param success         成功回调
     * @param failure         失败回调
     */
    void getConversationListByIds(@NonNull List<String> conversationIds, V2NIMSuccessCallback<List<V2NIMConversation>> success,
            V2NIMFailureCallback failure);

    /**
     * 查询当前全量置顶的会话列表
     * 排序方式：倒序
     * @param success
     * @param failure
     */
    void getStickTopConversationList(V2NIMSuccessCallback<List<V2NIMConversation>> success, V2NIMFailureCallback failure);

    /**
     * 创建会话
     *
     * @param conversationId 会话id
     * @param success        成功回调
     * @param failure        失败回调
     */
    void createConversation(@NonNull String conversationId, V2NIMSuccessCallback<V2NIMConversation> success, V2NIMFailureCallback failure);

    /**
     * 删除会话
     *
     * @param conversationId 会话id
     * @param clearMessage   是否删除会话消息
     * @param success        成功回调
     * @param failure        失败回调
     */
    void deleteConversation(@NonNull String conversationId, boolean clearMessage, V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);

    /**
     * 删除会话列表
     *
     * @param conversationIds 会话id列表
     * @param clearMessage    是否删除会话消息
     * @param success         成功回调
     * @param failure         失败回调
     */
    void deleteConversationListByIds(@NonNull List<String> conversationIds, boolean clearMessage, V2NIMSuccessCallback<List<V2NIMConversationOperationResult>> success,
            V2NIMFailureCallback failure);

    /**
     * 置顶会话
     *
     * @param conversationId 会话id
     * @param stickTop       是否置顶,true：置顶, false：取消置顶
     * @param success        成功回调
     * @param failure        失败回调
     */
    void stickTopConversation(@NonNull String conversationId, boolean stickTop, V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);

    /**
     * 更新会话
     *
     * @param conversationId 会话id
     * @param updateInfo     更新信息
     * @param success        成功回调
     * @param failure        失败回调
     */
    void updateConversation(@NonNull String conversationId, V2NIMConversationUpdate updateInfo, V2NIMSuccessCallback<Void> success,
            V2NIMFailureCallback failure);

    /**
     * 更新会话本地扩展字段
     *
     * @param conversationId 会话id
     * @param localExtension 本地扩展字段更新信息
     * @param success        成功回调
     * @param failure        失败回调
     */
    void updateConversationLocalExtension(@NonNull String conversationId, String localExtension, V2NIMSuccessCallback<Void> success,
            V2NIMFailureCallback failure);

    /**
     * 获取会话总未读数
     * @return 会话总未读数
     */
    int getTotalUnreadCount();

    /**
     * 根据会话id获取会话未读数
     *
     * @param conversationIds 会话id列表
     * @param success         成功回调
     * @param failure         失败回调
     */
    void getUnreadCountByIds(@NonNull List<String> conversationIds, V2NIMSuccessCallback<Integer> success, V2NIMFailureCallback failure);

    /**
     * 根据过滤条件获取相应的未读数
     *
     * @param filter  查询选项
     * @param success 成功回调
     * @param failure 失败回调
     */
    void getUnreadCountByFilter(V2NIMConversationFilter filter, V2NIMSuccessCallback<Integer> success, V2NIMFailureCallback failure);

    /**
     * 清空会话未读数
     *
     * @param success 成功回调
     * @param failure 失败回调
     */
    void clearTotalUnreadCount(V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);

    /**
     * 根据会话id清空会话未读数
     *
     * @param conversationIds 会话id列表
     * @param success         成功回调
     * @param failure         失败回调
     */
    void clearUnreadCountByIds(@NonNull List<String> conversationIds, V2NIMSuccessCallback<List<V2NIMConversationOperationResult>> success, V2NIMFailureCallback failure);

    /**
     * 根据会话分组清空相应会话的未读数
     *
     * @param groupId  会话分组id
     * @param success 成功回调
     * @param failure 失败回调
     */
    void clearUnreadCountByGroupId(@NonNull String groupId, V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);

    /**
     * 根据会话类型清空相应会话的未读数
     * @param conversationTypes
     * @param success
     * @param failure
     */
    void clearUnreadCountByTypes(@NonNull List<V2NIMConversationType> conversationTypes, V2NIMSuccessCallback<Void> success, V2NIMFailureCallback failure);

    /**
     * 订阅指定过滤条件的会话未读数
     *
     * @param filter 过滤条件
     * @return 是否订阅成功，成功返回null，失败返回V2NIMError
     */
    V2NIMError subscribeUnreadCountByFilter(@NonNull V2NIMConversationFilter filter);

    /**
     * 取消订阅指定过滤条件的会话未读数
     *
     * @param filter 过滤条件
     * @return 是否取消订阅成功，成功返回null，失败返回V2NIMError
     */
    V2NIMError unsubscribeUnreadCountByFilter(@NonNull V2NIMConversationFilter filter);

    /**
     *
     * 获取会话已读时间戳
     * 当前只支持P2P，高级群， 超大群
     * @param conversationId 会话ID
     * @param success 查询成功回调
     * @param failure 查询失败回调
     * @deprecated 该方法已被废弃，建议使用 {@link V2NIMConversation#getLastReadTime} 作为替代。
     */
    @Deprecated
    void getConversationReadTime(String conversationId, V2NIMSuccessCallback<Long> success, V2NIMFailureCallback failure);


    /**
     * 标记会话已读时间戳
     * 当前只支持P2P，高级群， 超大群
     * @param conversationId 会话ID
     * @param success 查询成功回调
     * @param failure 查询失败回调
     * @deprecated 该方法已被废弃，建议使用 {@link V2NIMConversationService#clearUnreadCountByIds} 作为替代。
     */
    @Deprecated
    void markConversationRead(String conversationId, V2NIMSuccessCallback<Long> success, V2NIMFailureCallback failure);

    /**
     * 设置当前聊天账号
     * @param conversationId 当前聊天会话id
     *                       如果为空字符串， null， 均表示不设置， 不在聊天界面
     *                       否则表示为具体的聊天界面:当前账号下， 不触发未读变更， 不触发在线通知，包括：P2P, TEAM, SUPERTEAM
     * @return 是否设置成功,失败返回V2NIMError
     */
    V2NIMSyncResult<Void> setCurrentConversation(String conversationId);

    /**
     * 添加会话监听
     *
     * @param listener 会话监听
     */
    void addConversationListener(@NonNull V2NIMConversationListener listener);

    /**
     * 移除会话监听
     *
     * @param listener 会话监听
     */
    void removeConversationListener(@NonNull V2NIMConversationListener listener);
}