android——创建camera应用(译)

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

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

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

检测和连接相机—检测camera是否存在和请求连接

创建预览类—创建Preview，它继承SurfaceView和实现了SurfaceHolder接口。这个类可以预览相机中动态的画面。

构造预览的布局一旦你拥有了Preview类，就需要创建一个View布局。布局中放入Preview和你想要的其他UI。

给拍照设置监听器—连接监听器去启动拍照，来响应用户的动作，例如按下按钮。

拍照和保存文件—编写代码实现拍照和保存输出。

释放相机—使用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