图片选择器 Matisse 在 6.0 以上手机使用相机以及选择图片过滤小图功能

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);
   }
}