TakePhoto 是一款用于在Android設(shè)備上獲取照片（拍照或從相冊(cè)、文件中選擇）、裁剪圖片、壓縮圖片的開(kāi)源工具庫(kù)胀蛮，目前最新版本3.0.0。
3.0以下版本及API說(shuō)明糯钙，詳見(jiàn)TakePhoto2.0+粪狼。
V3.0
- 支持通過(guò)相機(jī)拍照獲取圖片
- 支持從相冊(cè)選擇圖片
- 支持從文件選擇圖片
- 支持批量圖片選取
- 支持圖片壓縮以及批量圖片壓縮
- 支持圖片裁切以及批量圖片裁切
- 支持照片旋轉(zhuǎn)角度自動(dòng)糾正
- 支持自動(dòng)權(quán)限管理(無(wú)需關(guān)心SD卡及攝像頭權(quán)限等問(wèn)題)
- 支持對(duì)裁剪及壓縮參數(shù)個(gè)性化配置
- 提供自帶裁剪工具(可選)
- 支持智能選取及裁剪異常處理
- 支持因拍照Activity被回收后的自動(dòng)恢復(fù)
- 支持Android7.0
GitHub地址： https://github.com/crazycodeboy/TakePhoto
目錄
- 安裝說(shuō)明
- 演示
- 使用說(shuō)明
- API
- 貢獻(xiàn)
安裝說(shuō)明
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)行效果圖：
使用說(shuō)明
使用TakePhoto有以下兩種方式：
方式一：通過(guò)繼承的方式
- 繼承TakePhotoActivity、TakePhotoFragmentActivity任岸、TakePhotoFragment三者之一再榄。
- 通過(guò)getTakePhoto()獲取TakePhoto實(shí)例進(jìn)行相關(guān)操作。
- 重寫(xiě)以下方法獲取結(jié)果
void takeSuccess(TResult result);
void takeFail(TResult result,String msg);
void takeCancel();
此方式使用簡(jiǎn)單享潜，滿(mǎn)足的大部分的使用需求困鸥，具體使用詳見(jiàn)simple。如果通過(guò)繼承的方式無(wú)法滿(mǎn)足實(shí)際項(xiàng)目的使用剑按，可以通過(guò)下面介紹的方式疾就。
方式二：通過(guò)組裝的方式
可參照：TakePhotoActivity，以下為主要步驟：
- 實(shí)現(xiàn)TakePhoto.TakeResultListener,InvokeListener接口吕座。
- 在 onCreate,onActivityResult,onSaveInstanceState方法中調(diào)用TakePhoto對(duì)用的方法虐译。
- 重寫(xiě)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);
}
- 重寫(xiě)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;
}
- 添加如下代碼獲取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撇叁，詳見(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);
/**
* 圖片多選繁堡，并裁切
* @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是用于裁剪的配置類(lèi)乡数，通過(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ì)話(huà)框
* @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開(kāi)啟了尺寸與質(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是用于圖片壓縮的配置類(lèi)酬姆，你可以通過(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();
兼容性
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)限的使用問(wè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);類(lèi)型的Uri而不用擔(dān)心兼容性問(wèn)題。
TakePhoto在深度兼容性方面的測(cè)試
獲取更高的兼容性
TakePhoto是基于Android官方標(biāo)準(zhǔn)API編寫(xiě)的痛单，適配了目前市場(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”配置圆仔。
<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中遇到任何問(wèn)題可以提Issues出來(lái)。另外歡迎大家為T(mén)akePhoto貢獻(xiàn)智慧蔫劣，歡迎大家Fork and Pull requests坪郭。
最后
既然來(lái)了，留下個(gè)喜歡再走吧脉幢，鼓勵(lì)我繼續(xù)創(chuàng)作(_)∠※
