Camera
版本:Android 4.0r1
在本文中
关键类
参阅
Android框架包含了对多种摄像头和摄像特性的支持,应用程序可以进行图片和视频的捕获。本文讨论了一种快速、简便的捕获图像和视频的方法,并简述了一种更高级的可为用户创建自定义摄像功能的方法。
在让应用程序使用Android设备的摄像头之前,应该考虑一些期望如何使用此硬件的问题。
- 摄像头需求——摄像头的使用对于应用程序是否确实如此重要,以至于在没有摄像头的设备上就不期望安装此应用了?如果确实如此,应该在manifest中声明摄像头需求。
- 快速拍照还是自定义摄像——应用程序如何使用摄像头?仅仅是对快速拍照和视频片段感兴趣,还是要提供一种使用摄像头的新方式?对于快速拍照和摄像而言,可以考虑使用内置的摄像头应用 。为了开发一种定制的摄像头功能,请查看创建摄像头应用 一节。
- 存储——应用程序产生的图像和视频是否期望仅对自身可见,还是可以共享——以便相册或其它媒体应用也能够使用?当应用程序被卸载后,还期望图像和视频可用么?请查看保存媒体文件 一节来了解如何实现这些选项。
- 此类是控制摄像头的主要API。在创建摄像头应用程序时,此类用于拍摄照片或视频。
- 此类用于向用户提供摄像头实时预览功能。
- 此类用于从摄像头录制视频。
-
动作类型为
MediaStore.ACTION_IMAGE_CAPTURE
或MediaStore.ACTION_VIDEO_CAPTURE
的意图, 可在不直接使用Camera
对象的情况下捕获图像和视频。
Camera
SurfaceView
MediaRecorder
Intent
开始开发摄像头API的应用之前,应该确保已经在manifest中正确声明了对摄像头的使用及其它相关的feature。
- Camera权限——应用程序必须对请求摄像头的使用权限。
<uses-permission android:name = "android.permission.CAMERA" />
注意:如果是 通过意图 来使用摄像头的,应用程序就不必请求本权限。
- Camera Feature——应用程序必须同时声明对camerafeature的使用,例如:
<uses-feature android:name = "android.hardware.camera" />
关于摄像头feature的清单,参阅manifest Feature参考。
在manifest中加入camerafeature,将会使得AndroidMarket在没有摄像头或不支持指定feature的设备上禁止安装该应用程序。关于AndroidMarket基于feature过滤的使用详情,请参阅Android Market和基于Feature的过滤。
如果应用程序可能用到摄像头或摄像头feature,但却不是必需的,则应在manifest中指定包含android:required属性的feature,并将该属性设为false:
<uses-feature android:name = "android.hardware.camera" android:required = "false" /> -
存储权限——如果应用程序要把图像或视频保存到设备的外部存储上(SD卡),则还必须在>manifest中指定如下权限。
<uses-permission android:name = "android.permission.WRITE_EXTERNAL_STORAGE" /> -
录音权限——要用音频捕获来录音,应用程序必须请求音频捕获权限。
<uses-permission android:name = "android.permission.RECORD_AUDIO" />
有一种快捷的方法可以让应用程序不用额外编写很多代码就能实现拍照或摄像,这就是用意图 Intent来调用内置的Android摄像头应用程序。摄像头intent会请求通过内置摄像应用来捕获图像或视频,并把控制权返回给应用程序。本节展示了如何用这种方法来捕获图像。
通常按以下步骤来提交一个摄像头intent:
- 构建一个摄像头Intent——用以下意图类型之一,创建一个请求图像或视频的Intent:
- MediaStore.ACTION_IMAGE_CAPTURE ——向内置摄像头程序请求图像拍摄的intentaction类型。
- MediaStore.ACTION_VIDEO_CAPTURE ——向内置摄像头程序请求视频录制的intentaction类型。
- 启动摄像头Intent——用 startActivityForResult()方法执行摄像头intent。启动完毕后摄像头应用的用户界面就会显示在屏幕上,用户就可以拍照或摄像了。
- 接收Intent结果——在应用程序中设置 onActivityResult()方法,用于接收从摄像头intent返回的数据。当用户拍摄完毕后(或者取消操作),系统会调用此方法。
如果希望程序以最少的代码实现拍照功能,利用摄像头intent捕获图像是一条捷径。图像捕捉intent还可以包含以下附加信息:
-
MediaStore.EXTRA_OUTPUT——本设置需要一个Uri对象,用于指定存放图片的路径和文件名。本设置是可选项,但强烈建议使用。如果未指定本设置值,那么摄像应用将会把所请求的图片以默认文件名和路径进行保存,并将数据置入intent的Intent.getData()部分返回。
以下例子演示了如何构建并执行一个图像捕获intent。此例中的getOutputMediaFileUri() 方法引自保存媒体文件中的例程代码。
private static final intCAPTURE_IMAGE_ACTIVITY_REQUEST_CODE=100;
private Uri fileUri;
@Override
public void onCreate(Bundle
}
startActivityForResult()方法执行完毕后,用户将看到内置摄像头应用程序的界面。用户拍照完毕(或取消操作)后,用户界面返回应用程序,这时必须截获onActivityResult() 方法来接收intent的返回结果并执行后续操作。关于如何接收完整的intent,请参阅接收摄像头Intent的结果。
如果希望程序以最少的代码实现摄像功能,利用摄像头intent捕获视频是一条捷径。视频捕捉intent可以包含以下附带信息:
- MediaStore.EXTRA_OUTPUT——本设置需要一个Uri,用于指定保存视频的路径和文件名。本设置是可选项,但强烈建议使用。如果未指定本设置值,那么摄像应用将会把所请求的视频以默认文件名和路径进行保存,并将数据置入intent的Intent.getData() 部分返回。
- MediaStore.EXTRA_VIDEO_QUALITY——本值用0表示最低品质及最小的文件尺寸,用1表示最高品质和较大的文件尺寸。
- MediaStore.EXTRA_DURATION_LIMIT——本值用于限制所捕获视频的长度,以秒为单位。
- MediaStore.EXTRA_SIZE_LIMIT——本值用于限制所捕获视频的文件尺寸,以字节为单位。
以下例子演示了如何构建并执行一个视频捕获intent。本例中的getOutputMediaFileUri()方法引自保存媒体文件中的例程代码。
private static final intCAPTURE_VIDEO_ACTIVITY_REQUEST_CODE =200;
private Uri fileUri;
@Override
public voidonCreate(BundlesavedInstanceState){
}
startActivityForResult()方法执行完毕后,用户将看到一个改动过的摄像程序界面。用户摄像完毕(或取消操作)后,用户界面返回应用程序,这时必须截获onActivityResult()方法来接收intent的返回结果并执行后续操作。关于如何接收完整的intent,请参阅下一节。
一旦已构建并运行了图像或视频的摄像头intent,应用程序就必须进行设置,以接收intent返回的结果。本节展示了如何截获摄像头intent的回调方法,以便应用程序对捕获到的图片及视频进行进一步的处理。
要接收intent的返回结果,必须覆盖启动intent的activity中的 onActivityResult()方法。以下例子演示了如何覆盖onActivityResult()来获取上述章节例程中的 图像捕获intent或 视频捕获intent的结果。
private static final intCAPTURE_IMAGE_ACTIVITY_REQUEST_CODE =100;
private static final intCAPTURE_VIDEO_ACTIVITY_REQUEST_CODE =200;
@Override protected voidonActivityResult(intrequestCode,intresultCode,Intentdata){
}
一旦activity接收到成功的结果,就说明捕获到的图像或视频已保存到指定位置了,应用程序就可对其进行访问。
有些开发人员可能需要自定义外观的摄像头用户界面,或者需要提供特殊的功能。相比 使用intent而言,创建定制的摄像activity需要编写更多的代码,不过也能向用户提供更吸引人的使用感受。
通常按照以下步骤创建一个定制的摄像界面:
- 检测并访问摄像头——创建代码以检查摄像头存在与否并请求访问。
- 创建预览类——创建继承自 SurfaceView 并实现 SurfaceHolder 接口的摄像预览类。此类能预览摄像的实时图像。
- 建立预览Preview Layout——一旦有了摄像预览类,即可创建一个viewlayout,用于把预览画面与设计好的用户界面控件融合在一起。
- 为捕获设置侦听器Listener——将用户界面控件连接到listener,使其能响应用户操作开始捕获图像或视频,比如按下按钮。
- 捕获并保存文件——建立捕获图片或视频并保存到输出文件的代码。
- 释放摄像头——摄像头使用完毕后,应用程序必须正确地将其释放,便于其它程序的使用。
摄像头硬件是一个共享资源,必须对其进行精心管理,因此需要使用它的应用程序之间不能发生冲突。下一节将会讨论如何检测摄像头硬件、如何请求访问摄像头、使用完毕如何释放。
如果应用程序未利用manifest声明对摄像头需求进行特别指明,则应该在运行时检查一下摄像头是否可用。可用PackageManager.hasSystemFeature() 方法来进行这种检查,代码示例如下:
private
}
Android设备可能拥有多个摄像头,比如后置摄像头用于拍照、前置摄像头用于摄像。Android 2.3 (API Level9)以上版本允许利用 Camera.getNumberOfCameras()方法来检查设备可用摄像头的数量。
如果在运行程序的设备上已经检测到了摄像头,则必须通过获取一个 Camera的实例来请求对其访问(除非使用了 用于访问摄像头的intent)。
可用Camera.open()方法来访问主摄像头,并确保捕获全部的异常,示例代码如下:
public
Camera
}
在运行Android
一旦获得了摄像头的访问权,就可以通过 Camera.getParameters()方法来获取更多信息,检查返回的Camera.Parameters对象可查看摄像头所支持的feature。如果正在使用API
为了方便拍照或摄像,用户必须能看到摄像头所拍摄的画面。摄像头预览类就是一种能够显示摄像头实时数据的SurfaceView,用户可以调整并捕获图片和视频。
以下示例代码演示了如何创建一个基本的摄像头预览类,它可被嵌入一个 View布局中。为了截获view创建和销毁时的回调事件,此类实现了SurfaceHolder.Callback,这在指定摄像头预览的输入时需要用到。
public
}
将预览画面置入layout
上节例程所述的摄像预览类必须被放入一个activity的layout中,连同其它用户界面控件一起,实现拍照或摄像功能。本节展示了如何为预览创建一个简单的layout和activity。
以下layout代码提供了一个非常简单的view,用于显示一个摄像预览画面。在此例中,FrameLayout元素用于容纳摄像预览类。利用此类layout,可以把附加的图片信息或控件叠加到实时预览画面上。
<?xmlversion="1.0"encoding="utf-8"?>
<LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"
</LinearLayout>
在大多数设备上,缺省的摄像预览方向是横向的。此例中的layout指定了横向(landscape)布局,下面的代码还把应用程序的方向也改为了横向。为了简化摄像预览画面的刷新,应该在manifest中增加如下内容,把应用程序的预览activity也改为横向显示。
<activityandroid:name=".CameraActivity"
</activity>
注意:摄像预览画面并不是一定要横向显示。自Android2.2 (API Level 8)开始,可以利用setDisplayOrientation()方法来旋转预览画面。为了让预览方向跟随手机方向的变化而改变,可以在预览类的surfaceChanged()方法中实现,先用Camera.stopPreview()停止预览,改变方向后再用Camera.startPreview()开启预览。
在摄像view的activity中,请把预览类添加到上述的FrameLayout元素中。当摄像头暂停使用或者关闭时,摄像activity还必须确保将其释放。以下例子展示了如何修改摄像activity,加入创建预览类所述的预览类。
publicclassCameraActivityextendsActivity{
}
注意:上例中的getCameraInstance()方法引用了访问摄像头中的方法示例。
一旦创建了预览类和显示它的viewlayout,就可以开始在程序中捕获图片了。必须在程序代码中为用户界面控件设置listener,使其可响应用户操作进行拍照。
可以通过Camera.takePicture()方法来获取图片,此方法用到三个参数并从摄像头接收数据。如果要以JPEG的格式接收数据,必须实现Camera.PictureCallback接口,以接收图片数据并写入文件。以下代码展示了Camera.PictureCallback接口的简单例子,实现了从摄像头接收图片并保存。
privatePictureCallbackmPicture=newPictureCallback(){
};
通过调用Camera.takePicture()方法,触发器捕获了一张图片。以下例程展示了如何在按钮View.OnClickListener的中调用此方法。
// 在Capture按钮中加入listener
ButtoncaptureButton =(Button)findViewById(id.button_capture);
);
注意:下文例程中的mPicture成员将会引用上述代码。
警告:当应用程序使用完摄像头之后,请记得调用Camera.release()释放Camera对象!关于如何释放摄像头的详情,请参阅释放摄像头。
Android框架的视频捕捉需要对Camera对象进行仔细的管理,还要与MediaRecorder类一起协同工作。使用Camera录制视频时,必须管理好Camera.lock()与Camera.unlock()的调用,使得MediaRecorder能够顺利访问摄像头硬件,并且还要进行Camera.open()和Camera.release()调用。
注意:自Android 4.0 (API level14)开始,Camera.lock()和Camera.unlock()调用由系统自动管理。
与用摄像头拍照不同,视频捕获必需十分精确地按顺序进行调用。必须按照特定的顺序来执行,应用程序才能成功地准备并捕获视频,详细步骤如下。
- 打开摄像头——用 Camera.open() 来获得一个camera对象的实例。
- 连接预览——用 Camera.setPreviewDisplay() 将camera连接到一个 SurfaceView ,准备实时预览。
- 开始预览——调用 开始显示实时摄像画面。
- 开始录制视频 严格按照以下顺序执行才能成功录制视频:
- 解锁——调用 Camera.unlock() 解锁,便于 MediaRecorder 使用摄像头。
- 配置——按照如下顺序调用 MediaRecorder 中的方法。详情请参阅 MediaRecorder 参考文档。
- setCamera()——用当前Camera 实例将摄像头用途设置为视频捕捉。
- setAudioSource()——用MediaRecorder.AudioSource.CAMCORDER设置音频源。
- setVideoSource()——用MediaRecorder.VideoSource.CAMERA设置视频源。
- 设置视频输出格式和编码格式。对于Android 2.2 (API Level 8) 以上版本,使用MediaRecorder.setProfile来获取一个profile实例。对于Android prior to2.2以上版本,必须设置视频输出格式和编码参数:
- setOutputFormat()——设置输出格式,指定缺省设置或MediaRecorder.OutputFormat.MPEG_4。
- setAudioEncoder()——设置声音编码类型。指定缺省设置或MediaRecorder.AudioEncoder.AMR_NB。
- setVideoEncoder()—— 设置视频编码类型,指定缺省设置或者MediaRecorder.VideoEncoder.MPEG_4_SP。
- setOutputFile()——用getOutputMediaFile(MEDIA_TYPE_VIDEO).toString()设置输出文件,见保存媒体文件一节中的方法示例。
- setPreviewDisplay()——用上面连接预览中设置的对象来指定应用程序的SurfaceView预览layout元素。
-
警告:必须 按照如下顺序调用 MediaRecorder 的下列配置方法。否则应用程序将会引发错误,录像也将失败。
- 准备MediaRecorder——调用 MediaRecorder.prepare()设置配置,准备好 MediaRecorder。
- 启动MediaRecorder——调用 MediaRecorder.start()开始录制视频。
- 停止录制视频——按照顺序调用以下方法,才能成功完成视频录制:
- 停止MediaRecorder ——调用 MediaRecorder.stop()停止录制视频。
- 重置MediaRecorder——这是可选步骤,调用 MediaRecorder.reset()删除recorder中的配置信息。
- 释放MediaRecorder——调用 MediaRecorder.release()释放 MediaRecorder。
- 锁定摄像头—— 用 Camera.lock()锁定摄像头,使得以后 MediaRecordersession能够再次使用它。自Android 4.0 (API level14)开始,不再需要本调用了,除非 MediaRecorder.prepare()调用失败。
- 停止预览——activity使用完摄像头后,应该用 Camera.stopPreview()停止预览。
- 释放摄像头—— 使用 Camera.release()释放摄像头,使其它应用程序可以使用它。
注意:也可以不必先创建摄像头预览就使用 MediaRecorder,并跳过本节开始的几步。不过,因为用户一般都希望在开始录像前看到预览画面,这里就不讨论那类过程了。
配置MediaRecorder
在使用MediaRecorder类进行录像时,必须先按照特定顺序进行配置,然后调用MediaRecorder.prepare()方法检查并执行这些配置。以下例程演示了如何为录像正确配置并准备MediaRecorder类。
privatebooleanprepareVideoRecorder(){
}
如果是Android 2.2 (API Level 8)之前的版本,则必须直接指定输出格式和编码格式,而不是使用CamcorderProfile。以下代码演示了这种方式:
MediaRecorder中以下有关视频录制的参数都给出了缺省值,当然也可以在应用程序中修改这些设置:
- setVideoEncodingBitRate()
- setVideoSize()
- setVideoFrameRate()
- setAudioEncodingBitRate()
- setAudioChannels()
- setAudioSamplingRate()
开始和停止MediaRecorder
使用MediaRecorder类开始和停止视频录制时,必须遵循以下特定顺序。
- 用 Camera.unlock()解锁摄像头
- 如上代码所示配置 MediaRecorder
- 用 MediaRecorder.start()开始录制
- 记录视频
- 用 MediaRecorder.stop()停止录制
- 用 MediaRecorder.release()释放media recorder
- 用Camera.lock()锁定摄像头
以下例程演示了如何触发按钮并用camera和MediaRecorder类正确地开始和停止视频录制。
注意:视频录制完毕后请不要释放camera,否则预览将会停止。
privatebooleanisRecording=false;
// 为Capture按钮加入listener
ButtoncaptureButton =(Button)findViewById(id.button_capture);
captureButton.setOnClickListener(
);
注意:在上例中,prepareVideoRecorder()方法引用了配置MediaRecorder.中的示例代码。此方法实现了锁定camera、配置和准备MediaRecorder实例。
摄像头是设备上所有应用程序共享使用的资源。应用程序可以在获得Camera实例后使用摄像头,停止使用后请务必注意释放摄像头对象,应用程序暂停时(Activity.onPause())也是如此。如果某应用程序未能正确地释放摄像头,则所有后续访问摄像头的尝试(包括该应用程序自身)都将会失败,并可能导致应用程序被强行关闭。
用Camera.release()方法可以释放Camera对象的实例,代码示例如下。
publicclassCameraActivityextendsActivity{
@Override
}
警告:如果某应用程序未能正确释放摄像头,所有后续访问摄像头的尝试(包括该应用程序自身)都将会失败,并可能会导致应用程序被强行关闭。
诸如图片和视频这些由用户创建的媒体文件,应该保存到设备外部存储的目录中(SD卡)去,以节省系统空间,并使用户离开设备时也能访问这些文件。设备上有很多可用于存储媒体文件的目录,但作为开发人员只应考虑两个标准的位置:
·
·
以下例程演示了如何为媒体文件创建一个File或Uri存放位置,通过Intent调用摄像头时可以使用该文件,创建摄像应用时也可以使用它。
publicstaticfinalintMEDIA_TYPE_IMAGE=1;
publicstaticfinalintMEDIA_TYPE_VIDEO=2;
privatestaticUrigetOutputMediaFileUri(inttype){
}
privatestaticUrigetOutputMediaFile(inttype){
// 如果期望图片在应用程序卸载后还存在、且能被其它应用程序共享,
// 则此保存位置最合适
}
注意:Environment.getExternalStoragePublic