android.hardware.camera源码,android.hardware.Camera

1. android.hardware.Camera

The Camera class is used to set image capture settings, start/stop preview, snap pictures, and retrieve frames for encoding for video. This class is a client for the Camera service, which manages the actual camera hardware.

To access the device camera, you must declare themanifest element to declare camera features used by your application. For example, if you use the camera and auto-focus feature, your Manifest should include the following:

To take pictures with this class, use the following steps:

Obtain an instance of Camera from

Get existing (default) settings with

If necessary, modify the returned

Important: Pass a fully initialized

Important: Call

After taking a picture, preview display will have stopped. To take more photos, call

Call

Important: Call

To quickly switch to video recording mode, use these steps:

Obtain and initialize a Camera and start preview as described above.

Call

Pass the camera to

When finished recording, call

If desired, restart preview and take more photos or videos.

Call

This class is not thread-safe, and is meant for use from one event thread. Most long-running operations (preview, focus, photo capture, etc) happen asynchronously and invoke callbacks as necessary. Callbacks will be invoked on the event thread

Caution: Different Android-powered devices may have different hardware specifications, such as megapixel ratings and auto-focus capabilities. In order for your application to be compatible with more devices, you should not make assumptions about the device camera specifications.

Developer Guides

For more information about using cameras, read theCameradeveloper guide.

2. Building a Camera App

Some developers may require a camera user interface that is customized to the look of their application or provides special features. Creating a customized camera activity requires more code thanusing an intent, but it can provide a more compelling experience for your users.

The general steps for creating a custom camera interface for your application are as follows:

Detect and Access Camera - Create code to check for the existence of cameras and request access.

Create a Preview Class - Create a camera preview class that extends

Build a Preview Layout - Once you have the camera preview class, create a view layout that incorporates the preview and the user interface controls you want.

Setup Listeners for Capture - Connect listeners for your interface controls to start image or video capture in response to user actions, such as pressing a button.

Capture and Save Files - Setup the code for capturing pictures or videos and saving the output.

Release the Camera - After using the camera, your application must properly release it for use by other applications.

Camera hardware is a shared resource that must be carefully managed so your application does not collide with other applications that may also want to use it. The following sections discusses how to detect camera hardware, how to request access to a camera, how to capture pictures or video and how to release the camera when your application is done using it.

Caution: Remember to release the