TakePhoto 簡(jiǎn)介
TakePhoto是一款用于在Android設(shè)備上獲取照片（拍照或從相冊(cè)、文件中選擇）、裁剪圖片、壓縮圖片的開源工具庫(kù)，目前最新版本2.0.0。
2.0以下版本及API說(shuō)明，詳見(jiàn)TakePhoto1.0+。
V2.0
- 支持通過(guò)相機(jī)拍照獲取圖片
- 支持從相冊(cè)選擇圖片
- 支持從文件選擇圖片
- 支持對(duì)圖片進(jìn)行壓縮
- 支持對(duì)圖片進(jìn)行裁剪
- 支持對(duì)裁剪及壓縮參數(shù)個(gè)性化配置
- 提供自帶裁剪工具(可選)
- 支持智能選取及裁剪異常處理
- 支持因拍照Activity被回收后的自動(dòng)恢復(fù)
GitHub地址： https://github.com/crazycodeboy/TakePhoto
預(yù)覽圖
運(yùn)行效果圖：
如何使用
使用TakePhoto有以下兩種方式：
方式一：通過(guò)繼承的方式
- 繼承
TakePhotoActivity、TakePhotoFragmentActivity、TakePhotoFragment三者之一。 - 通過(guò)
getTakePhoto()獲取TakePhoto實(shí)例進(jìn)行相關(guān)操作。 - 重寫以下方法獲取結(jié)果
void takeSuccess(String imagePath);
void takeFail(String msg);
void takeCancel();
此方式使用簡(jiǎn)單，滿足的大部分的使用需求，具體使用詳見(jiàn)simple。如果通過(guò)繼承的方式無(wú)法滿足實(shí)際項(xiàng)目的使用，可以通過(guò)下面介紹的方式。
方式二：通過(guò)組裝的方式
- 獲取TakePhoto實(shí)例
TakePhoto takePhoto=new TakePhotoImpl(getActivity(),this); - 在
onCreate,onActivityResult,onSaveInstanceState方法中調(diào)用TakePhoto對(duì)用的方法。 - 調(diào)用TakePhoto實(shí)例進(jìn)行相關(guān)操作。
- 在
TakeResultListener相關(guān)方法中獲取結(jié)果。
獲取圖片
TakePhoto提供拍照，從相冊(cè)選擇，從文件中選擇三種方式獲取圖片。
API:
/**
* 從文件中獲取圖片（不裁剪）
*/
void onPickFromDocuments();
/**
* 從相冊(cè)中獲取圖片（不裁剪）
*/
void onPickFromGallery();
/**
* 從相機(jī)獲取圖片(不裁剪)
* @param outPutUri 圖片保存的路徑
*/
void onPickFromCapture(Uri outPutUri);
以上三種方式均提供對(duì)應(yīng)的裁剪API，詳見(jiàn)：裁剪圖片。
注：
由于不同Android Rom廠商對(duì)系統(tǒng)有不同程度的定制，有可能導(dǎo)致某種選擇圖片的方式不支持，所以為了提高TakePhoto的兼容性，當(dāng)某種選的圖片的方式不支持時(shí)，TakePhoto會(huì)自動(dòng)切換成使用另一種選擇圖片的方式進(jìn)行圖片選擇。
裁剪圖片
API
TakePhoto支持對(duì)圖片進(jìn)行裁剪，無(wú)論是拍照的照片,還是從相冊(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);
對(duì)指定圖片進(jìn)行裁剪
另外，TakePhoto也支持你對(duì)指定圖片進(jìn)行裁剪：
/**
* 裁剪圖片
* @param imageUri 要裁剪的圖片
* @param outPutUri 圖片裁剪之后保存的路徑
* @param options 裁剪配置
*/
void onCrop(Uri imageUri, Uri outPutUri, CropOptions options)throws TException;
CropOptions
CropOptions是用于裁剪的配置類，通過(guò)它你可以對(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)中沒(méi)有自帶或第三方的裁剪工具，所以為了提高TakePhoto的兼容性，當(dāng)系統(tǒng)中沒(méi)有自帶或第三方裁剪工具時(shí)，TakePhoto會(huì)自動(dòng)切換到使用TakePhoto自帶的裁剪工具進(jìn)行裁剪。
壓縮圖片
你可以選擇是否對(duì)圖片進(jìn)行壓縮處理，你只需要告訴它你是否要啟用壓縮功能以及CompressConfig即可。
API
/**
* 啟用圖片壓縮
* @param config 壓縮圖片配置
* @param showCompressDialog 壓縮時(shí)是否顯示進(jìn)度對(duì)話框
* @return
*/
TakePhoto onEnableCompress(CompressConfig config,boolean showCompressDialog);
Usage:
getTakePhoto().onEnableCompress(compressConfig,true).onPickFromGalleryWithCrop(imageUri,cropOptions);
如果你啟用了圖片壓縮，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).compress(picturePath, new CompressImage.CompressListener() {
@Override
public void onCompressSuccess(String imgPath) {//圖片壓縮成功
}
@Override
public void onCompressFailed(String imagePath,String msg) {//圖片壓縮失敗
}
});
CompressConfig
CompressConfig是用于圖片壓縮的配置類，你可以通過(guò)CompressConfig.Builder對(duì)圖片壓縮后的尺寸以及質(zhì)量進(jìn)行相關(guān)設(shè)置。如果你想改變壓縮的方式可以通過(guò)CompressConfig.Builder進(jìn)行相關(guān)設(shè)置。
Usage:
CompressConfig compressConfig=new CompressConfig.Builder().setMaxSize(50*1024).setMaxPixel(800).create();
getTakePhoto().onEnableCompress(compressConfig,true).onPickFromGallery();
兼容性
TakePhoto在深度兼容性方面的測(cè)試
獲取更高的兼容性
TakePhoto是基于Android官方標(biāo)準(zhǔn)API編寫的，適配了目前市場(chǎng)上主流的Rom。如果你在使用過(guò)程中發(fā)現(xiàn)了適配問(wèn)題，可以提交Issues。
- 為適配部分手機(jī)拍照時(shí)會(huì)回收
Activity，TakePhoto在onSaveInstanceState與onCreate做了相應(yīng)的恢復(fù)處理。 - 為適配部分手機(jī)拍照或從相冊(cè)選擇圖片時(shí)屏幕方向會(huì)發(fā)生轉(zhuǎn)變,從而導(dǎo)致拍照失敗的問(wèn)題，可以在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àng)目中使用
為方便大家使用，現(xiàn)已將TakePhoto V2.0.0發(fā)布到JCenter(如果你對(duì)如何將項(xiàng)目發(fā)布到JCenter感興趣可以參考：《教你輕松將Android library 發(fā)布到JCenter)》
Gradle:
compile 'com.jph.takephoto:takephoto_library:2.0.0'
Maven:
<dependency>
<groupId>com.jph.takephoto</groupId>
<artifactId>takephoto_library</artifactId>
<version>2.0.0</version>
<type>pom</type>
</dependency>
最后
如果你對(duì)TakePhoto有更好的建議或想改造它，歡迎大家Fork and Pull requests。
