Android获取相册图片-实现选择相册图片功能

初识MediaProvider

需求：发朋友圈进行图片的选择，或者扫描二维码从图库选取。。。那么我们如何实现？这就需要借助媒体库的内容提供者MediaProvider，通过它，我们不仅可以读取图片，还可以读取视频，音频。

下面我们来看一下媒体库的内容提供者的URI(源码地址)

媒体库Uri 图片

MediaStore.Images.Media.EXTERNAL_CONTENT_URI

音频

MediaStore.Audio.Media.EXTERNAL_CONTENT_URI

视频

MediaStore.Video.Media.EXTERNAL_CONTENT_URI

拿到Uri，如果要为我们所用，我们必须对它的表中字段有所了解，接下来就是查看查询表中所有字段，看哪一个被我们所用。(注：别忘动态申请权限)

ContentResolver contentResolver = getContentResolver();
        Uri uri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI;
        Cursor query = contentResolver.query(uri,null,null,null,null,null);
        String[] columnNames = query.getColumnNames();
        while(query.moveToNext()) {
            Log.d(TAG,"----------------------------");
            for(String columnName : columnNames) {
                Log.d(TAG,"name--> "+ columnName + " value--> " + query.getString(query.getColumnIndex(columnName)));
            }
            Log.d(TAG,"----------------------------");
        }
        query.close();

表中所有字段，如下图，_data字段存放的是图片的路径，_display_name是图片的名称，date_added是图片产生的日期，还有修改时间等都是以long类型所展示，还有一些其他字段比如说经纬度，方向,mime类型等。常用必要字段有

_data,_display_name,date_added

----------------------------
name--> _id value--> 380623
name--> _data value--> /storage/emulated/0/DCIM/Camera/IMG_20180210_100635.jpg
name--> _size value--> 6256184
name--> _display_name value--> IMG_20180210_100635.jpg
name--> mime_type value--> image/jpeg
name--> title value--> IMG_20180210_100635
name--> date_added value--> 1518228395
name--> is_hdr value--> 0
name--> date_modified value--> 1518228395
name--> description value--> null
name--> picasa_id value--> null
name--> isprivate value--> null
name--> latitude value--> null
name--> longitude value--> null
name--> datetaken value--> 1518228395254
name--> orientation value--> 0
name--> mini_thumb_magic value--> null
name--> bucket_id value--> -1739773001
name--> bucket_display_name value--> Camera
name--> width value--> 2976
name--> height value--> 3968
name--> is_hw_privacy value--> null
name--> hw_voice_offset value--> null
name--> is_hw_favorite value--> null
name--> hw_image_refocus value--> null
name--> album_sort_index value--> null
name--> bucket_display_name_alias value--> null
name--> is_hw_burst value--> 0
name--> hw_rectify_offset value--> null
name--> special_file_type value--> 0
name--> special_file_offset value--> null
name--> cam_perception value--> null
name--> cam_exif_flag value--> 1
----------------------------

好了，对MediaProvider有一个初步认识，接下来我们要大刀阔斧的实践一下。

通过媒体库获取图片并显示

先看一下效果吧！对项目需求有一个初步的认识。

   图片列表展示我们采用的是RecyclerView加载列表数据，Glide框架展示图片，借助LoadManager异步加载媒体库中图片的数据，通过对RecyclerView.Adapter添加相应监听事件，实现对图片选择与否动态的UI变化，回传数据并显示不是采用传统的onActivityForResult方法，而是暴露接口方法，在Main中实现方法，通过方法的回调进行数据的传递。其中还有许多小细节，这里就不过多介绍，另外UI布局变化看代码就完了。下面进行项目详细分析

1）首先是实体类，注意一下isSelected成员变量，它在解决RecyclerView复用问题起到了不可小觑的作用。

public class PhotoItem {
    private String path;
    private String name;
    private long createTime;
    private boolean isSelected = false;
    // getter and setter方法
}

2）MainActivity布局不用多说了吧就一个孤单的按钮，然后是请求权限的简单处理

private void checkPermission() {
        int readExSD = checkSelfPermission(Manifest.permission.READ_EXTERNAL_STORAGE);
        if (readExSD != PackageManager.PERMISSION_GRANTED) {
            // 请求获取权限
            Log.d(TAG, "request permission...");
            requestPermissions(new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, REQUEST_READ_SD);
        } else {
            Log.d(TAG, "permission has granted");
        }
    }
    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == REQUEST_READ_SD && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            Log.d(TAG, "request permission success");
        } else {
            Log.d(TAG, "request permission fail");
        }
    }

3）接下来到了展示并可以挑选图片的Activity类ImagePickerActivity。先看一下onCreate方法吧，对所有方法进行了综合。

   protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_image_picker);
//        initData();
        initLoadManager();
        initView();
        initEvent();
        initConfig();
    }

initData()的作用和initLoadManager()的一样，只不过我们使用initLoadManager来加载媒体库中的数据，获取SD卡的文件，有的比较耗时，比如我们读取SD卡上的文件，可能遇到这样一种情况，当我点击打开读取文件的按钮之后，可能Main-Thread一直在读取文件，而Acitivity界面却迟迟没有显示，也可能导致ANR（Android No Response），用户体验很差，所以说一般我们不在Main-Thread线程中去做大量耗时操作，而是开启子线程去做，而LoadManager正切合应用场景。
3.1）initLoadManager()，其中有一些静态常量，最后完整项目我会给出。

private void initLoadManager() {
        // loadManager.getInstance(this)
        // 注意点：getInstance上下文对象必须是AppCompatActivity才可以
        LoaderManager loaderManager = LoaderManager.getInstance(this);
        loaderManager.initLoader(LOADER_ALL, null, new LoaderManager.LoaderCallbacks() {
            private final String[] IMAGE_PROJECTION = {
                MediaStore.Images.Media.DATA,
                        MediaStore.Images.Media.DISPLAY_NAME,
                        MediaStore.Images.Media.DATE_ADDED,
                        MediaStore.Images.Media._ID,
            };
            @NonNull
            @Override
            public Loader onCreateLoader(int i, @Nullable Bundle bundle) {
                if (i == LOADER_ALL) {
                    return new CursorLoader(ImagePickerActivity.this,
                            MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
                            IMAGE_PROJECTION, null, null, IMAGE_PROJECTION[2]+" DESC");
                }
                return null;
            }
            @Override
            public void onLoadFinished(@NonNull Loader loader, Cursor cursor) {
                if (cursor != null) {
                    mDatas.clear();
                    while (cursor.moveToNext()) {
                        PhotoItem item = new PhotoItem();
                        String path = cursor.getString(cursor.getColumnIndex(IMAGE_PROJECTION[0]));
                        String name = cursor.getString(cursor.getColumnIndex(IMAGE_PROJECTION[1]));
                        long date = cursor.getLong(cursor.getColumnIndex(IMAGE_PROJECTION[2]));
                        item.setCreateTime(date);
                        item.setName(name);
                        item.setPath(path);
                        mDatas.add(item);
                    }
                    mAdapter.setData(mDatas);
                    mAdapter.notifyDataSetChanged();
                }
            }
            @Override
            public void onLoaderReset(@NonNull Loader loader) {
            }
        });
    }

3.2）initView(),主要是做了控件的初始化，包括返回键，完成控件的查找，对RecyclerView设置布局管理器和适配器。

private void initView() {
    mGoBack = findViewById(R.id.go_back);
    mSelectFinished = findViewById(R.id.select_count);
    RecyclerView recyclerView = findViewById(R.id.recycler_view_picker);
    GridLayoutManager gridLayoutManager = new GridLayoutManager(this, 3, LinearLayoutManager.VERTICAL, false);
    mAdapter = new ImageListAdapter();
    // 最好不要在这里设置数据源，因为子线程完全获取到数据之前，适配器已经设置上空的数据源了，
    // 解决方法有很多种
    
    // 设置布局管理器
    recyclerView.setLayoutManager(gridLayoutManager);
    // 设置适配器
    recyclerView.setAdapter(mAdapter);
}

3.3）initEvent(),返回按钮和完成事件的监听，以及右上角完成控件的动态UI；右上角完成数字的动态变化是通过适配器暴露接口，实现条目的动态变化，而点击完成后数据的回传又涉及到了另外一个PickerConfig配置类，这里先搁置一下。对后面的程序理解不大碍事。

private void initEvent() {
    // (0/9)完成动态变化
    mAdapter.setOnItemSelectChanged(new ImageListAdapter.OnItemSelectChanged() {
        @Override
        public void changeSelectedCount(List selectedImages) {
            if (selectedImages.size() == 0) {
                mSelectFinished.setEnabled(false);
                mSelectFinished.setText("完成");
                return;
            }
            mSelectFinished.setEnabled(true);
            mSelectFinished.setTextColor(Color.WHITE);
            mSelectFinished.setText("("+selectedImages.size()+"/9)完成");
        }
    });
    mSelectFinished.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            // 点击完成后 得到静态内部实例，将结果回传到主界面，结束界面
            PickerConfig.OnImagesSelectFinishedListener selected = mPickerConfig.getSelectFinishedListener();
            selected.onSelectFinished(mAdapter.getSelectedImages());
            // 当选择完毕，清空列表，避免上次数据造成的缓存问题
            mAdapter.release();
            finish();
        }
    });
    mGoBack.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            finish();
        }
    });
}

4）RecyclerView的适配器代码，selectedImages存放已选择的图片实体，通过它我们可以做到图片的选择与否的UI变化，结合暴露给外部的接口实现右上角完成数量的动态变化，通过mDatas.get(i).isSelected判断该条目是否选择，解决RecyclerView的复用问题（如何看懂RecyclerView复用机制，解决复用问题就不在话下了，看了看懂底层源码还有一大段路要走啊！），通过SiezUtil这个类计算屏幕宽度，解决图片显示不规整的问题。其实我觉得下面代码能进行更好地重构，每个函数完成的功能不在单一，看起来有点复杂。留给后者吧！

public class ImageListAdapter extends RecyclerView.Adapter {
    public static final String TAG = "ImageListAdapter";
    private List mDatas = new ArrayList();
    private List selectedImages = new ArrayList(); // 已经选择的图片集合
    public List getSelectedImages() {
        return selectedImages;
    }
    private int selectMaxImages;
    public void setSelectMaxImages(int selectMaxImages) {
        this.selectMaxImages = selectMaxImages;
    }
    @NonNull
    @Override
    public ImageListAdapter.InnerHolder onCreateViewHolder(@NonNull ViewGroup viewGroup, int i) {
        Log.d(TAG, "onCreateViewHolder...");
        View itemView = LayoutInflater.from(viewGroup.getContext()).inflate(R.layout.item_photo, viewGroup, false);
        // 在没有下面几步操作之前，一屏只显示水平三个,这里我们通过获取屏幕宽度，使其一行平分三个
        Point point = SizeUtil.getScreenSize(itemView.getContext());
        RecyclerView.LayoutParams layoutParams = new RecyclerView.LayoutParams(point.x/3, point.x/3);
        itemView.setLayoutParams(layoutParams);
        return new InnerHolder(itemView);
    }
    @Override
    public void onBindViewHolder(@NonNull ImageListAdapter.InnerHolder innerHolder, final int i) {
        Log.d(TAG, "onBindViewHolder...");
        View itemView = innerHolder.itemView;
        ImageView imageItem = itemView.findViewById(R.id.iv_images);
        final CheckBox checkBox = itemView.findViewById(R.id.bt_is_selected);
        final View coverView = itemView.findViewById(R.id.image_cover);
        // 1. 实现Glide图片加载框架加载图片
        Glide.with(imageItem.getContext()).load(mDatas.get(i).getPath()).into(imageItem);
        // 2. 实现图片选中和未选中状态的改变
        // 2.1 解决复用出现的错乱问题，什么意思比如我选择了1、2两个条目，当往下滑动的时候会发现也相应
        // 选择了两个相邻条目
        if (mDatas.get(i).isSelected()) {
            checkBox.setButtonDrawable(R.drawable.ic_selected);
            coverView.setVisibility(View.VISIBLE);
        } else {
            coverView.setVisibility(View.GONE);
            checkBox.setButtonDrawable(R.drawable.ic_no_select);
        }
        imageItem.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                // 图片点击后，若当前图片被选择，则应移除被选择图片集合，然后恢复图层
                if (mDatas.get(i).isSelected()) {
                    mDatas.get(i).setSelected(false);
                    selectedImages.remove(mDatas.get(i));
                    coverView.setVisibility(View.GONE);
                    checkBox.setButtonDrawable(R.drawable.ic_no_select);
                    // 3.2 回调
                    if (mItemSelectChanged != null) {
                        mItemSelectChanged.changeSelectedCount(selectedImages);
                    }
                } else {
                    // 3.1 判断已选择的是否大于最大数量
                    if (selectedImages.size() >= selectMaxImages) {
                        Toast.makeText(checkBox.getContext(), "你最多只能选择" + selectMaxImages + "个图片或视频", Toast.LENGTH_SHORT).show();
                        // 结束
                        return;
                    }
                    // 若当前图片没有选择，则应被选择，然后设置图层
                    mDatas.get(i).setSelected(true);
                    selectedImages.add(mDatas.get(i));
                    // 3.2 回调
                    if (mItemSelectChanged != null) {
                        mItemSelectChanged.changeSelectedCount(selectedImages);
                    }
                    checkBox.setButtonDrawable(R.drawable.ic_selected);
                    coverView.setVisibility(View.VISIBLE);
                }
            }
        });
        // 3.实现挑选照片时右上角数目的动态变化 外部设置UI
    }
    private OnItemSelectChanged mItemSelectChanged;
    // 暴露接口给外部
    public void setOnItemSelectChanged(OnItemSelectChanged itemSelectChanged) {
        this.mItemSelectChanged = itemSelectChanged;
    }
    public void release() {
        selectedImages.clear();
    }
    public interface OnItemSelectChanged {
        void changeSelectedCount(List selectedImages);
    }
    @Override
    public int getItemCount() {
        return mDatas.size();
    }
    public void setData(List datas) {
        mDatas.clear();
        mDatas.addAll(datas);
        notifyDataSetChanged();
    }
    public class InnerHolder extends RecyclerView.ViewHolder {
        public InnerHolder(@NonNull View itemView) {
            super(itemView);
        }
    }
}

4）PickerConfig，该类定义了回调接口，暴露接口方法给外部。在MainActivity中实现接口中的方法，并通过PickerConfig得到的单一实例将MainActivity实例放入实例内部，回调–>ImagePickerActivity中“完成”控件设置监听事件，内部设置通过PickerConfig得到接口对象，触发方法。

public class PickerConfig {
    private int imageSelectCount = 1;
    private OnImagesSelectFinishedListener mSelectFinishedListener;
    private static PickerConfig sPickerConfig;
    private PickerConfig() {}
    // 单例模式 饿汉
    public static PickerConfig getInstance() {
        if (sPickerConfig == null) {
            sPickerConfig = new PickerConfig();
        }
        return sPickerConfig;
    }
    public interface OnImagesSelectFinishedListener {
        void onSelectFinished(List photoItems);
    }
    public void setOnImagesSelectFinishedListener(OnImagesSelectFinishedListener selectFinishedListener) {
        this.mSelectFinishedListener = selectFinishedListener;
    }
    public OnImagesSelectFinishedListener getSelectFinishedListener() {
        return mSelectFinishedListener;
    }
    public int getImageSelectCount() {
        return imageSelectCount;
    }
    public void setImageSelectCount(int imageSelectCount) {
        this.imageSelectCount = imageSelectCount;
    }
}

项目地址
作者：monkeylovejava