2018-7-23 更新
Matisse使用文档
Matisse 中使用 Filter 过滤图片大小等操作
Filter 过滤器，Matisse 中这样描述：Filter for choosing a {@link Item}. You can add multiple Filters through 也就是在你选择图片的时候过滤掉你不想选择的内容。
例如：网上常见的过滤gif功能，还有我这里说明的过滤图片大小功能.
首先创建一个子类，继承 Matisse 中使用 Filter
public class MiniSizeFilter extends Filter {
private int mMinWidth;
private int mMinHeight;
private int mMaxSize;
public MiniSizeFilter(int minWidth, int minHeight, int maxSizeInBytes) {
mMinWidth = minWidth;
mMinHeight = minHeight;
mMaxSize = maxSizeInBytes;
}
/**
* 约束的图片类型
* @return
*/
@Override
protected Set<MimeType> constraintTypes() {
return EnumSet.of(MimeType.JPEG, MimeType.PNG, MimeType.BMP, MimeType.WEBP);
}
@Override
public IncapableCause filter(Context context, Item item) {
if (!needFiltering(context, item)){
return null;
}
Point size = PhotoMetadataUtils.getBitmapBound(context.getContentResolver(), item.getContentUri());
// Log.e(TAG, "filter: mimeType--------->"+item.mimeType);
// Log.e(TAG, "filter: describeContents--------->"+item.describeContents());
// Log.e(TAG, "filter: duration--------->"+item.duration);
// Log.e(TAG, "filter: getContentUri--------->"+item.getContentUri());
// Log.e(TAG, "filter: id--------->"+item.id);
// 图片的大小
// Log.e(TAG, "filter: size--------->"+item.size);
// Log.e(TAG, "filter: uri--------->"+item.uri);
// 图片的宽高
// Log.e(TAG, "filter: size.x--------->"+size.x );
// Log.e(TAG, "filter: size.y--------->"+size.y );
if (size.x < mMinWidth || size.y < mMinHeight || item.size > mMaxSize) {
// IncapableCause.TOAST 表示 Toast 提示，它有三个选择：{TOAST, DIALOG, NONE}
return new IncapableCause(IncapableCause.TOAST, context.getString(R.string.image_size_to_small, mMinWidth,
String.valueOf(PhotoMetadataUtils.getSizeInMB(mMaxSize))));
}
return null;
}
}
使用方式如下：
Matisse.from(MainActivity.this)
...
.addFilter(new MiniSizeFilter(320, 320, 5 * Filter.K * Filter.K)) // 控制宽高为320*320 以上，大小为 50M 以下
.forResult(REQUEST_CODE_CHOOSE);
以上为2018-7-23更新
首发地址：dongxi520.com
需求：实现一个图片选择器，能选择本地图片和拍照
拿到需求，第一个想法就是看自己在规定时间上能否又快又好的实现。显然是不能（ 。。），现在那么多前辈都把轮子都造好了，我们直接拼装不就可以了吗？目前为止，我还是这样，等功力深厚成为前辈了再撸几个轮子给后辈使用，这些都是后话，先实现这个需求吧。
先去GitHub搜索一圈图片选择器，发现知乎开源的 Matisse 长的挺好看的，就选它了。使用步骤看GitHub的，官方的才是最正确的使用姿势。Matisse
或者是参看一下这位仁兄的介绍：Android 一起来看看知乎开源的图片选择库
官网的使用方式 默认是不开启拍照功能的，因此需要拍照功能的可以这么写
Matisse.from(PublishActivity.this)
.choose(MimeType.allOf()) // 选择 mime 的类型
.countable(true) // 显示选择的数量
.capture(true) // 开启相机，和 captureStrategy 一并使用否则报错
.captureStrategy(new CaptureStrategy(true,"com.meiqu.pianxin.ui.publish.MyFileProvider")) // 拍照的图片路径
.theme(R.style.Matisse_Dracula) // 黑色背景
.maxSelectable(9) // 图片选择的最多数量
.gridExpectedSize(getResources().getDimensionPixelSize(R.dimen.grid_expected_size)) // 列表中显示的图片大小
.restrictOrientation(ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED)
.thumbnailScale(0.85f) // 缩略图的比例
.imageEngine(new GlideEngine()) // 使用的图片加载引擎
.forResult(REQUEST_CODE_CHOOSE); // 设置作为标记的请求码，返回图片时使用
captureStrategy(new CaptureStrategy(true,"com.meiqu.pianxin.ui.publish.MyFileProvider"))
主要是告知系统拍照的图片存储位置第二个参数是自己实现继承FileProvider类的一个空类，需要在manifest文件中添加如下代码
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="com.meiqu.pianxin.ui.publish.MyFileProvider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/filepaths"/>
</provider>
- android:resource=”@xml/filepaths” 是在res/xml 目录下的创建的文件filepaths.xml
<paths xmlns:android="http://schemas.android.com/apk/res/android">
<!--代表外部存储区域的根目录下的文件 Environment.getExternalStorageDirectory()/DCIM/camerademo目录-->
<external-path name="mq_DCIM" path="DCIM/camerademo" />
<!--代表外部存储区域的根目录下的文件 Environment.getExternalStorageDirectory()/Pictures/camerademo目录-->
<external-path name="mq_Pictures" path="Pictures/camerademo" />
<!--代表app 私有的存储区域 Context.getFilesDir()目录下的images目录 /data/user/0/com.hm.camerademo/files/images-->
<files-path name="mq_private_files" path="images" />
<!--代表app 私有的存储区域 Context.getCacheDir()目录下的images目录 /data/user/0/com.hm.camerademo/cache/images-->
<cache-path name="mq_private_cache" path="images" />
<!--代表app 外部存储区域根目录下的文件 Context.getExternalFilesDir(Environment.DIRECTORY_PICTURES)目录下的Pictures目录-->
<external-files-path name="mq_external_files" path="Pictures" />
<!--代表app 外部存储区域根目录下的文件 Context.getExternalCacheDir目录下的images目录-->
<external-cache-path name="mq_external_cache" path="" />
<root-path name="mq_external_cache" path="" />
</paths>
- 以上使用在 5.0 以下的手机是没毛病的，在 6.0 这个动态权限的控制下就有些问题了
6.0 以上使用 Matisse 的正确姿势
可以自己去写动态权限判断
使用开源库，目前start 最多的动态权限库是 PermissionsDispatcher start已经5000+并且最近15天还在维护
Matisse 和 PermissionsDispatcher 的使用姿势
Matisse 需要用到相机和读写本地数据的权限
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.Manifest.permission.READ_PHONE_STATE" />
所以在调用了这些权限的地方是使用 PermissionsDispatcher 去动态设置，看PermissionsDispatcher 官网介绍
我在实际中使用
步骤：
- 在Activity或者Fragment上添加 @RuntimePermissions
- 在用到权限的方法（ 例如:void initData(),不能加上 private 修饰）名上添加 @NeedsPermission(Manifest.permission.READ_PHONE_STATE)
- 重写 onRequestPermissionsResult 方法，MainActivityPermissionsDispatcher.onRequestPermissionsResult(MainActivity.this, requestCode, grantResults);
- 在onCreate方法调用，MainActivityPermissionsDispatcher.initDataWithCheck(MainActivity.this);
实例：
@RuntimePermissions // 必须添加
public class MainActivity extends AppCompatActivity {
...
@Override protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
....
MainActivityPermissionsDispatcher.initDataWithCheck(MainActivity.this);
....
}
@NeedsPermission(Manifest.permission.READ_PHONE_STATE) // 必须添加
void initData() { // 会调用用户信息权限
DataCenter dc = DataCenter.getInstance();
dc.initDataCenter(this);
}
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
MainActivityPermissionsDispatcher.onRequestPermissionsResult(MainActivity.this, requestCode, grantResults);
}
}
