在 Android 設(shè)備上獲取照片、裁剪圖片、壓縮圖片 @TakePhoto V3.0 發(fā)布

TakePhoto 簡(jiǎn)介

TakePhoto是一款用于在Android設(shè)備上獲取照片（拍照或從相冊(cè)、文件中選擇）、裁剪圖片、壓縮圖片的開源工具庫，目前最新版本3.0.0。
3.0以下版本及API說明，詳見TakePhoto2.0+。

V3.0

  • 支持通過相機(jī)拍照獲取圖片
  • 支持從相冊(cè)選擇圖片
  • 支持從文件選擇圖片
  • 支持批量圖片選取
  • 支持圖片壓縮以及批量圖片壓縮
  • 支持圖片裁切以及批量圖片裁切
  • 支持照片旋轉(zhuǎn)角度自動(dòng)糾正
  • 支持自動(dòng)權(quán)限管理(無需關(guān)心SD卡及攝像頭權(quán)限等問題)
  • 支持對(duì)裁剪及壓縮參數(shù)個(gè)性化配置
  • 提供自帶裁剪工具(可選)
  • 支持智能選取及裁剪異常處理
  • 支持因拍照Activity被回收后的自動(dòng)恢復(fù)
  • 支持Android7.0

GitHub地址： https://github.com/crazycodeboy/TakePhoto

目錄

安裝說明

Gradle:

    compile 'com.jph.takephoto:takephoto_library:3.0.0'

Maven:

<dependency>
  <groupId>com.jph.takephoto</groupId>
  <artifactId>takephoto_library</artifactId>
  <version>3.0.0</version>
  <type>pom</type>
</dependency>

演示

運(yùn)行效果圖：

預(yù)覽圖
預(yù)覽圖

運(yùn)行效果圖
運(yùn)行效果圖

使用說明

使用TakePhoto有以下兩種方式：

方式一：通過繼承的方式

  1. 繼承TakePhotoActivity、TakePhotoFragmentActivity、TakePhotoFragment三者之一。
  2. 通過getTakePhoto()獲取TakePhoto實(shí)例進(jìn)行相關(guān)操作。
  3. 重寫以下方法獲取結(jié)果
 void takeSuccess(TResult result);
 void takeFail(TResult result,String msg);
 void takeCancel();

此方式使用簡(jiǎn)單，滿足的大部分的使用需求，具體使用詳見simple。如果通過繼承的方式無法滿足實(shí)際項(xiàng)目的使用，可以通過下面介紹的方式。

方式二：通過組裝的方式

可參照：TakePhotoActivity，以下為主要步驟：

1.實(shí)現(xiàn)TakePhoto.TakeResultListener,InvokeListener接口。

2.在 onCreate,onActivityResult,onSaveInstanceState方法中調(diào)用TakePhoto對(duì)用的方法。

3.重寫onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults)，添加如下代碼。

  @Override
    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        //以下代碼為處理Android6.0、7.0動(dòng)態(tài)權(quán)限所需
        TPermissionType type=PermissionManager.onRequestPermissionsResult(requestCode,permissions,grantResults);
        PermissionManager.handlePermissionsResult(this,type,invokeParam,this);
    }

4.重寫TPermissionType invoke(InvokeParam invokeParam)方法，添加如下代碼：

 @Override
    public TPermissionType invoke(InvokeParam invokeParam) {
        TPermissionType type=PermissionManager.checkPermission(TContextWrap.of(this),invokeParam.getMethod());
        if(TPermissionType.WAIT.equals(type)){
            this.invokeParam=invokeParam;
        }
        return type;
    }

5.添加如下代碼獲取TakePhoto實(shí)例：

   /**
     *  獲取TakePhoto實(shí)例
     * @return
     */
    public TakePhoto getTakePhoto(){
        if (takePhoto==null){
            takePhoto= (TakePhoto) TakePhotoInvocationHandler.of(this).bind(new TakePhotoImpl(this,this));
        }
        return takePhoto;
    }

API

獲取圖片

TakePhoto提供拍照，從相冊(cè)選擇，從文件中選擇三種方式獲取圖片。

API:

/**
 * 從文件中獲取圖片（不裁剪）
 */
void onPickFromDocuments();
/**
 * 從相冊(cè)中獲取圖片（不裁剪）
 */
void onPickFromGallery();
/**
 * 從相機(jī)獲取圖片(不裁剪)
 * @param outPutUri 圖片保存的路徑
 */
void onPickFromCapture(Uri outPutUri);
/**
 * 圖片多選
 * @param limit 最多選擇圖片張數(shù)的限制
 **/
void onPickMultiple(int limit);

以上三種方式均提供對(duì)應(yīng)的裁剪API，詳見：裁剪圖片。
注：
由于不同Android Rom廠商對(duì)系統(tǒng)有不同程度的定制，有可能導(dǎo)致某種選擇圖片的方式不支持，所以為了提高TakePhoto的兼容性，當(dāng)某種選的圖片的方式不支持時(shí)，TakePhoto會(huì)自動(dòng)切換成使用另一種選擇圖片的方式進(jìn)行圖片選擇。

裁剪圖片

API

TakePhoto支持對(duì)圖片進(jìn)行裁剪，無論是拍照的照片,還是從相冊(cè)、文件中選擇的圖片。你只需要調(diào)用TakePhoto的相應(yīng)方法即可：

/**
 * 從相機(jī)獲取圖片并裁剪
 * @param outPutUri 圖片裁剪之后保存的路徑
 * @param options 裁剪配置             
 */
void onPickFromCaptureWithCrop(Uri outPutUri, CropOptions options);
/**
 * 從相冊(cè)中獲取圖片并裁剪
 * @param outPutUri 圖片裁剪之后保存的路徑
 * @param options 裁剪配置
 */
void onPickFromGalleryWithCrop(Uri outPutUri, CropOptions options);
/**
 * 從文件中獲取圖片并裁剪
 * @param outPutUri 圖片裁剪之后保存的路徑
 * @param options 裁剪配置
 */
void onPickFromDocumentsWithCrop(Uri outPutUri, CropOptions options);
/**
 * 圖片多選，并裁切
 * @param limit 最多選擇圖片張數(shù)的限制
 * @param options  裁剪配置
 * */
void onPickMultipleWithCrop(int limit, CropOptions options);

對(duì)指定圖片進(jìn)行裁剪

另外，TakePhoto也支持你對(duì)指定圖片進(jìn)行裁剪：

/**
 * 裁剪圖片
 * @param imageUri 要裁剪的圖片
 * @param outPutUri 圖片裁剪之后保存的路徑
 * @param options 裁剪配置
 */
void onCrop(Uri imageUri, Uri outPutUri, CropOptions options)throws TException;
/**
 * 裁剪多張圖片
 * @param multipleCrop 要裁切的圖片的路徑以及輸出路徑
 * @param options 裁剪配置
 */
void onCrop(MultipleCrop multipleCrop, CropOptions options)throws TException;

CropOptions

CropOptions是用于裁剪的配置類，通過它你可以對(duì)圖片的裁剪比例，最大輸出大小，以及是否使用TakePhoto自帶的裁剪工具進(jìn)行裁剪等，進(jìn)行個(gè)性化配置。

Usage:

 CropOptions cropOptions=new CropOptions.Builder().setAspectX(1).setAspectY(1).setWithOwnCrop(true).create();  
 getTakePhoto().onPickFromDocumentsWithCrop(imageUri,cropOptions);  
 //或  
 getTakePhoto().onCrop(imageUri,outPutUri,cropOptions);

注：
由于不同Android Rom廠商對(duì)系統(tǒng)有不同程度的定制，有可能系統(tǒng)中沒有自帶或第三方的裁剪工具，所以為了提高TakePhoto的兼容性，當(dāng)系統(tǒng)中沒有自帶或第三方裁剪工具時(shí)，TakePhoto會(huì)自動(dòng)切換到使用TakePhoto自帶的裁剪工具進(jìn)行裁剪。

壓縮圖片

你可以選擇是否對(duì)圖片進(jìn)行壓縮處理，你只需要告訴它你是否要啟用壓縮功能以及CompressConfig即可。

API

 /**
  * 啟用圖片壓縮
  * @param config 壓縮圖片配置
  * @param showCompressDialog 壓縮時(shí)是否顯示進(jìn)度對(duì)話框
  * @return
  */
 void onEnableCompress(CompressConfig config,boolean showCompressDialog);

Usage:

TakePhoto takePhoto=getTakePhoto();
takePhoto.onEnableCompress(compressConfig,true);
takePhoto.onPickFromGallery();

如果你啟用了圖片壓縮，TakePhoto會(huì)使用CompressImage對(duì)圖片進(jìn)行壓縮處理，CompressImage目前支持對(duì)圖片的尺寸以及圖片的質(zhì)量進(jìn)行壓縮。默認(rèn)情況下，CompressImage開啟了尺寸與質(zhì)量雙重壓縮。

對(duì)指定圖片進(jìn)行壓縮

另外，你也可以對(duì)指定圖片進(jìn)行壓縮：
Usage:

new CompressImageImpl(compressConfig,result.getImages(), new CompressImage.CompressListener() {
    @Override
    public void onCompressSuccess(ArrayList<TImage> images) {
        //圖片壓縮成功
    }
    @Override
    public void onCompressFailed(ArrayList<TImage> images, String msg) {
        //圖片壓縮失敗
    }
}).compress();

CompressConfig

CompressConfig是用于圖片壓縮的配置類，你可以通過CompressConfig.Builder對(duì)圖片壓縮后的尺寸以及質(zhì)量進(jìn)行相關(guān)設(shè)置。如果你想改變壓縮的方式可以通過CompressConfig.Builder進(jìn)行相關(guān)設(shè)置。
Usage:

CompressConfig compressConfig=new CompressConfig.Builder().setMaxSize(50*1024).setMaxPixel(800).create();

兼容性

Android6.0

由于Android6.0新增了"運(yùn)行時(shí)權(quán)限控制(Runtime Permissions)"，為了應(yīng)對(duì)這一改變，TakePhoto加入和自動(dòng)權(quán)限管理，當(dāng)TakePhoto檢測(cè)到需要權(quán)限時(shí)，TakePhoto會(huì)自動(dòng)申請(qǐng)權(quán)限，所以小伙伴們不用擔(dān)心權(quán)限的使用問題。

Android7.0

在Android N中，Android 框架執(zhí)行了 StrictMode，應(yīng)用間共享文件和以前也有所區(qū)別。為了適配Android7.0的改變，同時(shí)也為了方便大家使用TakePhoto，TakePhoto會(huì)自動(dòng)根據(jù)手機(jī)的Android版本自行適配，小伙伴們依舊可以向TakePhoto傳遞Uri imageUri = Uri.fromFile(file);類型的Uri而不用擔(dān)心兼容性問題。

TakePhoto在深度兼容性方面的測(cè)試

兼容性測(cè)試報(bào)告
兼容性測(cè)試報(bào)告

獲取更高的兼容性

TakePhoto是基于Android官方標(biāo)準(zhǔn)API編寫的，適配了目前市場(chǎng)上主流的Rom。如果你在使用過程中發(fā)現(xiàn)了適配問題，可以提交Issues。

  1. 為適配部分手機(jī)拍照時(shí)會(huì)回收Activity，TakePhoto在onSaveInstanceState與 onCreate做了相應(yīng)的恢復(fù)處理。
  2. 為適配部分手機(jī)拍照或從相冊(cè)選擇圖片時(shí)屏幕方向會(huì)發(fā)生轉(zhuǎn)變,從而導(dǎo)致拍照失敗的問題，可以在AndroidManifest.xml中對(duì)使用了TakePhoto的Activity添加android:configChanges="orientation|keyboardHidden|screenSize"配置。
    eg:
<activity
    android:name=".MainActivity"
    android:screenOrientation="portrait"
    android:configChanges="orientation|keyboardHidden|screenSize"
    android:label="@string/app_name" >
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

貢獻(xiàn)

如果你在使用TakePhoto中遇到任何問題可以提Issues出來。另外歡迎大家為TakePhoto貢獻(xiàn)智慧，歡迎大家Fork and Pull requests。

最后

既然來了，留下個(gè)喜歡再走吧，鼓勵(lì)我繼續(xù)創(chuàng)作(_)∠※

如果喜歡我的文章，那就關(guān)注我的博客吧，讓我們一起做朋友~~

戳這里,加關(guān)注哦:

微博：第一時(shí)間獲取推送
個(gè)人博客：干貨文章都在這里哦
GitHub：我的開源項(xiàng)目

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容