Android 相机使用教程(一)

Android 框架提供对设备上可用的相机和各种相机功能的支持,通过它我们可以在应用程序中拍摄图片和视频。本文将介绍一种快速,简单的拍摄图像和视频方法,并概述创建自定义相机的高级用法。

你还在为开发中频繁切换环境打包而烦恼吗?快来试试 Environment Switcher 吧!使用它可以在app运行时一键切换环境,而且还支持其他贴心小功能,有了它妈妈再也不用担心频繁环境切换了。https://github.com/CodeXiaoMai/EnvironmentSwitcher

注意:Camera类已被弃用,官方建议使用更新的 android.hardware.camera2,但是它适用于Android 5.0(API级别21)或更高版本,所以...... 你懂的。

前言

在拍摄照片和视频之前,首先我们应该考虑一些关于我们的应用程序应该如何使用相机的问题。

  • 相机的必要性 - 相机对我们的应用程序是否非常重要?我们的应用程序是否不允许安装在没有相机的设备上?如果是这样,我们应该在 manifest 中声明对相机的要求。

  • 快速拍照还是自定义相机 - 我们的应用程序将如何使用相机?我们是只想快速的拍摄图片或视频剪辑,还是提供新的方式使用相机?如果是想快速的拍摄图片或剪辑,我们应该考虑使用现有的相机应用程序(系统已经提供默认的相机应用)。而要开发定制的相机功能,我们应该创建自己的相机应用程序部分。

  • 存储 - 我们的应用程序生成的图像或视频是仅在我们的应用程序中可见,还是为了方便其他应用程序(如Gallery或其他媒体和社交应用程序)使用它们?如果我们的应用程序被卸载,是否希望图片和视频仍然可用?

相关基础内容

Android框架支持通过android.hardware.camera2 API或 Intent 启动摄像机 两种方式捕获图像和视频。以下是我们需要用到的类:

  • android.hardware.camera2
    这是用于控制设备摄像机的主要API。当我们创建相机应用程序时,可用于拍摄照片或视频。

  • Camera
    这个类是用于控制设备摄像头的旧版API(已经被废弃)。

  • SurfaceView
    这个类用于呈现实时相机预览。

  • MediaRecorder
    该类用于记录相机录制的视频。

  • Intent
    使用 MediaStore.ACTION_IMAGE_CAPTURE 可用于捕获图像,而使用 MediaStore.ACTION_VIDEO_CAPTURE 可用于拍摄视频。这两个 Intent 是为了方便我们直接调用其他相机应用进行拍照或录制视频,而不用直接使用Camera对象。

清单声明

在使用Camera API开始开发应用程序之前,我们首先应该正确的配置 manifest,以允许使用相机硬件和其他相关功能。

  • 相机权限 - 如果我们通过调用现有的相机应用程序来使用相机,则应用程序不需要请求此权限,反之如果是自定义相机则我们的应用程序必须要求使用设备摄像头的权限。

    <uses-permission android:name="android.permission.CAMERA" />
    
  • 相机功能 - 我们的应用程序还必须声明使用相机功能

    <uses-feature android:name="android.hardware.camera" />
    

将相机功能添加到 manifest 中会导致Google Play阻止我们的应用程序安装到没有相机或不支持我们所指定的相机功能的设备上。

如果我们的应用程序的核心功能为拍摄照片,或者如果设备没有相机则应用无法运行,我们可以通过上面的代码将其在应用商店(Google Play)上的可见性限制为具有相机的设备。而如果我们的应用程序有一部分功能需要相机,但并非必须需要相机才能运行(其他功能还是可以用的嘛),则应将 manifest 中的 android:required 设置为 false,否则会导致设备没有相机的用户无法安装此应用。

<manifest ... >
    <uses-feature android:name="android.hardware.camera" android:required="false" />
    ...
</manifest>
  • 存储权限 - 如果我们的应用程序需要将图像或视频保存到设备的外部存储(SD卡),则还必须在 manifest 中添加:

    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    
  • 录音权限** - 对于使用视频捕获录制音频,我们的应用程序必须请求音频捕获权限。

    <uses-permission android:name="android.permission.RECORD_AUDIO" />
    
  • 定位权限 - 如果我们的应用程序使用GPS位置信息标记图像,则必须请求ACCESS_FINE_LOCATION权限。需要注意的是,如果我们的应用运行在Android 5.0(API级别21)或更高版本,则还需要声明使用设备的GPS:

    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    ...
    <!-- 如果你需要保存照片的位置信息就乖乖的添加吧,除非你不支持 5.0 以上的设备 -->
    <uses-feature android:name="android.hardware.location.gps" />
    

使用现有相机应用拍摄照片

通过Intent来调用现有的相机应用程序,可以快速地实现在应用程序中拍摄照片或视频,这是最简单快速的方法。

通过现有的相机应用程序来实现拍照这个过程涉及 3 个步骤:创建 Intent、启动已有相机应用 以及返回到我们的 Activity 时处理图像数据。

1. 创建 Intent 并启动相机应用

这是一个通过 Intent 启动系统相机的例子:

static final int REQUEST_IMAGE_CAPTURE = 1;

private void dispatchTakePictureIntent() {
    Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
    if (takePictureIntent.resolveActivity(getPackageManager()) != null) {
        startActivityForResult(takePictureIntent, REQUEST_IMAGE_CAPTURE);
    }
}

请注意,startActivityForResult()方法受到调用resolveActivity()的条件的保护,resolveActivity()方法返回可处理该intent的第一个活动组件。执行此检查很重要,因为如果我们使用一个没有应用程序可以响应的 Intent 调用startActivityForResult(),程序将会崩溃。所以只要结果不为空,就可以安全的使用它。

2. 处理图像数据

当使用相机应用程序拍照成功后,系统会将照片进行编码放入返回的 Intent 中并传递给onActivityResult()。

2.1 获取缩略图

Intent 的 extras 中的 “data” 关键字 存储的就是缩略图。以下代码是从返回结果中取出此图像并将其显示在ImageView中。

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (requestCode == REQUEST_IMAGE_CAPTURE && resultCode == RESULT_OK) {
        Bundle extras = data.getExtras();
        Bitmap imageBitmap = (Bitmap) extras.get("data");
        mImageView.setImageBitmap(imgetBitmap);
    }
}

注意:来自“data”的缩略图可能对像素要求不高的图片很适合。处理全尺寸图像需要更多的工作。

2.2 保存全尺寸照片

显然仅仅用缩略图是不能满足我们的要求的,我们可以用一个文件来保存一张全尺寸照片。

通常,用户使用摄像头拍摄的照片应保存在公共外部存储设备上,以便所有应用都可以访问。调用 Environment.getExternalStoragePublicDirectory()并传递参数DIRECTORY_PICTURES 将返回共享照片的正确目录。由于此方法提供的目录在所有应用程序之间共享,所以读取和写入需要分别具有READ_EXTERNAL_STORAGE 和 WRITE_EXTERNAL_STORAGE权限。写入权限隐含地允许读取,所以如果你需要写入外部存储,那么你只需要请求一个权限:

<manifest ...>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    ...
</manifest>

但是,如果我们希望照片仅对我们自己的应用程序保持私有状态,则可以使用getExternalFilesDir()提供的目录。在Android 4.3及更低版本上,写入此目录也需要 WRITE_EXTERNAL_STORAGE 权限。从Android 4.4开始,不再需要权限,因为目录不能被其他应用程序访问,因此我们可以通过添加maxSdkVersion属性来声明仅在较低版本的Android上的权限:

<manifest ...>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
                     android:maxSdkVersion="18" />
    ...
</manifest>

注意:当用户卸载应用程序时,系统将删除由getExternalFilesDir()或 getFilesDir()提供的目录中保存的文件。

确定文件的目录后,我们需要创建一个防止冲突的文件名。我们可能还希望将路径保存在成员变量中以备以后使用。以下是使用日期时间戳作为新照片的唯一文件名的方法的示例解决方案:

String mCurrentPhotoPath;

private File createImageFile() throws IOException {
    // Create an image file name
    String timeStamp = new SimpleDateFormat("yyyyMMdd_HHmmss").format(new Date());
    String imageFileName = "JPEG_" + timeStamp + "_";
    File storageDir = getExternalFilesDir(Environment.DIRECTORY_PICTURES);
    File image = File.createTempFile(
            imageFileName, /* prefix */
            ".jpg",        /* suffix */
            storageDir     /* directory */
    );

    // Save a file: 用于ACTION_VIEW意图的路径
    mCurrentPhotoPath = image.getAbsolutePath();
    return image;
}

使用这种方法可以为照片保存为一个文件,现在可以像这样创建和调用Intent:

public static final int REQUEST_TAKE_PHOTO = 1;

private void dispatchTakePictureIntent() {
    Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
    // Ensure that there's a camera activity to handle the intent
    if (takePictureIntent.resolveActivity(getPackageManager()) != null) {
        File photoFile = null;
        try {
            // Create the File where the photo should go
            photoFile = createImageFile();
        } catch (IOException e) {
            e.printStackTrace();
        }
        // Continue only if the File was successfully created
        if (photoFile != null) {
            Uri photoURI = FileProvider.getUriForFile(this,
                    "com.xiaomai.myproject.fileprovider",
                    photoFile
            );
            takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, photoURI);
            startActivityForResult(takePictureIntent, REQUEST_TAKE_PHOTO);
        }
    }
}

注意:我们使用getUriForFile(Context,String,File)返回一个content:// URI。对于Android 7.0和更高(API等级大于等于24)的应用,通过一个包边界传递一个file:// URI会导致FileUriExposedException。因此,我们现在介绍一种使用FileProvider存储图像的更通用的方法。

现在,我们需要配置FileProvider。在应用的清单中,为我们的应用添加一个提供者:

<application>
   ...
   <provider
        android:name="android.support.v4.content.FileProvider"
        android:authorities="com.xiaomai.myproject.fileprovider"
        android:exported="false"
        android:grantUriPermissions="true">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/file_paths"></meta-data>
    </provider>
    ...
</application>

确保android:authorities的字符串内容匹配 getUriForFile(Context,String,File)的第二个参数。在提供程序定义的元数据部分,我们可以看到提供程序期望在专用资源文件res/xml/file_paths.xml中配置符合条件的路径。以下是此特定示例所需的内容:

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-path name="my_images" path="Android/data/com.example.package.name/files/Pictures" />
</paths>

路径组件对应于调用getExternalFilesDir() 并使用Environment.DIRECTORY_PICTURES时返回的路径。确保你已经将com.example.package.name替换为应用程序的实际包名称。另外,可以查看FileProvider的文档,以便使用除了外部路径之外的路径说明符。

将照片添加到图库

当通过 Intent 启动拍摄照片时,我们知道图像所在的位置,因为我们指定了将其保存在哪里。对于其他人来说,也许最简单的方法是使我们的照片可以访问,使其可以从系统的媒体访问。

注意:如果我们将照片保存到由getExternalFilesDir()提供的目录中,则媒体扫描程序无法访问这些文件,因为它们对我们的应用程序是私有的。

以下示例方法演示了如何调用系统的媒体扫描程序将我们的照片添加到媒体提供商的数据库,使其可以在Android图库应用程序和其他应用程序中使用。

private void galleryAddPic() {
    Intent mediaScanIntent = new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE);
    File file = new File(mCurrentPhotoPath);
    Uri contentUri = Uri.fromFile(file);
    mediaScanIntent.setData(contentUri);
    sendBroadcast(mediaScanIntent);
}

解码缩放图片

使用有限的内存来管理多个全尺寸图像可能很棘手。如果在仅仅显示几个图像后就发现应用程序内存不足,则可以通过将JPEG缩放到匹配目标视图大小并存入内存中,来大大减少动态堆的使用数量。以下示例方法演示了此技术。

private void setPic() {
    // 获取ImageView的尺寸
    int targetWidth = mImageView.getWidth();
    int targetHeight = mImageView.getHeight();

    // 获取图片的真实尺寸
    BitmapFactory.Options bmOptions = new BitmapFactory.Options();
    bmOptions.inJustDecodeBounds = true;
    BitmapFactory.decodeFile(mCurrentPhotoPath, bmOptions);
    int photoWidth = bmOptions.outWidth;
    int photoHeight = bmOptions.outHeight;

    // 确定图像的缩放比例
    int scaleFactor = Math.min(photoWidth / targetWidth, photoHeight / targetHeight);

    // 将图像文件解码为位图大小以填充视图
    bmOptions.inJustDecodeBounds = false;
    bmOptions.inSampleSize = scaleFactor;
    bmOptions.inPurgeable = true;

    Bitmap bitmap = BitmapFactory.decodeFile(mCurrentPhotoPath, bmOptions);
    mImageView.setImageBitmap(bitmap);
}
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,458评论 4 363
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,454评论 1 294
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,171评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,062评论 0 207
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,440评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,661评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,906评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,609评论 0 200
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,379评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,600评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,085评论 1 261
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,409评论 2 254
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,072评论 3 237
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,088评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,860评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,704评论 2 276
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,608评论 2 270

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 170,569评论 25 707
  • 上一篇介绍了如何使用系统相机简单、快速的进行拍照,本篇将介绍如何使用框架提供的API直接控制摄像机硬件。 你还在为...
    Xiao_Mai阅读 7,013评论 4 18
  • ¥开启¥ 【iAPP实现进入界面执行逐一显】 〖2017-08-25 15:22:14〗 《//首先开一个线程,因...
    小菜c阅读 6,209评论 0 17
  • (1)闹钟 创建闹钟(ACTION_SET_ALARM)示例Intent: 注:为了调用ACTION_SET_AL...
    sunnygarden阅读 1,521评论 0 10
  • 九天之上,宇宙边缘,银树火花,一张石桌,两杯浊酒,笑对星河,把酒言欢。 菩提:昔日之事,多亏太上照拂。 老君:何须...
    傅人阅读 695评论 5 18