android——创建camera应用(译)

　  只是选择相机部分来翻译。下面是主要内容

　　有些开发者可能需要Camera的接口，来定制自己程序的外观和特殊功能。创建自定义的Camera界面比使用using an Intent需要编写更多的代码,但是它能提供更好的体验给用户。

创建自定义camera界面的一般步骤，可以参考一下步骤：

1. 检测和连接相机—检测camera是否存在和请求连接
2. 创建预览类—创建Preview，它继承SurfaceView和实现了SurfaceHolder接口。这个类可以预览相机中动态的画面。
3. 构造预览的布局一旦你拥有了Preview类，就需要创建一个View布局。布局中放入Preview和你想要的其他UI。
4. 给拍照设置监听器—连接监听器去启动拍照，来响应用户的动作，例如按下按钮。
5. 拍照和保存文件—编写代码实现拍照和保存输出。
6. 释放相机—使用camera后，程序必须合理的释放它，给其他程序使用。

　　相机硬件上一个共享的资源，必须被安全的管理，所以当使用相机时，你的程序不能和其他程序冲突。下面部分讲述怎样检测相机硬件，怎样连接相机，怎样拍照和当不使用时怎样释放相机。

　　注意：当应用程序不使用相机时，记得通过调用Camera.release()来释放Camera对象。如果没有合理释放camera,后面全部对camera的连接都会失败，将导致你的或其他程序被关闭。

检测相机硬件

　　 如果你的程序没有在manifest声明需要相机，你应该在代码运行时检测相机是否可用。使用PackageManage.hasSystemFeature()方法来执行检测，下面是例子：

 /** Check if this device has a camera */
 private boolean checkCameraHardware(Context context) {
     if (context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_CAMERA)){
         // this device has a camera
         return true;
     } else {
         // no camera on this device
         return false;
     }
 }

　　android设备可以用多个相机，例如后置相机用来拍照，前置相机用来摄像。Aandroid 2.3(API Level 9)和以后版本，你可以使用Camera.getNumberOfCameras()方法来检测相机的数目。

连接相机

　　如果你已经确定程序运行的设备上有相机，你必须请求连接来获取一个Camera实例(除非你使用intent来连接相机)。

　　使用Camera.opern()连接主要的相机，要确保捕获异常，就像下面的代码：

 /** A safe way to get an instance of the Camera object. */
 public static Camera getCameraInstance(){
     Camera c = null;
     try {
         c = Camera.open(); // attempt to get a Camera instance
     }
     catch (Exception e){
         // Camera is not available (in use or does not exist)
     }
     return c; // returns null if camera is unavailable
 }

　　注意：当使用Camera.open()时，总是要检查异常。如果不检查，当相机正在被使用或者不存在时，你的程序将会被系统关闭。

　　运行Android 2.3(API Level 9)或以上版本的设备，你可以使用Camera.open(int)连接特定的相机。上面的代码将会连接设备的第一个后置相机，如果存在多个相机。

检查相机特征

　　一旦你获取到相机的连接，你可以使用Camera.getParameters()方法获取有关它的功能的更多信息，检查返回的Camera.Parameters对象来知道相机支持的功能。

　　当使用API Level 9或以上的版本，使用Camera.getCameraInfo()确定相机是前置还是后置，图片的方向。

创建预览类

　　为了用户能有效地拍照，他们必须能够看到设备相机看到的。一个相机预览类是一个SurfaceView，它能展示来自相机的动态的图像数据，所以用户可以能拍摄到照片。

　　下面的例子展示了如何创建一个基本的相机预览类，它被包含在一个View布局中。这个类实现了SurfaceHolder.Callback接口，为了能捕捉到创建和销毁这个类时的回调事件。

 /** A basic Camera preview class */
 public class CameraPreview extends SurfaceView implements SurfaceHolder.Callback {
     private SurfaceHolder mHolder;
     private Camera mCamera;

     public CameraPreview(Context context, Camera camera) {
         super(context);
         mCamera = camera;

         // Install a SurfaceHolder.Callback so we get notified when the
         // underlying surface is created and destroyed.
         mHolder = getHolder();
         mHolder.addCallback(this);
         // deprecated setting, but required on Android versions prior to 3.0
         mHolder.setType(SurfaceHolder.SURFACE_TYPE_PUSH_BUFFERS);
     }

     public void surfaceCreated(SurfaceHolder holder) {
         // The Surface has been created, now tell the camera where to draw the preview.
         try {
             mCamera.setPreviewDisplay(holder);
             mCamera.startPreview();
         } catch (IOException e) {
             Log.d(TAG, "Error setting camera preview: " + e.getMessage());
         }
     }

     public void surfaceDestroyed(SurfaceHolder holder) {
         // empty. Take care of releasing the Camera preview in your activity.
     }

     public void surfaceChanged(SurfaceHolder holder, int format, int w, int h) {
         // If your preview can change or rotate, take care of those events here.
         // Make sure to stop the preview before resizing or reformatting it.

         if (mHolder.getSurface() == null){
           // preview surface does not exist
           return;
         }

         // stop preview before making changes
         try {
             mCamera.stopPreview();
         } catch (Exception e){
           // ignore: tried to stop a non-existent preview
         }

         // set preview size and make any resize, rotate or
         // reformatting changes here

         // start preview with new settings
         try {
             mCamera.setPreviewDisplay(mHolder);
             mCamera.startPreview();

         } catch (Exception e){
             Log.d(TAG, "Error starting camera preview: " + e.getMessage());
         }
     }
 }

　　如果你想为相机预览类设定一个特定的大小，在上面的surfaceChaned()方法中设定。当设定大小时，你必须从getSupportedPreviewSizes()获取数值。不要随意设定一个值。

放置preview入一个布局中

　　相机预览类，如同上面展示的，它必须被放置进Activity的布局中，这样其他UI可以控制拍照。下面一节展示了如何为这个preview创建一个基本的布局和Activity。

　　下面的布局代码提供了一个非常基本的view来展示相机预览类。在这个例子中，FrameLayout元素就是相机预览类的容器。使用这个布局类型，可以把另外的图片信息或者控制覆盖在动态相机预览图像上。

 <?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>

　　在大多数设备中，相机预览默认的方向是横向的。这个例子设定了水平布局，下面的代码中修改了应用程序的方向为横向。为了使相机预览类渲染简单，你应该应该把照着下面在manifest中把应用程序预览所在的ctivity为横向。

 <activity android:name=".CameraActivity"
           android:label="@string/app_name"

           android:screenOrientation="landscape">
           <!-- configure this activity to use landscape orientation -->

           <intent-filter>
         <action android:name="android.intent.action.MAIN" />
         <category android:name="android.intent.category.LAUNCHER" />
     </intent-filter>
 </activity>

　　注意：相机预览不一定要是横向的。从android 2.2(API 8)开始，你可以使用setDisplayOrientation()方法去旋转预览的图像。当用户改变了手机方向，如果要调整预览的方向，可以在预览类的surfaceChanged()方法中，先使用Camer.stopPreview()停止预览,然后改变方向，最后再使用Camera.startPreview()打开预览.

　　在你相机视图所在的activity中，下面的例子中，添加了预览类到FrameLayout元素中。这个activity必须确保当它被暂停（paused）或者关闭时，要释放相机。下面的例子，展示了如何向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()方法，是在连接相机一节的。

拍照

　　一旦你构建了预览类（preview）和一个展示它的视图布局，你将要在你的应用程序中开始编写拍照了。你必须设置监听器给你的UI去响应用户的拍照动作。
为了获取照片，使用Camera.takePicture()方法。这个方法需要三个参数，它们从camera中获取数据。为了获取JPEG格式的数据，你必须实现一个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()触发拍照。下面的例子展示了如何通过button的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的细节，情况释放相机一节。

释放相机

　　相机作用一种资源，被设备中的多个应用程序共享。你的应用程序在获取Camera实例后可以使用它，当你的程序停止使用它时，或者一旦你的程序暂停（Activity.onPause()），你必须特别注意去释放它。如果你的程序没有适当的释放它，所有后续对它的连接请求，都会导致你的程序或者其他程序都会被关闭。

　　使用Camera.release()方法释放一个Camera对象的实例，下面是例子。

 public class CameraActivity extends Activity {
     private Camera mCamera;
     private SurfaceView mPreview;

     ...

     @Override
     protected void onPause() {
         super.onPause();
         releaseCamera();              // release the camera immediately on pause event
     }

     private void releaseCamera(){
         if (mCamera != null){
             mCamera.release();        // release the camera for other applications
             mCamera = null;
         }
     }
 }

参考：http://developer.android.com/guide/topics/media/camera.html