控制摄像头拍照（一）

[align=left]现在的手机一般都会提供相机功能，有些相机的镜头甚至支持1000万以上像素，有些甚至支持光学变焦，这些手机已经变成了专业数码相机。为了充分利用手机上的相机功能，Android应用可以控制拍照和录制视频。[/align]
††
使用Android 5.0的Camera v2拍照
Android 5.0对拍照API进行了全新的设计，新增了全新设计的Camera
v2 API，这些API不仅大幅提高了Android系统拍照的功能，还能支持RAW照片输出，甚至允许程序调整相机的对焦模式、曝光模式、快门等。
[align=left]Android 5.0的Camera v2主要涉及如下API。[/align]
Ø
CameraManager：摄像头管理器。这是一个全新的系统管理器，专门用于检测系统摄像头、打开系统摄像头。除此之外，调用CameraManager的getCameraCharacteristics(String)方法即可获取指定摄像头的相关特性。
Ø
CameraCharacteristics：摄像头特性。该对象通过CameraManager来获取，用于描述特定摄像头所支持的各种特性。
Ø
CameraDevice：代表系统摄像头。该类的功能类似于早期的Camera类。
Ø
CameraCaptureSession：这是一个非常重要的API，当程序需要预览、拍照时，都需要先通过该类的实例创建Session。而且不管预览还是拍照，也都是由该对象的方法进行控制的，其中控制预览的方法为setRepeatingRequest()；控制拍照的方法为capture()。
为了监听CameraCaptureSession的创建过程，以及监听CameraCaptureSession的拍照过程，Camera
v2 API为CameraCaptureSession提供了StateCallback、CaptureCallback等内部类。
Ø
CameraRequest和CameraRequest.Builder：当程序调用setRepeatingRequest()方法进行预览时，或调用capture()方法进行拍照时，都需要传入CameraRequest参数。CameraRequest代表了一次捕获请求，用于描述捕获图片的各种参数设置，比如对焦模式、曝光模式……总之，程序需要对照片所做的各种控制，都通过CameraRequest参数进行设置。CameraRequest.Builder则负责生成CameraRequest对象。
[align=left]理解了上面API的功能和作用之后，接下来即可使用Camera v2 API来控制摄像头拍照了。控制拍照的步骤大致如下。[/align]
调用CameraManager的openCamera(String cameraId, CameraDevice.StateCallback callback, Handler
handler)方法打开指定摄像头。该方法的第一个参数代表要打开的摄像头ID；第二个参数用于监听摄像头的状态；第三个参数代表执行callback的Handler，如果程序希望直接在当前线程中执行callback，则可将handler参数设为null。
当摄像头被打开之后，程序即可获取CameraDevice—即根据摄像头ID获取了指定摄像头设备，然后调用CameraDevice的createCaptureSession(List<Surface>
outputs, CameraCaptureSession. StateCallback callback，Handler handler)方法来创建CameraCaptureSession。该方法的第一个参数是一个List集合，封装了所有需要从该摄像头获取图片的Surface，第二个参数用于监听CameraCaptureSession的创建过程；第三个参数代表执行callback的Handler，如果程序希望直接在当前线程中执行callback，则可将handler参数设为null。
[align=left]不管预览还是拍照，程序都调用CameraDevice的createCaptureRequest(int templateType)方法创建CaptureRequest.Builder，该方法支持TEMPLATE_PREVIEW（预览）、TEMPLATE_RECORD（拍摄视频）、TEMPLATE_STILL_CAPTURE（拍照）等参数。[/align]
[align=left]通过第3步所调用方法返回的CaptureRequest.Builder设置拍照的各种参数，比如对焦模式、曝光模式等。[/align]
[align=left]调用CaptureRequest.Builder的build()方法即可得到CaptureRequest对象，接下来程序可通过CameraCaptureSession的setRepeatingRequest()方法开始预览，或调用capture()方法拍照。[/align]
实例：拍照时自动对焦

[align=left]本实例示范了使用Camera v2来进行拍照。当用户按下拍照键时，该应用会自动对焦，当对焦成功时拍下照片。该程序的界面中提供了一个自定义TextureView来显示预览取景，十分简单。该自定义TextureView类的代码如下。[/align]
[align=left]程序清单：codes\11\3\CameraV2Test\app\src\main\java\org\crazyit\media\MainActivity.java[/align]
[align=left]public class AutoFitTextureView extends TextureView[/align]
[align=left]{[/align]
[align=left] private int mRatioWidth = 0;[/align]
[align=left] private int mRatioHeight = 0;[/align]
[align=left] public AutoFitTextureView(Context context, AttributeSet attrs)[/align]
[align=left] {[/align]
[align=left] super(context, attrs);[/align]
[align=left] }[/align]
[align=left] public void setAspectRatio(int width, int height)[/align]
[align=left] {[/align]
[align=left] mRatioWidth = width;[/align]
[align=left] mRatioHeight = height;[/align]
[align=left] requestLayout();[/align]
[align=left] }[/align]
[align=left] @Override[/align]
[align=left] protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec)[/align]
[align=left] {[/align]
[align=left] super.onMeasure(widthMeasureSpec, heightMeasureSpec);[/align]
[align=left] int width = MeasureSpec.getSize(widthMeasureSpec);[/align]
[align=left] int height = MeasureSpec.getSize(heightMeasureSpec);[/align]
[align=left] if (0 == mRatioWidth || 0 == mRatioHeight)[/align]
[align=left] {[/align]
[align=left] setMeasuredDimension(width, height);[/align]
[align=left] }[/align]
[align=left] else[/align]
[align=left] {[/align]
[align=left] if (width < height * mRatioWidth / mRatioHeight)[/align]
[align=left] {[/align]
[align=left] setMeasuredDimension(width, width * mRatioHeight / mRatioWidth);[/align]
[align=left] }[/align]
[align=left] else[/align]
[align=left] {[/align]
[align=left] setMeasuredDimension(height * mRatioWidth / mRatioHeight, height);[/align]
[align=left] }[/align]
[align=left] }[/align]
[align=left] }[/align]
[align=left]}[/align]
[align=left]接下来的MainActivity将会使用CameraManager来打开CameraDevice，并通过CameraDevice创建CameraCaptureSession，然后即可通过CameraCaptureSession进行预览或拍照了。该Activity的代码如下。[/align]
[align=left]程序清单：codes\11\3\CameraV2Test\app\src\main\java\org\crazyit\media\MainActivity.java[/align]
[align=left]public class MainActivity extends Activity implements View.OnClickListener[/align]
[align=left]{[/align]
[align=left] private static final SparseIntArray ORIENTATIONS = new SparseIntArray();[/align]
[align=left] static[/align]
[align=left] {[/align]
[align=left] ORIENTATIONS.append(Surface.ROTATION_0, 90);[/align]
[align=left] ORIENTATIONS.append(Surface.ROTATION_90, 0);[/align]
[align=left] ORIENTATIONS.append(Surface.ROTATION_180, 270);[/align]
[align=left] ORIENTATIONS.append(Surface.ROTATION_270, 180);[/align]
[align=left] }[/align]
[align=left] private AutoFitTextureView textureView;[/align]
//
摄像头ID（通常0代表后置摄像头，1代表前置摄像头）
[align=left] private String mCameraId = "0";[/align]
//
定义代表摄像头的成员变量
[align=left] private CameraDevice cameraDevice;[/align]
//
预览尺寸
[align=left] private Size previewSize;[/align]
[align=left] private CaptureRequest.Builder previewRequestBuilder;[/align]
//
定义用于预览照片的捕获请求
[align=left] private CaptureRequest previewRequest;[/align]
//
定义CameraCaptureSession成员变量
[align=left] private CameraCaptureSession captureSession;[/align]
[align=left] private ImageReader imageReader;[/align]
[align=left] private final TextureView.SurfaceTextureListener mSurfaceTextureListener[/align]
[align=left] = new TextureView.SurfaceTextureListener()[/align]
[align=left] {[/align]
[align=left] @Override[/align]
[align=left] public void onSurfaceTextureAvailable(SurfaceTexture texture[/align]
[align=left] , int width, int height)[/align]
[align=left] {[/align]
//
当TextureView可用时，打开摄像头
[align=left] openCamera(width, height);[/align]
[align=left] }[/align]
[align=left] @Override[/align]
[align=left] public void onSurfaceTextureSizeChanged(SurfaceTexture texture[/align]
[align=left] , int width, int height){ }[/align]
[align=left] @Override[/align]
[align=left] public boolean onSurfaceTextureDestroyed(SurfaceTexture texture) { return true; }[/align]
[align=left] @Override[/align]
[align=left] public void onSurfaceTextureUpdated(SurfaceTexture texture){}[/align]
[align=left] };[/align]
[align=left] private final CameraDevice.StateCallback stateCallback = new CameraDevice. StateCallback()[/align]
[align=left] {[/align]
//
摄像头被打开时激发该方法
[align=left] @Override[/align]
[align=left] public void onOpened(CameraDevice cameraDevice)[/align]
[align=left] {[/align]
[align=left] MainActivity.this.cameraDevice = cameraDevice;[/align]
//
开始预览
createCameraPreviewSession(); //
②
[align=left] }[/align]
//
摄像头断开连接时激发该方法
[align=left] @Override[/align]
[align=left] public void onDisconnected(CameraDevice cameraDevice)[/align]
[align=left] {[/align]
[align=left] cameraDevice.close();[/align]
[align=left] MainActivity.this.cameraDevice = null;[/align]
[align=left] }[/align]
//
打开摄像头出现错误时激发该方法
[align=left] @Override[/align]
[align=left] public void onError(CameraDevice cameraDevice, int error)[/align]
[align=left] {[/align]
[align=left] cameraDevice.close();[/align]
[align=left] MainActivity.this.cameraDevice = null;[/align]
[align=left] MainActivity.this.finish();[/align]
[align=left] }[/align]
[align=left] };[/align]
[align=left] @Override[/align]
[align=left] protected void onCreate(Bundle savedInstanceState)[/align]
[align=left] {[/align]
[align=left] super.onCreate(savedInstanceState);[/align]
[align=left] setContentView(R.layout.main);[/align]
[align=left] textureView = (AutoFitTextureView) findViewById(R.id.texture);[/align]
//
为该组件设置监听器
[align=left] textureView.setSurfaceTextureListener(mSurfaceTextureListener);[/align]
[align=left] findViewById(R.id.capture).setOnClickListener(this);[/align]
[align=left] }[/align]
[align=left] @Override[/align]
[align=left] public void onClick(View view)[/align]
[align=left] {[/align]
[align=left] captureStillPicture();[/align]
[align=left] }[/align]
[align=left] private void captureStillPicture()[/align]
[align=left] {[/align]
[align=left] try[/align]
[align=left] {[/align]
[align=left] if (cameraDevice == null)[/align]
[align=left] {[/align]
[align=left] return;[/align]
[align=left] }[/align]
//
创建作为拍照的CaptureRequest.Builder
[align=left] final CaptureRequest.Builder captureRequestBuilder = cameraDevice[/align]
[align=left] .createCaptureRequest(CameraDevice.TEMPLATE_STILL_CAPTURE);[/align]
//
将imageReader的surface作为CaptureRequest.Builder的目标
[align=left] captureRequestBuilder.addTarget(imageReader.getSurface());[/align]
//
设置自动对焦模式
[align=left] captureRequestBuilder.set(CaptureRequest.CONTROL_AF_MODE,[/align]
[align=left] CaptureRequest.CONTROL_AF_MODE_CONTINUOUS_PICTURE);[/align]
//
设置自动曝光模式
[align=left] captureRequestBuilder.set(CaptureRequest.CONTROL_AE_MODE,[/align]
[align=left] CaptureRequest.CONTROL_AE_MODE_ON_AUTO_FLASH);[/align]
//
获取设备方向
[align=left] int rotation = getWindowManager().getDefaultDisplay().getRotation();[/align]
//
根据设备方向计算设置照片的方向
[align=left] captureRequestBuilder.set(CaptureRequest.JPEG_ORIENTATION[/align]
[align=left] , ORIENTATIONS.get(rotation));[/align]
//
停止连续取景
[align=left] captureSession.stopRepeating();[/align]
//
捕获静态图像
[align=left] captureSession.capture(captureRequestBuilder.build()[/align]
, new CameraCaptureSession.CaptureCallback() //
⑤
[align=left] {[/align]
//
拍照完成时激发该方法
[align=left] @Override[/align]
[align=left] public void onCaptureCompleted(CameraCaptureSession session[/align]
[align=left] , CaptureRequest request, TotalCaptureResult result)[/align]
[align=left] {[/align]
[align=left] try[/align]
[align=left] {[/align]
//
重设自动对焦模式
[align=left] previewRequestBuilder.set(CaptureRequest.CONTROL_AF_TRIGGER,[/align]
[align=left] CameraMetadata.CONTROL_AF_TRIGGER_CANCEL);[/align]
//
设置自动曝光模式
[align=left] previewRequestBuilder.set(CaptureRequest.CONTROL_AE_MODE,[/align]
[align=left] CaptureRequest.CONTROL_AE_MODE_ON_AUTO_FLASH);[/align]
//
打开连续取景模式
[align=left] captureSession.setRepeatingRequest(previewRequest, null, null);[/align]
[align=left] }[/align]
[align=left] catch (CameraAccessException e)[/align]
[align=left] {[/align]
[align=left] e.printStackTrace();[/align]
[align=left] }[/align]
[align=left] }[/align]
}, null);

[align=left] }[/align]
[align=left] catch (CameraAccessException e)[/align]
[align=left] {[/align]
[align=left] e.printStackTrace();[/align]
[align=left] }[/align]
[align=left] }[/align]
//
打开摄像头
[align=left] private void openCamera(int width, int height)[/align]
[align=left] {[/align]
[align=left] setUpCameraOutputs(width, height);[/align]
[align=left] CameraManager manager = (CameraManager) getSystemService(Context.CAMERA_ SERVICE);[/align]
[align=left] try[/align]
[align=left] {[/align]
//
打开摄像头
manager.openCamera(mCameraId, stateCallback, null); //
①
[align=left] }[/align]
[align=left] catch (CameraAccessException e)[/align]
[align=left] {[/align]
[align=left] e.printStackTrace();[/align]
[align=left] }[/align]
[align=left] }[/align]
[align=left] private void createCameraPreviewSession()[/align]
[align=left] {[/align]
[align=left] try[/align]
[align=left] {[/align]
[align=left] SurfaceTexture texture = textureView.getSurfaceTexture();[/align]
[align=left] texture.setDefaultBufferSize(previewSize.getWidth(), previewSize.getHeight());[/align]
//
创建作为预览的CaptureRequest.Builder
[align=left] previewRequestBuilder = cameraDevice[/align]
[align=left] .createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW);[/align]
//
将textureView的surface作为CaptureRequest.Builder的目标
[align=left] previewRequestBuilder.addTarget(new Surface(texture));[/align]
//
创建CameraCaptureSession，该对象负责管理处理预览请求和拍照请求
[align=left] cameraDevice.createCaptureSession(Arrays.asList(surface[/align]
, imageReader.getSurface()), new CameraCaptureSession.StateCallback() //
③
[align=left] {[/align]
[align=left] @Override[/align]
[align=left] public void onConfigured(CameraCaptureSession cameraCaptureSession)[/align]
[align=left] {[/align]
//
如果摄像头为null，直接结束方法
[align=left] if (null == cameraDevice)[/align]
[align=left] {[/align]
[align=left] return;[/align]
[align=left] }[/align]
//
当摄像头已经准备好时，开始显示预览
[align=left] captureSession = cameraCaptureSession;[/align]
[align=left] try[/align]
[align=left] {[/align]
//
设置自动对焦模式
[align=left] previewRequestBuilder.set(CaptureRequest.CONTROL_AF_MODE,[/align]
[align=left] CaptureRequest.CONTROL_AF_MODE_CONTINUOUS_PICTURE);[/align]
//
设置自动曝光模式
[align=left] previewRequestBuilder.set(CaptureRequest.CONTROL_AE_MODE,[/align]
[align=left] CaptureRequest.CONTROL_AE_MODE_ON_AUTO_FLASH);[/align]
//
开始显示相机预览
[align=left] previewRequest = previewRequestBuilder.build();[/align]
//
设置预览时连续捕获图像数据
[align=left] captureSession.setRepeatingRequest(previewRequest,[/align]
null, null); //
④
[align=left] }[/align]
[align=left] catch (CameraAccessException e)[/align]
[align=left] {[/align]
[align=left] e.printStackTrace();[/align]
[align=left] }[/align]
[align=left] }[/align]
[align=left] @Override[/align]
[align=left] public void onConfigureFailed(CameraCaptureSession cameraCaptureSession)[/align]
[align=left] {[/align]
[align=left] Toast.makeText(MainActivity.this, "配置失败！"[/align]
[align=left] , Toast.LENGTH_SHORT).show();[/align]
[align=left] }[/align]
[align=left] }, null[/align]
[align=left] );[/align]
[align=left] }[/align]
[align=left] catch (CameraAccessException e)[/align]
[align=left] {[/align]
[align=left] e.printStackTrace();[/align]
[align=left] }[/align]
[align=left] }[/align]
[align=left] private void setUpCameraOutputs(int width, int height)[/align]
[align=left] {[/align]
[align=left] CameraManager manager = (CameraManager) getSystemService(Context.CAMERA_ SERVICE);[/align]
[align=left] try[/align]
[align=left] {[/align]
//
获取指定摄像头的特性
[align=left] CameraCharacteristics characteristics[/align]
[align=left] = manager.getCameraCharacteristics(mCameraId);[/align]
//
获取摄像头支持的配置属性
[align=left] StreamConfigurationMap map = characteristics.get([/align]
[align=left] CameraCharacteristics.SCALER_STREAM_CONFIGURATION_MAP);[/align]
//
获取摄像头支持的最大尺寸
[align=left] Size largest = Collections.max([/align]
[align=left] Arrays.asList(map.getOutputSizes(ImageFormat.JPEG)),[/align]
[align=left] new CompareSizesByArea());[/align]
//
创建一个ImageReader对象，用于获取摄像头的图像数据
[align=left] imageReader = ImageReader.newInstance(largest.getWidth(), largest.getHeight(),[/align]
[align=left] ImageFormat.JPEG, 2);[/align]
[align=left] imageReader.setOnImageAvailableListener([/align]
[align=left] new ImageReader.OnImageAvailableListener()[/align]
[align=left] {[/align]
//
当照片数据可用时激发该方法
[align=left] @Override[/align]
[align=left] public void onImageAvailable(ImageReader reader)[/align]
[align=left] {[/align]
//
获取捕获的照片数据
[align=left] Image image = reader.acquireNextImage();[/align]
[align=left] ByteBuffer buffer = image.getPlanes()[0].getBuffer();[/align]
[align=left] byte[] bytes = new byte[buffer.remaining()];[/align]
//
使用IO流将照片写入指定文件
[align=left] File file = new File(getExternalFilesDir(null), "pic.jpg");[/align]
[align=left] buffer.get(bytes);[/align]
[align=left] try ([/align]
[align=left] FileOutputStream output = new FileOutputStream(file))[/align]
[align=left] {[/align]
[align=left] output.write(bytes);[/align]
Toast.makeText(MainActivity.this, "保存:
"
[align=left] + file, Toast.LENGTH_SHORT).show();[/align]
[align=left] }[/align]
[align=left] catch (Exception e)[/align]
[align=left] {[/align]
[align=left] e.printStackTrace();[/align]
[align=left] }[/align]
[align=left] finally[/align]
[align=left] {[/align]
[align=left] image.close();[/align]
[align=left] }[/align]
[align=left] }[/align]
[align=left] }, null);[/align]
//
获取最佳的预览尺寸
[align=left] previewSize = chooseOptimalSize(map.getOutputSizes([/align]
[align=left] SurfaceTexture.class), width, height, largest);[/align]
//
根据选中的预览尺寸来调整预览组件（TextureView）的长宽比
[align=left] int orientation = getResources().getConfiguration().orientation;[/align]
[align=left] if (orientation == Configuration.ORIENTATION_LANDSCAPE)[/align]
[align=left] {[/align]
textureView.setAspectRatio(previewSize.getWidth(), previewSize.

[align=left]getHeight());[/align]
[align=left] }[/align]
[align=left] else[/align]
[align=left] {[/align]
textureView.setAspectRatio(previewSize.getHeight(),

[align=left]previewSize.getWidth());[/align]
[align=left] }[/align]
[align=left] }[/align]
[align=left] catch (CameraAccessException e)[/align]
[align=left] {[/align]
[align=left] e.printStackTrace();[/align]
[align=left] }[/align]
[align=left] catch (NullPointerException e)[/align]
[align=left] {[/align]
[align=left] System.out.println("出现错误。");[/align]
[align=left] }[/align]
[align=left] }[/align]
[align=left] private static Size chooseOptimalSize(Size[] choices[/align]
[align=left] , int width, int height, Size aspectRatio)[/align]
[align=left] {[/align]
//
收集摄像头支持的大过预览Surface的分辨率
[align=left] List<Size> bigEnough = new ArrayList<>();[/align]
[align=left] int w = aspectRatio.getWidth();[/align]
[align=left] int h = aspectRatio.getHeight();[/align]
[align=left] for (Size option : choices)[/align]
[align=left] {[/align]
[align=left] if (option.getHeight() == option.getWidth() * h / w &&[/align]
[align=left] option.getWidth() >= width && option.getHeight() >= height)[/align]
[align=left] {[/align]
[align=left] bigEnough.add(option);[/align]
[align=left] }[/align]
[align=left] }[/align]
//
如果找到多个预览尺寸，获取其中面积最小的
[align=left] if (bigEnough.size() > 0)[/align]
[align=left] {[/align]
[align=left] return Collections.min(bigEnough, new CompareSizesByArea());[/align]
[align=left] }[/align]
[align=left] else[/align]
[align=left] {[/align]
[align=left] System.out.println("找不到合适的预览尺寸！！！");[/align]
[align=left] return choices[0];[/align]
[align=left] }[/align]
[align=left] }[/align]
//
为Size定义一个比较器Comparator
[align=left] static class CompareSizesByArea implements Comparator<Size>[/align]
[align=left] {[/align]
[align=left] @Override[/align]
[align=left] public int compare(Size lhs, Size rhs)[/align]
[align=left] {[/align]
//
强转为long保证不会发生溢出
[align=left] return Long.signum((long) lhs.getWidth() * lhs.getHeight() -[/align]
[align=left] (long) rhs.getWidth() * rhs.getHeight());[/align]
[align=left] }[/align]
[align=left] }[/align]
[align=left]}[/align]
[align=left]上面程序中的①号粗体字代码用于打开系统摄像头，openCamera()方法的第一个参数代表请求打开的摄像头ID，此处传入的摄像头ID为"0"，这代表打开设备后置摄像头；如果需要打开设备指定摄像头（比如前置摄像头），可以在调用openCamera()方法时传入相应的摄像头ID。[/align]
[align=left]CameraManager提供了getCameraIdList()方法来获取设备的摄像头列表，还提供了getCameraCharacteristics(String cameraId)方法来获取指定摄像头的特性。例如如下代码：[/align]
//
获取设备上摄像头列表
[align=left]String[] ids = CameraManager.getCameraIdList();[/align]
//
创建一个空的CameraInfo对象，用于获取摄像头信息
Camera.CameraInfo cameraInfo = new Camera.CameraInfo();

[align=left]for ( String id : ids)[/align]
[align=left]{[/align]
[align=left] CameraCharacteristics cc = getCameraCharacteristics(id);[/align]
//
接下来的代码就可以通过cc来获取该摄像头的特性了
[align=left] ...[/align]
[align=left]}[/align]
上面程序中的①号粗体字代码打开后置摄像头时传入了一个stateCallback参数，该参数代表的对象可检测摄像头的状态改变，当摄像头的状态发生改变时，程序将会自动回调该对象的相应方法。该程序的关键是重写了stateCallback的onOpened(CameraDevice
cameraDevice)方法—当摄像头被打开时将会自动激发该方法，通过该方法的参数即可让程序获取被打开的摄像头设备。除此之外，程序在onOpened()方法的②号粗体字代码处调用createCameraPreviewSession()方法创建了CameraCaptureSession，并开始预览取景。
[align=left]createCameraPreviewSession()方法中的③号粗体字代码调用了CameraDevice的createCaptureSession()方法来创建CameraCaptureSession，调用该方法时也传入了一个CameraCaptureSession.StateCallback参数，这样即可保证当CameraCaptureSession被创建成功之后立即开始预览。[/align]
[align=left]createCameraPreviewSession()方法的第一行粗体字代码将texture组件添加为previewRequestBuilder的target，这意味着程序通过previewRequestBuilder获取的图像数据将会被显示在texture组件上。[/align]
[align=left]程序重写了CameraCaptureSession.StateCallback的onConfigured()方法—当CameraCaptureSession创建成功时将会自动回调该方法，该方法先通过previewRequestBuilder设置了预览参数，然后调用CameraCaptureSession对象的setRepeatingRequest()方法开始预览。[/align]
[align=left]当单击程序界面上的拍照按钮时，程序将会激发该Activity的captureStillPicture()方法。该方法的实现逻辑同样很简单：程序先创建一个CaptureRequest.Builder对象，该方法中第一行粗体字代码将ImageReader添加成CaptureRequest.Builder的target—这意味着当程序拍照时，图像数据将会被传给此ImageReader。接下来程序通过CaptureRequest.Builder设置了拍照参数，然后通过⑤号粗体字代码调用CameraCaptureSession的capture()方法拍照即可，调用该方法时也传入了CaptureCallback参数，这样可以保证拍照完成之后会重新开始预览。[/align]
[align=left]注意：该应用打开摄像头、创建CameraCaptureSession、预览、拍照时都没有传入Handler参数，这意味着程序直接在主线程中完成相应的Callback任务，这样可能导致程序响应变慢。对于实际的应用，我们建议传入Handler参数，这样即可让Handler使用新线程来执行Callback任务，这样才可提高应用的响应速度。[/align]
[align=left]由于该程序需要使用手机的摄像头，因此还需要在AndroidManifest.xml文件中增加如下配置：[/align]
<!--
授予该程序使用摄像头的权限 -->
[align=left]<uses-permission android:name="android.permission.CAMERA" />[/align]
[align=left]在Genymotion模拟器上运行该程序可能看到如图1所示的预览界面—这是因为Genymotion模拟器可以使用宿主电脑上的摄像头作为相机摄像头。[/align]
[align=left]为了让模拟器能显示图1所示的预览界面，建议读者启用Genymotion模拟器的摄像头支持：单击Genymotion模拟器右边的摄像头图标，即可看到如图2所示的对话框。按该图上标出的提示即可打开Genymotion模拟器的摄像头支持。[/align]
[align=left]运行该程序，按下右下角的“拍照”键，程序将会把拍得的照片保存下来，界面上也会显示该照片的存储目录。[/align]



图1 预览界面