Android上传图片之调用系统拍照和从相冊选择图片
本篇文章已授权微信公众号 guolin_blog (郭霖)独家公布
前言:
万丈高楼平底起,万事起于微末。不知不觉距离上篇博文已近四个月,2015年12月17日下午发了第一篇博文。如今是2016年4月6日。时间间隔长的过分啊,我自己都看不下去了。
原因呢?当然是自己的原因。事实上是有非常多时间来些博客的,可是这些时间都花在DOTA上了(还是太年轻啊)。请原谅我的过错…….
一、概述:
如今差点儿应用都会用到上传图片的功能,而要上传图片,首先得选择图片。本文不针对怎样上传图片到server(每一个项目与server交互的方式不同。因此不写上传图片到server相关代码)。仅仅是对选择图片做简单的介绍,没有涉及到对图片的圆角处理与剪裁。本文主要涉及下面几个简单的知识点:
- 简单的调用系统拍照和系统相冊选择图片
- 通过GridView实现动态加入图片的效果
- Adapter使用的小技巧
- Fragment中调用系统拍照该怎么获取数据(接口回调)
二、实现:
我们先来看项目文件夹:
一个Adapter、两个Activity,一个Fragment、一个工具类,一目了然。有人在这里有疑问了,为什么是两个Activity?不是三个吗?没错,理论上ChooseActivity、ChooseFragmentActivity、BaseActivity加起来是三个,只是在这里BaseActivity是模拟实际项目抽离Activity中公共的代码,不做为视图,所以我不把BaseActivity算进去。
ChooseActivity是模拟Activity中调用系统拍照和系统相冊选择图片。ChooseFragmentActivity中放入ChooseFragment模拟Fragment中调用系统拍照和系统相冊选择图片(在这里我定死了一个Fragment模拟项目实际情况,实际情况一个Activity中会有多个Fragment),ImageUtils做一些简单的图片处理。
SelectPicPopupWindow一个简单的PopupWindow,UploadImageAdapter动态选择图片上传的适配器。
先来点效果图吧:
图中展示的效果:点击默认图片弹出PopupWindow让用户选择拍照还是从相冊选择图片(模拟器中不便使用拍照功能,本人在几台手机上试过没有问题,请到真机上測试),选择好图片后已选择好的图片可长按删除。这里控制了最多选择6张图片。
简单的调用系统拍照和系统相冊选择图片
我们先来看是怎么调用系统拍照和从相冊选择图片的:
申明组件与变量:
/**
* 选择图片的返回码
*/
public final static int SELECT_IMAGE_RESULT_CODE = 200;
/**
* 当前选择的图片的路径
*/
public String mImagePath;
/**
* 自己定义的PopupWindow
*/
private SelectPicPopupWindow menuWindow;
弹出PopupWindow:
/**
* 拍照或从图库选择图片(PopupWindow形式)
*/
public void showPicturePopupWindow(){
menuWindow = new SelectPicPopupWindow(this, new OnClickListener() {
@Override
public void onClick(View v) {
// 隐藏弹出窗体
menuWindow.dismiss();
switch (v.getId()) {
case R.id.takePhotoBtn:// 拍照
takePhoto();
break;
case R.id.pickPhotoBtn:// 相冊选择图片
pickPhoto();
break;
case R.id.cancelBtn:// 取消
break;
default:
break;
}
}
});
menuWindow.showAtLocation(findViewById(R.id.choose_layout), Gravity.BOTTOM|Gravity.CENTER_HORIZONTAL, 0, 0);
}
拍照最重要的就是takephoto方法了。部分机型拍完照后没有数据返回,仅仅能通过指定拍完照获得图片的存储路径来解决问题了。凝视写的非常具体,这里不再多解释了。可是注意一点指定路径的时候可能会出现拍完照后无法点确定返回,有的手机甚至会点击后挂掉。这个时候会报不是有效路径的错误。我遇到错误是在获取到的与应用相关联的路径后面再创建一个文件/xxxx,至于为什么不行。我也不知道原理。
private void takePhoto() {
// 运行拍照前。应该先推断SD卡是否存在
String SDState = Environment.getExternalStorageState();
if (SDState.equals(Environment.MEDIA_MOUNTED)) {
/**
* 通过指定图片存储路径,解决部分机型onActivityResult回调 data返回为null的情况
*/
//获取与应用相关联的路径
String imageFilePath = getExternalFilesDir(Environment.DIRECTORY_PICTURES).getAbsolutePath();
SimpleDateFormat formatter = new SimpleDateFormat("yyyyMMddHHmmss", Locale.CHINA);
//依据当前时间生成图片的名称
String timestamp = "/"+formatter.format(new Date())+".jpg";
File imageFile = new File(imageFilePath,timestamp);// 通过路径创建保存文件
mImagePath = imageFile.getAbsolutePath();
Uri imageFileUri = Uri.fromFile(imageFile);// 获取文件的Uri
Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
intent.putExtra(MediaStore.EXTRA_OUTPUT,imageFileUri);// 告诉相机拍摄完成输出图片到指定的Uri
startActivityForResult(intent, SELECT_IMAGE_RESULT_CODE);
} else {
Toast.makeText(this, "内存卡不存在。", Toast.LENGTH_LONG).show();
}
}
通过GridView实现动态加入图片的效果
事实上你们更关心GridView动态添加item,item删除等效果:
申明组件和变量:
/**
* 须要上传的图片路径 控制默认图片在最后面须要用LinkedList
*/
private LinkedList<String> dataList = new LinkedList<String>();
/**
* 图片上传GridView
*/
private GridView uploadGridView;
/**
* 图片上传Adapter
*/
private UploadImageAdapter adapter;
初始化GridView和Adapter:
uploadGridView = (GridView) findViewById(R.id.grid_upload_pictures);
dataList.addLast(null);// 初始化第一个加入button数据
adapter = new UploadImageAdapter(this, dataList);
uploadGridView.setAdapter(adapter);
uploadGridView.setOnItemClickListener(mItemClick);
uploadGridView.setOnItemLongClickListener(mItemLongClick);
GridView的item点击监听和长按监听:
/**
* 上传图片GridView Item单击监听
*/
private OnItemClickListener mItemClick = new OnItemClickListener(){
@Override
public void onItemClick(AdapterView<?
> parent, View view, int position,
long id) {
if(parent.getItemAtPosition(position) == null){ // 加入图片
//showPictureDailog();//Dialog形式
showPicturePopupWindow();//PopupWindow形式
}
}
};
/**
* 上传图片GridView Item长按监听
*/
private OnItemLongClickListener mItemLongClick = new OnItemLongClickListener(){
@Override
public boolean onItemLongClick(AdapterView<?
> parent, View view,
int position, long id) {
if(parent.getItemAtPosition(position) != null){ // 长按删除
dataList.remove(parent.getItemAtPosition(position));
adapter.update(dataList); // 刷新图片
}
return true;
}
};
对于onActivityResult的回调例如以下:
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if(requestCode == SELECT_IMAGE_RESULT_CODE && resultCode == RESULT_OK){
String imagePath = "";
Uri uri = null;
if (data != null && data.getData() != null) {// 有数据返回直接使用返回的图片地址
uri = data.getData();
Cursor cursor = getContentResolver().query(uri, proj, null,
null, null);
if (cursor == null) {//出现如小米等手机返回的绝对路径错误时,自己拼出路径
uri = ImageUtils.getUri(this, data);
}
imagePath = ImageUtils.getFilePathByFileUri(this, uri);
} else {// 无数据使用指定的图片路径
imagePath = mImagePath;
}
dataList.addFirst(imagePath);
adapter.update(dataList); // 刷新图片
}
}
这里须要注意ImageUtils.getUri()方法了。相信非常多人遇到过小米等定制ROM系统的手机厂商了,把原生Android系统改的面目全非,所以调用系统自带的功能问题就多了,我两个手机。魅族的没事。可是小米的就出问题,图库选择图片返回的绝对的路径居然是错误的,没错,有返回路径。可是用Cursor 就查询却找不到该图片!所以,我们仅仅能自己拼写图片路径了。来看看ImageUtils.getUri()。
/**
* 解决小米等定制ROM手机返回的绝对路径错误的问题
* @param context
* @param intent
* @return uri 拼出来的URI
*/
public static Uri getUri(Context context , Intent intent) {
Uri uri = intent.getData();
String type = intent.getType();
if (uri.getScheme().equals("file") && (type.contains("image/"))) {
String path = uri.getEncodedPath();
if (path != null) {
path = Uri.decode(path);
ContentResolver cr = context.getContentResolver();
StringBuffer buff = new StringBuffer();
buff.append("(").append(Images.ImageColumns.DATA).append("=")
.append("'" + path + "'").append(")");
Cursor cur = cr.query(Images.Media.EXTERNAL_CONTENT_URI,
new String[] { Images.ImageColumns._ID },
buff.toString(), null, null);
int index = 0;
for (cur.moveToFirst(); !cur.isAfterLast(); cur.moveToNext()) {
index = cur.getColumnIndex(Images.ImageColumns._ID);
// set _id value
index = cur.getInt(index);
}
if (index == 0) {
// do nothing
} else {
Uri uri_temp = Uri
.parse("content://media/external/images/media/"
+ index);
if (uri_temp != null) {
uri = uri_temp;
Log.i("urishi", uri.toString());
}
}
}
}
return uri;
}
Adapter使用的小技巧
我们能够看到GirdView点击监听和长按监听都用到了
if(parent.getItemAtPosition(position) != null){
//相关逻辑
}
推断语句,为什么用parent.getItemAtPosition(position) 而不用dataList .get(position)呢?个人觉得使用适配器最好将数据源隔离出来。即除了在Adapter传入数据或者Adapter更新数据,其它情况不再使用数据源。避免数据不同步造成一些问题。我们再来看一下Adapter的代码:
/**
* 多图上传,动态加入图片适配器
*/
public class UploadImageAdapter extends BaseAdapter {
private LinkedList<String> imagePathList;
private Context context;
private boolean isAddData = true;
/**
* 控制最多上传的图片数量
*/
private int imageNumber = 6;
public UploadImageAdapter(Context context, LinkedList<String> imagePath) {
this.context = context;
this.imagePathList = imagePath;
}
public void update(LinkedList<String> imagePathList){
this.imagePathList = imagePathList;
//这里控制选择的图片放到前面,默认的图片放到最后面,
if(isAddData){
//集合中的总数量等于上传图片的数量加上默认的图片不能大于imageNumber + 1
if(imagePathList.size() == imageNumber + 1){
//移除默认的图片
imagePathList.removeLast();
isAddData = false;
}
}else{
//加入默认的图片
imagePathList.addLast(null);
isAddData = true;
}
notifyDataSetChanged();
}
@Override
public int getCount() {
return imagePathList == null ? 0 : imagePathList.size();
}
@Override
public Object getItem(int position) {
return imagePathList == null ? null : imagePathList.get(position);
}
@Override
public long getItemId(int position) {
return position;
}
@Override
public View getView(int position, View convertView, ViewGroup parent) {
ImageView iv_image;
if (convertView == null) {//创建ImageView
iv_image = new ImageView(context);
iv_image.setLayoutParams(new AbsListView.LayoutParams(ImageUtils.getWidth(context) / 3 - 5, ImageUtils.getWidth(context) / 3 - 5) );
iv_image.setScaleType(ImageButton.ScaleType.CENTER_CROP);
convertView = iv_image;
}else{
iv_image = (ImageView) convertView;
}
if(getItem(position) == null ){//图片地址为空时设置默认图片
iv_image.setImageResource(R.drawable.upload);
}else{
//获取图片缩略图,避免OOM
Bitmap bitmap = ImageUtils.getImageThumbnail((String)getItem(position), ImageUtils.getWidth(context) / 3 - 5, ImageUtils.getWidth(context) / 3 - 5);
iv_image.setImageBitmap(bitmap);
}
return convertView;
}
在这里我对getCount()、getItem()方法都做了非空的推断,个人觉得能避免空指针异常就要避免,当然这样做也是为了在getView中直接使用getItem(position)方法,而不是取用dataList.get(position)获取当前item的相应的数据,原因在GridView点击和长按事件中有提到过。逻辑比較简单。不做过多的介绍。
Fragment与Activity之间通过接口传递数据
我觉得最重要的就是Fragment与Activity之间怎么传递数据,在这里我採取了接口回调来实现数据传递。
首先在BaseActivity中定义一个接口:
/**
* 选择图片的返回码
*/
public final static int SELECT_IMAGE_RESULT_CODE = 200;
/**
* 当前选择的图片的路径
*/
public String mImagePath;
/**
* 自己定义的PopupWindow
*/
private SelectPicPopupWindow menuWindow;
/**
* Fragment回调接口
*/
public OnFragmentResult mOnFragmentResult;
public void setOnFragmentResult(OnFragmentResult onFragmentResult){
mOnFragmentResult = onFragmentResult;
}
/**
* 回调数据给Fragment的接口
*/
public interface OnFragmentResult{
void onResult(String mImagePath);
}
然后我们来看看是怎么使用的吧:
由于ChooseFragmentActivity继承自BaseActivity,所以直接mOnFragmentResult
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
String imagePath = "";
if(requestCode == SELECT_IMAGE_RESULT_CODE && resultCode== RESULT_OK){
if(data != null && data.getData() != null){
imagePath = ImageUtils.getFilePathByFileUri(this, data.getData());
}else{
imagePath = mImagePath;
}
mOnFragmentResult.onResult(imagePath);
}
}
Fragment中:
//设置监听 ((BaseActivity)getActivity()).setOnFragmentResult(mOnFragmentResult);
private OnFragmentResult mOnFragmentResult = new OnFragmentResult() {
@Override
public void onResult(String mImagePath) {
dataList.addFirst(mImagePath);
adapter.update(dataList); // 刷新图片
}
};
而在Fragment中对GridView点击、长按事件操作与Activity中大同小异,主要是Context的获取。
/**
* 上传图片GridView Item单击监听
*/
private OnItemClickListener mItemClick = new OnItemClickListener(){
@Override
public void onItemClick(AdapterView<?
> parent, View view, int position,
long id) {
if(parent.getItemAtPosition(position) == null){ // 加入图片
//((BaseActivity)getActivity()).showPictureDailog();//Dialog形式
((BaseActivity)getActivity()).showPicturePopupWindow();//PopupWindow形式
}
}
};
最关键的地方就是(BaseActivity)getActivity()这步操作,这样能在Fragment中拿到BaseActivity中的方法和属性。这样的操作在非常多情景使用会带来非常大的便利。
好了,本片文章就进入尾声了……
PS:对CSDN资源模块感到无力,使用github来保存代码了。
Think great thoughts and you will be great.