Android 一起來看看知乎開源的圖片選擇庫

標籤：Android

前言

在實際開發中，圖片選取器一直都是必不可少的一個部分，不管是 QQ 頭像的設定，還是發送一條裝逼的朋友圈，都要用到圖片選取器來給使用者選擇他們想要上傳的圖片，最近知乎開源了一款圖片選擇庫 Matisse 簡直美哭了，而且完全遵循 Android 互動設計規範，實在是很良心。

在開始本文之前，先欣賞一下這個圖片選取器的效果

是不是感覺相當的簡潔好看，反正我是這麼認為的。

一、基本使用1、匯入相應的依賴庫

Gradle:

repositories {    jcenter()}dependencies {    compile ‘com.zhihu.android:matisse:0.4.3‘}

有一點要注意一下， 這個圖片選擇庫是使用 Glide 或 Picasso 作為圖片載入引擎

如果你使用 Glide 作為你的圖片載入引擎，請添加 Glide 的 README 上所說的規則，以及添加額外的規則：

-dontwarn com.squareup.picasso.**

如果你使用 Picasso 作為你的圖片載入引擎，請添加 Picasso 的 README 上所說的規則，以及添加額外的規則：

-dontwarn com.bumptech.glide.**

2、啟動 Matisse

在正式寫代碼之前，有兩個相關的許可權需要先申請：

android.permission.READ_EXTERNAL_STORAGEandroid.permission.WRITE_EXTERNAL_STORAGE

所以，如果你的 APP 是跑在 Android 6.0+ 的話，你需要在下個步驟之前處理一下運行時許可權。

我們可以在平常的 Activity 或 Fragment 中啟動 MatisseActivity

Matisse.from(MainActivity.this)        .choose(MimeType.ofAll(), false) // 選擇 mime 的類型        .countable(true)        .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); // 設定作為標記的請求碼

3、接收選擇的結果

在啟動圖片選取器的 Activity 或 Fragment 中的 onActivityResult() 進行結果的回調處理

List<Uri> mSelected;@Overrideprotected void onActivityResult(int requestCode, int resultCode, Intent data) {    super.onActivityResult(requestCode, resultCode, data);    if (requestCode == REQUEST_CODE_CHOOSE && resultCode == RESULT_OK) {        mSelected = Matisse.obtainResult(data);        Log.d("Matisse", "mSelected: " + mSelected);    }}

二、常用的 APIMime 類型

Matisse 支援以下的 mime 類型

Mime type	File extensions	Media type
image/jpeg	jpg, jpeg	image
image/png	png	image
image/gif	gif	image
imagex-ms-bmp	bmp	image
video/mpeg	mpeg, mpg	video
video/mp4	mp4, m4v	video
video/quicktime	mov	video
video/3gpp	3gp, 3gpp	video
video/3gpp2	3g2, 3gpp2	video
video/x-matroska	mkv	video
video/webm	webm	video
video/mp2ts	ts	video
video/avi	avi	video

預設情況下，所有的映像和視頻都將顯示在 Matisse 中，而且你並不能通過以下方法來限制可選擇的 mime 類型：

• MimeType.ofAll()
• MimeType.of(MimeType type, MimeType... rest)
• MimeType.ofImage()
• MimeType.ofVideo()

不過你可以讓 Matisse 只顯示一種媒體類型，如果

• 啟動的時候，調用 showSingleMediaType(true)
• 只選擇圖片或者視頻

數量

預設情況
在縮圖的右上方有一個核取記號，讓你不僅可以選擇一個映像

自動成長的數目
使用 countable(true) 來顯示一個從 1 開始的數字

最大的數字數量
使用 maxSelectable(int maxSelectable) 來限制可選擇的最大數目

方向

使用 restrictOrientation*(@ScreenOrientation int orientation) 來設定映像選擇和預覽活動所需的方向。

網格的規格

如果你想要固定的跨度計數，請使用 spanCount(int spanCount)，當方向更改時，範圍計數將保持不變。

如果希望可以靈活地適應不同螢幕的網格大小，請使用 spanCount(int spanCount)，該值不一定被應用，因為圖片網格應該填滿視圖容器。測量的圖片網格的大小將儘可能接近該值。

縮圖縮放

使用 thumnailScale(float scale) 來設定縮圖位元影像相對於視圖大小的縮放比例，而且它應該是（0.0，1.0）中的浮點值。

三、主題內建的主題

在 Matisse 中有兩種內建的主題：

• Zhihu（亮藍色主題）
• Dracula（黑色主題）

當啟動 Matisse 的時候，調用 theme(@styleRes int themeId) 方法來使用其中一種主題

Matisse.from(MainActivity.this)    ...    .theme(R.style.Matisse_Zhihu | R.style.Matisse_Dracula)    .forResult(REQUEST_CODE_CHOOSE);

自訂佈景主題

從兩個內建主題，甚至是他們的父母派生自訂佈景主題，你可以自訂 Matisse 的外觀

這些屬性（在 attrs.xml 中定義）可以修改：

屬性	作用
colorPrimary	應用程式列的顏色
colorPrimaryDark	狀態列的較暗變體
toolbar: toolbar	toolbar 的風格
album.dropdown.title.color	專輯名稱下的專輯中的下拉式清單中的顏色
album.dropdown.count.color	工具列元素的顏色，元素包括互動中心圖示，所選的相簿標題和右側的下拉式箭頭表徵圖
album.thumbnail.placeholder	相簿縮圖的預留位置
album.emptyView	繪製圖片的空視圖
album.emptyView.textColor	空白視圖的文字顏色
item.placeholder	媒體網格的預留位置顏色或 drawable
page.bg	Activity 或 Fragment 頁面的背景顏色或 drawable
bottomToolbar.preview.textColor	底部工具列的背景顏色或 drawable
bottomToolbar.apply.textColor	預覽按鈕文本的底部工具列上的顏色
listPopupWindwoStyle	專輯列表的下拉式功能表樣式
capture.textColor	可能出現在頂部的捕獲網格的文本顏色

以上便是本文的全部內容，如果覺得寫得還可以的話，希望來一波關注和喜歡。

猜你喜歡

• Android 一款十分簡潔、優雅的日記 APP
• Android 能讓你少走彎路的乾貨整理
• Android 擼起袖子，自己封裝 DialogFragment
• 手把手教你從零開始做一個好看的 APP

Android 一起來看看知乎開源的圖片選擇庫