IMediaEngine.java

package dev.engine.media;

import android.app.Activity;
import android.content.Context;
import android.content.Intent;
import android.net.Uri;

import androidx.fragment.app.Fragment;

import java.util.List;

/**
 * detail: Media Selector Engine 接口
 * @author Ttt
 */
public interface IMediaEngine<Config extends IMediaEngine.EngineConfig,
        Data extends IMediaEngine.EngineData> {

    /**
     * detail: Media Selector Config
     * @author Ttt
     */
    class EngineConfig {
    }

    /**
     * detail: Media Selector Data
     * @author Ttt
     */
    class EngineData {
    }

    // ==========
    // = 配置方法 =
    // ==========

    /**
     * 获取全局配置
     * @return 全局配置信息
     */
    Config getConfig();

    /**
     * 设置全局配置
     * @param config 新的配置信息
     */
    void setConfig(Config config);

    // =============
    // = 对外公开方法 =
    // =============

    /**
     * 打开相册拍照
     * @param activity {@link Activity}
     * @return {@code true} success, {@code false} fail
     */
    boolean openCamera(Activity activity);

    /**
     * 打开相册拍照
     * @param activity {@link Activity}
     * @param config   配置信息
     * @return {@code true} success, {@code false} fail
     */
    boolean openCamera(
            Activity activity,
            Config config
    );

    /**
     * 打开相册拍照
     * @param fragment {@link Fragment}
     * @return {@code true} success, {@code false} fail
     */
    boolean openCamera(Fragment fragment);

    /**
     * 打开相册拍照
     * @param fragment {@link Fragment}
     * @param config   配置信息
     * @return {@code true} success, {@code false} fail
     */
    boolean openCamera(
            Fragment fragment,
            Config config
    );

    // =

    /**
     * 打开相册选择
     * @param activity {@link Activity}
     * @return {@code true} success, {@code false} fail
     */
    boolean openGallery(Activity activity);

    /**
     * 打开相册选择
     * @param activity {@link Activity}
     * @param config   配置信息
     * @return {@code true} success, {@code false} fail
     */
    boolean openGallery(
            Activity activity,
            Config config
    );

    /**
     * 打开相册选择
     * @param fragment {@link Fragment}
     * @return {@code true} success, {@code false} fail
     */
    boolean openGallery(Fragment fragment);

    /**
     * 打开相册选择
     * @param fragment {@link Fragment}
     * @param config   配置信息
     * @return {@code true} success, {@code false} fail
     */
    boolean openGallery(
            Fragment fragment,
            Config config
    );

    // =

    /**
     * 打开相册预览
     * @param activity {@link Activity}
     * @return {@code true} success, {@code false} fail
     */
    boolean openPreview(Activity activity);

    /**
     * 打开相册预览
     * @param activity {@link Activity}
     * @param config   配置信息
     * @return {@code true} success, {@code false} fail
     */
    boolean openPreview(
            Activity activity,
            Config config
    );

    /**
     * 打开相册预览
     * @param fragment {@link Fragment}
     * @return {@code true} success, {@code false} fail
     */
    boolean openPreview(Fragment fragment);

    /**
     * 打开相册预览
     * @param fragment {@link Fragment}
     * @param config   配置信息
     * @return {@code true} success, {@code false} fail
     */
    boolean openPreview(
            Fragment fragment,
            Config config
    );

    // ==========
    // = 其他方法 =
    // ==========

    /**
     * 删除缓存文件
     * @param context {@link Context}
     * @param type    类型 ( 图片、视频 )
     */
    void deleteCacheDirFile(
            Context context,
            int type
    );

    /**
     * 删除全部缓存文件
     * @param context {@link Context}
     */
    void deleteAllCacheDirFile(Context context);

    /**
     * 是否图片选择 ( onActivityResult )
     * @param requestCode 请求 code
     * @param resultCode  resultCode
     * @return {@code true} success, {@code false} fail
     */
    boolean isMediaSelectorResult(
            int requestCode,
            int resultCode
    );

    // =

    /**
     * 获取 Media Selector Data List
     * @param intent onActivityResult Intent data
     * @return Media Selector Data List
     */
    List<Data> getSelectors(Intent intent);

    /**
     * 获取 Media Selector Uri List
     * @param intent   onActivityResult Intent data
     * @param original 是否使用原图
     * @return Media Selector Uri List
     */
    List<Uri> getSelectorUris(
            Intent intent,
            boolean original
    );

    /**
     * 获取 Single Media Selector Data
     * @param intent onActivityResult Intent data
     * @return Single Media Selector Data
     */
    Data getSingleSelector(Intent intent);

    /**
     * 获取 Single Media Selector Uri
     * @param intent   onActivityResult Intent data
     * @param original 是否使用原图
     * @return Single Media Selector Uri
     */
    Uri getSingleSelectorUri(
            Intent intent,
            boolean original
    );
}