Android Camera

把预览类放到布局中

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

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

    android:orientation="horizontal"

    android:layout_width="fill_parent"

    android:layout_height="fill_parent"

    >

  

    android:id="@+id/camera_preview"

    android:layout_width="fill_parent"

    android:layout_height="fill_parent"

    android:layout_weight="1"

    />

 

  

    android:id="@+id/button_capture"

    android:text="Capture"

    android:layout_width="wrap_content"

    android:layout_height="wrap_content"

    android:layout_gravity="center"

    />

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

          android:label="@string/app_name"

 

          android:screenOrientation="landscape">

          

 

          

        

        

    

注意：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

    }

 

    private void releaseMediaRecorder(){

        if (mMediaRecorder != null) {

            mMediaRecorder.reset();   // clear recorder configuration

            mMediaRecorder.release(); // release the recorder object

            mMediaRecorder = null;

            mCamera.lock();           // lock camera for later use

        }

    }

 

    private void releaseCamera(){

        if (mCamera != null){

            mCamera.release();        // release the camera for other applications

            mCamera = null;

        }

    }

}