通过媒体库获取数据
康师傅的小跟班
发表于
2020-04-19 05:22
2568
MediaProvider
ContentProvier
初识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有一个初步认识，接下来我们要大刀阔斧的实践一下。
通过媒体库获取图片并显示
先看一下效果吧！对项目需求有一个初步的认识。
因为GIF图片太大，所以老铁们暂且委屈一下自己吧[喝茶]:tea:，看看static图吧！ ::: hljs-center
:::
::: hljs-center
:::
图片列表展示我们采用的是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<Cursor>() {
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<Cursor> 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<Cursor> 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<Cursor> 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();
// 最好不要在这里设置数据源，因为子线程完全获取到数据之前，适配器已经设置上空的数据源了，
// 解决方法有很多种
/*Log.d(TAG, "initView: mDatas --> " + mDatas.size());
adapter.setData(mDatas);*/
// 设置布局管理器
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<PhotoItem> 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<ImageListAdapter.InnerHolder> {
public static final String TAG = "ImageListAdapter";
private List<PhotoItem> mDatas = new ArrayList<>();
private List<PhotoItem> selectedImages = new ArrayList<>(); // 已经选择的图片集合
public List<PhotoItem> 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<PhotoItem> selectedImages);
}
@Override
public int getItemCount() {
return mDatas.size();
}
public void setData(List<PhotoItem> 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<PhotoItem> 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;
}
}
完结！
