Android Camera（三）_android camera setcapturebundle-优快云博客

把预览类放到布局中

Camera的预览类，如上文所示的示例，必须要跟用户界面控件一起放到一个Activity的布局中，以便拍照或录像。本段向你显示如果构建一个基本的用于预览的Activity布局。

下面的布局代码提供了一个很基本的View，它能够用于显示Camera的预览图像。在这个示例中，FrameLayout元素被用于Camera预览类的容器。使用这个布局类型可以让额外的图像信息或控件能够覆盖在实时的Camera预览图像之上。

<?xml version="1.0" encoding="utf-8"?>

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

android:orientation="horizontal"

android:layout_width="fill_parent"

android:layout_height="fill_parent"

<FrameLayout

android:id="@+id/camera_preview"

android:layout_width="fill_parent"

android:layout_height="fill_parent"

android:layout_weight="1"

<Button

android:id="@+id/button_capture"

android:text="Capture"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:layout_gravity="center"

</LinearLayout>

在大多数设备上，Camera预览的默认方向是横向。这个示例布局指定了一个水平（横向）布局，并且下面的代码把应用程序固定为横向。为了简化Camera预览中的展现，你应该通过在你的清单文件中添加以下设置，把应用程序的预览Activity的方向改变为横向的：

<activity android:name=".CameraActivity"

android:label="@string/app_name"

android:screenOrientation="landscape">

<intent-filter>

</intent-filter>

</activity>

注意：Camera的预览不一定就是横屏模式。从Android2.2（API Level8）开始，你能够使用setDisplayOrientation()方法来设置预览图像的旋转。为了重新定位用户手的预览方向，在你的预览类的surfaceChanged()方法中，首先要用Camera.stopPreview()方法停止预览，然后改变方向，再用Camera.startPreview()方法启动预览。

在Camera View的Activity中，把你的预览类添加到上例所示的FrameLayout元素中。你的Camera Activity还必须确保在它被挂起或关闭时，要释放Camera对象。以下示例显示如何把上文中创建的预览类添加到Camera的Activity中：

public class CameraActivity extends Activity {

private Camera mCamera;

private CameraPreview mPreview;

@Override

public void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.main);

// Create an instance of Camera

mCamera = getCameraInstance();

// Create our Preview view and set it as the content of our activity.

mPreview = new CameraPreview(this, mCamera);

FrameLayout preview = (FrameLayout) findViewById(R.id.camera_preview);

preview.addView(mPreview);

}

注意：上例中的getCameraInstance()方法引用了上文“访问Camera”中的示例方法。

采集图片

一旦你构建了一个预览类，并把它放到了一个View中，你就可以开始用你的应用程序来采集应用程序了。在你的应用程序代码中，必须建立用于响应用户拍照操作的用户界面控件的监听器。

要使用Camera.takePicture()方法来获取一张图片。这个方法需要3个参数来接收来自Camera的数据。为了接收JPEG格式的数据，你必须实现接收图片数据的Camera.PictureCallback接口，并把接收到数据写到一个文件中。下面的代码显示了一个Camera.PictureCallback接口的基本实现，它把从Camera接收到的数据保存到一个图片文件中：

private PictureCallback mPicture = new PictureCallback() {

@Override

public void onPictureTaken(byte[] data, Camera camera) {

File pictureFile = getOutputMediaFile(MEDIA_TYPE_IMAGE);

if (pictureFile == null){

Log.d(TAG, "Error creating media file, check storage permissions: " +

e.getMessage());

return;

}

try {

FileOutputStream fos = new FileOutputStream(pictureFile);

fos.write(data);

fos.close();

} catch (FileNotFoundException e) {

Log.d(TAG, "File not found: " + e.getMessage());

} catch (IOException e) {

Log.d(TAG, "Error accessing file: " + e.getMessage());

}

};

通过调用Camera.takePicture()方法来触发采集图片的操作。下面的示例代码显示了如何从一个按钮的View.OnClickListener中调用这个方法：

// Add a listener to the Capture button

Button captureButton = (Button) findViewById(id.button_capture);

captureButton.setOnClickListener(

new View.OnClickListener() {

@Override

public void onClick(View v) {

// get an image from the camera

mCamera.takePicture(null, null, mPicture);

}

);

注意：代码中的mPicture成员变量会在下面的示例代码中引用。

警告：记住，在应用程序使用完Camera对象后，一定要调用Camera.release()方法来释放Camera对象。

采集视频

使用Android框架采集视频需要认真的管理Camera对象，以及跟MediaRecorder类的协调。当使用Camera对象记录视频时，除了Camera.open()和Camera.release()方法的调用以外，还必须管理Camera.lock()和Camera.unlock()方法的调用，从而允许MediaRecorder对象访问Camera硬件。

注意：从Android4.0（API Level 14）开始，Camera.lock()和Camera.unlock()方法调用系统会为你自动管理。

跟拍照不一样，采集视频需要非常特殊的调用顺序，必须按照一个特定执行顺序来准备和采集视频，详细如下：

1. 打开Camera：使用Camera.open()方法来获得一个Camera对象的实例。

2. 连接预览：使用Camera.setPreviewDisplay()方法把SurfaceView跟Camera连接起来，准备一个实时的Camera图像预览界面。

3. 启动预览：调用Camera.starPreview()方法开始显示实时的Camera图像。

4. 启动视频录像：为了成功的记录视频，必须完成以下步骤。

a. 给Camera对象解锁：通过调用Camera.unlock()方法给由MediaRecorder对象使用的Camera对象解锁。

b. 配置MediaRecorder对象：在这一步中要调用以下MediaRecorder方法。更多信息，请看MediaRecorder参考文档。

1. setCamera()：使用应用程序当前的Camera实例，把它设置成用于视频采集；

2. setAudiioSource()：使用MediaRecorder.AudioSource.CAMCORDER，设置音频源；

3. setVideoSource()：使用MediaRecorder.VideoSource.CAMERA来设置视频源；

4. 设置视频的输出格式和编码。对于Android2.2以上的版本，要使用MediaRecorder.setProfile方法，并且要私用CamcorderProfile.get()方法来获得一个Profile的示例。对于Android2.2以前的版本，必须要设置视频输出的格式和编码参数：

I． setOutputFormat()：设置输出格式，指定默认设置，或者是MediaRecorder.OutputFormat.MPEG_4;

II． setAudioEncoder()：设置声音的编码类型，指定默认设置，或者是MediaRecorder.AudioEncoder.AMR_NB;

III．setVideoEncoder()：设置视频的编码类型，指定默认设置，或者是MediaRecorder.VideoEncoder.MPEG_4_SP;

5. setOutputFile()：设置输出文件，可以使用下文“保存媒体文件”中的示例代码中的getOutputMediaFile(MEDIA_TYPE_VIDEO).toString()方法来获取输出文件路径。

6. setPreviewDisplay()：给应用程序指定SurfaceView的预览布局。要使用与连接预览相同的对象。

警告：这步中必须要调用MediaRecorder的配置方法，否则你的应用程序将会发生错误，并且录像也会失败。

c. 准备MediaRecorder对象：通过调用MediaRecorder.prepare()方法，准备给MediaRecorder对象提供的配置设置。

d. 启动MediaRecorder对象：通过调用MediaRecorder.star()方法来记录视频。

5. 停止视频录像：在这步中要调用以下方法来成功完成视频记录：

a. 停止MediaRecorder对象：通过调用MediaRecorder.stop()方法来停止视频采集

b. 重置MediaRecorder对象：可选操作，通过调用MediaRecorder.reset()方法来删除记录器的配置设置。

c. 释放MediaRecorder对象：调用MediaRecorder.release()方法来释放MediaRecorder对象。

d. 锁定Camera对象：调用Camera.lock()方法来锁定Camera对象，以便MediaRecorder会话能够继续使用它。从Android4.0（API Level 14）开始，这个调用不再需要了，除非MediaRecorder.prepare()方法调用失败。

6. 停止预览：当Activity使用完Camera对象时，要使用Camera.stopPreview()方法来停止预览。

7. 释放Camera对象：调用Camera.release()方法来释放Camera对象，以便其他应用程序能够使用它。

注意：使用MediaRecorder对象，不首先创建Camera预览，并跳过这个过程开始的几步是可能的。但是，因为典型的在开始视频采集之前，要给用户看到图像预览，所以跳过的步骤It is possible to use MediaRecorder without creating a camera preview first and skip the first few steps of this process.在此就不讨论了。

提示：如果你的应用程序被用于典型的视频记录，那么在启动预览期间，把setRecordingHint(boolean)方法设置为true，这样有助于减少启动采集所需要的时间。

配置MediaRecorder对象

在使用MediaRecorder类来采集视频时，必须按照指定的顺利来执行配置处理，并且要调用MediaRecorder.prepare()方法来检查和实现配置。下面的示例代码演示了如何为采集视频配置和准备MediaRecorder类：

private boolean prepareVideoRecorder(){

mCamera = getCameraInstance();

mMediaRecorder = new MediaRecorder();

// Step 1: Unlock and set camera to MediaRecorder

mCamera.unlock();

mMediaRecorder.setCamera(mCamera);

// Step 2: Set sources

mMediaRecorder.setAudioSource(MediaRecorder.AudioSource.CAMCORDER);

mMediaRecorder.setVideoSource(MediaRecorder.VideoSource.CAMERA);

// Step 3: Set a CamcorderProfile (requires API Level 8 or higher)

mMediaRecorder.setProfile(CamcorderProfile.get(CamcorderProfile.QUALITY_HIGH));

// Step 4: Set output file

mMediaRecorder.setOutputFile(getOutputMediaFile(MEDIA_TYPE_VIDEO).toString());

// Step 5: Set the preview output

mMediaRecorder.setPreviewDisplay(mPreview.getHolder().getSurface());

// Step 6: Prepare configured MediaRecorder

try {

mMediaRecorder.prepare();

} catch (IllegalStateException e) {

Log.d(TAG, "IllegalStateException preparing MediaRecorder: " + e.getMessage());

releaseMediaRecorder();

return false;

} catch (IOException e) {

Log.d(TAG, "IOException preparing MediaRecorder: " + e.getMessage());

releaseMediaRecorder();

return false;

}

return true;

}

在Android2.2（API Level8）之前，必须要直接设置输出格式和编码格式参数，而不是使用CamcorderProfile类。下面的代码演示了这种方法：

// Step 3: Set output format and encoding (for versions prior to API Level 8)

mMediaRecorder.setOutputFormat(MediaRecorder.OutputFormat.MPEG_4);

mMediaRecorder.setAudioEncoder(MediaRecorder.AudioEncoder.DEFAULT);

mMediaRecorder.setVideoEncoder(MediaRecorder.VideoEncoder.DEFAULT);

以下是给MediaRecorder对象设置的默认的视频采集参数，但是你可以在你的应用程序中来调整这些设置：

1. setVideoEncodingBitRate()

2. setVideoSize()

3. setVideoFrameRate()

4. setAudioEncodingBitRate()

5. setAudioChannels()

6. setAudioSamplingRate()

启动和停止MediaRecorder对象

在使用MediaRecorder类来启动和停止视频采集时，必须按照以下顺序来执行：

1. 用Camera.unlock()方法来解锁Camera对象；

2. 向上面代码中显示的那样来配置MediaRecorder；

3. 使用MediaRecorder.start()方法来启动采集；

4. 记录视频；

5. 使用MediaRecorder.stop()方法来停止采集；

6. 使用MediaRecorder.release()方法来释放媒体记录器；

7. 使用Camera.lock()方法来锁定Camera对象。

以下示例代码演示了如何触发一个按钮正确的使用Camera和MediaRecorder类来启动和停止视频采集。

注意：当完成视频采集时，不要释放Camera，否则你的预览将会被停止。

private boolean isRecording = false;

// Add a listener to the Capture button

Button captureButton = (Button) findViewById(id.button_capture);

captureButton.setOnClickListener(

new View.OnClickListener() {

@Override

public void onClick(View v) {

if (isRecording) {

// stop recording and release camera

mMediaRecorder.stop(); // stop the recording

releaseMediaRecorder(); // release the MediaRecorder object

mCamera.lock(); // take camera access back from MediaRecorder

// inform the user that recording has stopped

setCaptureButtonText("Capture");

isRecording = false;

} else {

// initialize video camera

if (prepareVideoRecorder()) {

// Camera is available and unlocked, MediaRecorder is prepared,

// now you can start recording

mMediaRecorder.start();

// inform the user that recording has started

setCaptureButtonText("Stop");

isRecording = true;

} else {

// prepare didn't work, release the camera

releaseMediaRecorder();

// inform user

}

);

注意：在上面的例子中，prepareVideoRecorder()方法引用了“配置MediaRecorder”一节中的示例代码。这个方法要锁定Camera，然后配置和准备MediaRecorder示例。

释放Camera

Camera是一种由应用程序共享的设备资源。在获得一个Camera实例之后，你的应用程序才能够使用Camera，并且要特别小心，在应用程序停止使用它的时候，即使是是应用程序被挂起（Activity.onPause()）,一定要释放Camera对象。如果应用程序没有正确的释放Camera，所有后续的访问Camera的尝试，包括你自己的应用程序，都会因访问失败而导致应用程序被关闭。

像下面的示例代码那样，使用Camera.release()方法来释放Camera对象：

public class CameraActivity extends Activity {

private Camera mCamera;

private SurfaceView mPreview;

private MediaRecorder mMediaRecorder;

...

@Override

protected void onPause() {

super.onPause();

releaseMediaRecorder(); // if you are using MediaRecorder, release it first

releaseCamera(); // release the camera immediately on pause event

}