【Android】从相册或相机中获取一张图片
前言：关于权限请求
Android 从 6.0 开始增加权限检查，所以一些功能需要申请权限（用户允许后）才能使用。
DEMO 框架如下：（请确保请求的权限在 AndroidManifest.xml 有声明，否则直接出错）
// Check Permissions
private static final int PERMISSION_REQUEST_CODE = 1;
private static String[] PERMISSIONS = {
Manifest.permission.READ_EXTERNAL_STORAGE,
Manifest.permission.WRITE_EXTERNAL_STORAGE,
};
...
@Override
protected void onStart() {
super.onStart();
checkPermissions();
}
private void checkPermissions() {
boolean allPermissionGranted = true;
for (String permission : PERMISSIONS) {
int result = ActivityCompat.checkSelfPermission(this, permission);
if (result != PackageManager.PERMISSION_GRANTED) {
allPermissionGranted = false;
break;
}
}
if (allPermissionGranted) {
onPermissionGranted();
return;
}
ActivityCompat.requestPermissions(this, PERMISSIONS, PERMISSION_REQUEST_CODE);
}
public void onRequestPermissionsResult(int requestCode,
@NonNull String[] permissions,
@NonNull int[] grantResults) {
if (requestCode == PERMISSION_REQUEST_CODE) {
for (int result : grantResults) {
if (result != PackageManager.PERMISSION_GRANTED) {
Toast.makeText(this, "Fail to request permission", Toast.LENGTH_SHORT).show();
finish();
return;
}
}
// 权限请求允许后，你可以干一些初始化或者其它什么的...
} else {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
}
}
通过相册获取图片
1. 获取权限
需要通过相册获取图片，显然需要有“读”权限。
在 AndroidManifest.xml 中加入
<application>
...
</application>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
2. 发起通过相册获取图片的请求
final Intent photoPickerIntent = new Intent(Intent.ACTION_PICK); // 选择数据
photoPickerIntent.setType("image/*"); // 获取所有本地图片
startActivityForResult(photoPickerIntent, CONSTANTS_SELECT_PHOTO_CODE);
什么？只有 3 行？
没错，Android 对一些常用的服务进行了封装。
可以通过 Intent.ACTION_PICK（选择数据） 获取一些常用的服务的数据。
通过 setType 接口可以调用图库获取本地图片，调用本地联系人、调用音乐、调用视频等。
运行上面的部分，就会显示出图册APP。
可以通过图册APP进行图片的选择。
3. 处理回调
Intent 发出请求后，就弹出图册。
选择图片后就需要处理该请求了（获取图片）。
想要获取 Intent 的回调，需要重写 onActivityResult 方法。
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent imageReturnedIntent) {
super.onActivityResult(requestCode, resultCode, imageReturnedIntent);
Bitmap bitmap = null;
switch (requestCode) {
case CONSTANTS_SELECT_PHOTO_CODE:
if (resultCode == RESULT_OK) {
try {
final Uri imageUri = imageReturnedIntent.getData();
final InputStream imageStream = getContentResolver().openInputStream(imageUri);
bitmap = BitmapFactory.decodeStream(imageStream);
} catch (FileNotFoundException e) {
e.printStackTrace();
}
}
break;
default:
break;
}
...
}
由于 Intent 传输数据有限，像图片这种大数据量的不能直接传输。
因此 Intent 返回所选图片的 Uri，再通过该 Uri 获取图片。
通过相机获取图片
1. 获取权限
想要使用相机，首先得有相机权限。
另外，与相册获取图片不同。相册的图片是已经存在的，只需要有读取权限即可。
而相机获取图片，需要先拍照存储（写权限），才能访问。
AndroidManfest.xml 的权限请求为：
<application>
...
</application>
<uses-feature android:name="android.hardware.camera" android:required="true" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
2. 发起通过相机获取图片的请求
更准确的说法应该是“截取”图片。
private String mCurrentPhotoPath; // 相机截图前，生成的图片文件的路径
private void dispatchTakePictureIntent() {
Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE); // Intent 请求使用相机截图
if (takePictureIntent.resolveActivity(getPackageManager()) != null) {
File photoFile = null;
try {
photoFile = createImageFile(); // 需要创建一个图片文件，存储相机截取的图片数据。
} catch (IOException ex) {
ex.printStackTrace();
return;
}
if (photoFile != null) {
Uri uriImage; // 前面提到了，Intent 不能传输大数据，需要转为 Uri
if (Build.VERSION.SDK_INT < Build.VERSION_CODES.N) {
uriImage = Uri.fromFile(photoFile); // 7.0 以前的版本可以直接把文件转为 Uri ("file://Uri")
} else {
uriImage = FileProvider.getUriForFile(this, getPackageName() + ".provider", photoFile); // 7.0 之后为了安全问题，需要转为 ("content://Uri")
}
takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, uriImage); // Camera 截图后会存入 uriImage 对应的图片中
startActivityForResult(takePictureIntent, CONSTANTS_CAPTURE_PHOTO_CODE);
}
}
}
private File createImageFile() throws IOException {
String timeStamp = new SimpleDateFormat("yyyyMMdd_HHmmss").format(new Date());
String imageFileName = "JPEG_" + timeStamp + "_";
File storageDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES); // 获取本机图片文件夹路径
File image = File.createTempFile(/*prefix*/imageFileName, /*suffix*/".jpg", /*directory*/storageDir);
mCurrentPhotoPath = image.getAbsolutePath();
return image;
}
I. 先需要创建一个图片文件，用于保存相机截取的图片数据。
II. Intent 传输不能传递大数据，只能用 Uri 传递图片信息，需要把图片文件转为 Uri。
III. Android 7.0 后为了安全，不允许文件直接转为 "file://Uri" 的形式（这种形式可以让 APP 直接访问 file://Uri）。
由于 Android 7.0 以上的共享文件权限限制。
需要通过 FileProvider.getUriForFile() 采用 "content://Uri" 替代 "file://Uri" 进行私有访问。
因此 Android 7.0 以上还需要在 AndroidManifest.xml 中增加：
<application>
...
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="${applicationId}.provider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/provider_paths" />
</provider>
</application>
增加文件 res/xml/provider_paths.xml
<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
<external-path name="external_files" path="."/>
</paths>
这样，就可以通过
FileProvider.getUriForFile(this, getPackageName() + ".provider", photoFile);
获取到 Uri 为 "content://Uri" 类型
关于 res/xml/provider_paths.xml 文件的 "<paths>" 路径，对应的路径获取方法不一样。
| 子节点 | 对应的路径 | 例子 |
|---|---|---|
| files-path | Context.getFilesDir() | |
| cache-path | Context.getCacheDir() | |
| external-path | Environment.getExternalStorageDirectory() | /storage/emulated/0/ |
| external-files-path | Context.getExternalFilesDir(null) | |
| external-cache-path | Context.getExternalCacheDir() |
3. 处理回调
第 2 步调用相机前，就已经生成了一个图片文件保存在 mCurrentPhotoPath （createImageFile方法）中。
那么回调后直接可以通过 mCurrentPhotoPath 拿到图片。
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent imageReturnedIntent) {
super.onActivityResult(requestCode, resultCode, imageReturnedIntent);
Bitmap bitmap = null;
switch (requestCode) {
case CONSTANTS_CAPTURE_PHOTO_CODE:
if (resultCode == RESULT_OK) {
bitmap = BitmapFactory.decodeFile(mCurrentPhotoPath);
}
break;
default:
break;
}
}
可选择通过相册/相机获取图片
注意还要创建：res/xml/provider_paths.xml 文件。
权限申请如下（AndroidManifest.xml）：
<application>
...
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="${applicationId}.provider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/provider_paths" />
</provider>
</application>
<uses-feature android:name="android.hardware.camera" android:required="true" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
核心代码：
private static final int CONSTANTS_SELECT_PHOTO_CODE = 1;
private static final int CONSTANTS_CAPTURE_PHOTO_CODE = 2;
private Bitmap mBitmap; // 保存获取的图片
private String mCurrentPhotoPath; // 相机截图前，生成的图片文件的路径
private void loadPictureUseCamera(boolean useCamera) {
if (useCamera) {
dispatchTakePictureIntent();
} else {
final Intent photoPickerIntent = new Intent(Intent.ACTION_PICK); // 选择数据
photoPickerIntent.setType("image/*"); // 获取所有本地图片
startActivityForResult(photoPickerIntent, CONSTANTS_SELECT_PHOTO_CODE);
}
}
private void dispatchTakePictureIntent() {
Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE); // Intent 请求使用相机截图
if (takePictureIntent.resolveActivity(getPackageManager()) != null) {
File photoFile = null;
try {
photoFile = createImageFile(); // 需要创建一个图片文件，存储相机截取的图片数据。
} catch (IOException ex) {
ex.printStackTrace();
return;
}
if (photoFile != null) {
Uri uriImage; // 前面提到了，Intent 不能传输大数据，需要转为 Uri
if (Build.VERSION.SDK_INT < Build.VERSION_CODES.N) {
uriImage = Uri.fromFile(photoFile); // 7.0 以前的版本可以直接把文件转为 Uri ("file://Uri")
} else {
uriImage = FileProvider.getUriForFile(this, getPackageName() + ".provider", photoFile); // 7.0 之后为了安全问题，需要转为 ("content://Uri")
}
takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, uriImage); // Camera 截图后会存入 uriImage 对应的图片中
startActivityForResult(takePictureIntent, CONSTANTS_CAPTURE_PHOTO_CODE);
}
}
}
private File createImageFile() throws IOException {
String timeStamp = new SimpleDateFormat("yyyyMMdd_HHmmss").format(new Date());
String imageFileName = "JPEG_" + timeStamp + "_";
File storageDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES); // 获取本机图片文件夹路径
File image = File.createTempFile(/*prefix*/imageFileName, /*suffix*/".jpg", /*directory*/storageDir);
mCurrentPhotoPath = image.getAbsolutePath();
return image;
}
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent imageReturnedIntent) {
super.onActivityResult(requestCode, resultCode, imageReturnedIntent);
Bitmap bitmap = null;
switch (requestCode) {
case CONSTANTS_SELECT_PHOTO_CODE:
if (resultCode == RESULT_OK) {
try {
final Uri imageUri = imageReturnedIntent.getData();
final InputStream imageStream = getContentResolver().openInputStream(imageUri);
bitmap = BitmapFactory.decodeStream(imageStream);
} catch (FileNotFoundException e) {
e.printStackTrace();
}
}
break;
case CONSTANTS_CAPTURE_PHOTO_CODE:
if (resultCode == RESULT_OK) {
bitmap = BitmapFactory.decodeFile(mCurrentPhotoPath);
}
break;
default:
break;
}
if (bitmap != null) {
mImageView.setImageBitmap(bitmap);
mBitmap = bitmap;
}
}
调用 loadPictureUseCamera 接口即可通过 相册或相机 获取图片了。
图片在 mBitmap 中。
