TakePhoto 簡介

分類：技術 時間:2016-10-25

TakePhoto 是一款用于在Android設備上獲取照片（拍照或從相冊、文件中選擇）、裁剪圖片、壓縮圖片的開源工具庫，目前最新版本 3.0.0 。

3.0以下版本及API說明，詳見 TakePhoto2.0 。

V3.0

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

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

目錄

  • 安裝說明
  • 演示
  • 使用說明
  • API
  • 貢獻

安裝說明

Gradle:

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

Maven:

lt;dependencygt;
  lt;groupIdgt;com.jph.takephotolt;/groupIdgt;
  lt;artifactIdgt;takephoto_librarylt;/artifactIdgt;
  lt;versiongt;3.0.0lt;/versiongt;
  lt;typegt;pomlt;/typegt;
lt;/dependencygt;

演示

運行效果圖：

1.png

2.jpg

使用說明

使用TakePhoto有以下兩種方式：

方式一：通過繼承的方式

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

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

方式二：通過組裝的方式

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

  1. 實現TakePhoto.TakeResultListener,InvokeListener接口。
  2. 在 onCreate,onActivityResult,onSaveInstanceState方法中調用TakePhoto對用的方法。
  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動態權限所需
     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實例： 
    /**
  *  獲取TakePhoto實例
  * @return
  */
 public TakePhoto getTakePhoto(){
     if (takePhoto==null){
         takePhoto= (TakePhoto) TakePhotoInvocationHandler.of(this).bind(new TakePhotoImpl(this,this));
     }
     return takePhoto;
 }

API

獲取圖片

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

API:

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

以上三種方式均提供對應的裁剪API，詳見： 裁剪圖片 。

注：

由于不同Android Rom廠商對系統有不同程度的定制，有可能導致某種選擇圖片的方式不支持，所以為了提高TakePhoto的兼容性，當某種選的圖片的方式不支持時，TakePhoto會自動切換成使用另一種選擇圖片的方式進行圖片選擇。

裁剪圖片

API

TakePhoto支持對圖片進行裁剪，無論是拍照的照片,還是從相冊、文件中選擇的圖片。你只需要調用TakePhoto的相應方法即可：

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

對指定圖片進行裁剪

另外，TakePhoto也支持你對指定圖片進行裁剪：

/**
 * 裁剪圖片
 * @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是用于裁剪的配置類，通過它你可以對圖片的裁剪比例，最大輸出大小，以及是否使用TakePhoto自帶的裁剪工具進行裁剪等，進行個性化配置。

Usage:

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

注：

由于不同Android Rom廠商對系統有不同程度的定制，有可能系統中沒有自帶或第三方的裁剪工具，所以為了提高TakePhoto的兼容性，當系統中沒有自帶或第三方裁剪工具時，TakePhoto會自動切換到使用TakePhoto自帶的裁剪工具進行裁剪。

壓縮圖片

你可以選擇是否對圖片進行壓縮處理，你只需要告訴它你是否要啟用壓縮功能以及CompressConfig

即可。

API

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

Usage:

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

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

對指定圖片進行壓縮

另外，你也可以對指定圖片進行壓縮：

Usage: 

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

CompressConfig

CompressConfig是用于圖片壓縮的配置類，你可以通過CompressConfig.Builder對圖片壓縮后的尺寸以及質量進行相關設置。如果你想改變壓縮的方式可以通過CompressConfig.Builder進行相關設置。

Usage: 

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

兼容性

Android6.0

由于Android6.0新增了”運行時權限控制(Runtime Permissions)”，為了應對這一改變，TakePhoto加入和自動權限管理，當TakePhoto檢測到需要權限時，TakePhoto會自動申請權限，所以小伙伴們不用擔心權限的使用問題。

Android7.0

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

TakePhoto在深度兼容性方面的測試

3.jpg

獲取更高的兼容性

TakePhoto是基于Android官方標準API編寫的，適配了目前市場上主流的Rom。如果你在使用過程中發現了適配問題，可以 提交Issues 。

  1. 為適配部分手機拍照時會回收Activity，TakePhoto在onSaveInstanceState與 onCreate做了相應的恢復處理。
  2. 為適配部分手機拍照或從相冊選擇圖片時屏幕方向會發生轉變,從而導致拍照失敗的問題，可以在AndroidManifest.xml中對使用了TakePhoto的Activity添加android:configChanges=”orientation|keyboardHidden|screenSize”配置。
lt;activity
    android:name=quot;.MainActivityquot;
    android:screenOrientation=quot;portraitquot;
    android:configChanges=quot;orientation|keyboardHidden|screenSizequot;
    android:label=quot;@string/app_namequot; gt;
    lt;intent-filtergt;
        lt;action android:name=quot;android.intent.action.MAINquot; /gt;
        lt;category android:name=quot;android.intent.category.LAUNCHERquot; /gt;
    lt;/intent-filtergt;
lt;/activitygt;

貢獻

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

最后

既然來了，留下個喜歡再走吧，鼓勵我繼續創作(^_^)∠※


Tags: 安卓開發

文章來源：http://www.jianshu.com/p/7506a2ff1df5

ads
ads
相關文章
ads

相關文章

ad