| <?xml version="1.0" encoding="UTF-8"?> |
| <!-- |
| Copyright 2014 The Android Open Source Project |
| |
| Licensed under the Apache License, Version 2.0 (the "License"); |
| you may not use this file except in compliance with the License. |
| You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| --> |
| |
| |
| |
| <sample> |
| <name>Camera2Basic</name> |
| <group>Media</group> |
| <package>com.example.android.camera2basic</package> |
| <minSdk>21</minSdk> |
| <compileSdkVersion>21</compileSdkVersion> |
| <strings> |
| <intro> |
| <![CDATA[ |
| This sample demonstrates the basic use of Camera2 API. Check the source code to see how |
| you can display camera preview and take pictures. |
| ]]> |
| </intro> |
| </strings> |
| |
| <template src="base"/> |
| |
| <metadata> |
| <status>PUBLISHED</status> |
| <categories>Media, Camera, Camera2</categories> |
| <technologies>Android</technologies> |
| <languages>Java</languages> |
| <solutions>Mobile</solutions> |
| <level>INTERMEDIATE</level> |
| <icon>screenshots/icon-web.png</icon> |
| <screenshots> |
| <img>screenshots/main.png</img> |
| </screenshots> |
| <api_refs> |
| <android>android.hardware.camera2.CameraManager</android> |
| <android>android.hardware.camera2.CameraDevice</android> |
| <android>android.hardware.camera2.CameraCharacteristics</android> |
| <android>android.hardware.camera2.CameraCaptureSession</android> |
| <android>android.hardware.camera2.CaptureRequest</android> |
| <android>android.hardware.camera2.CaptureResult</android> |
| <android>android.view.TextureView</android> |
| </api_refs> |
| |
| <description> |
| <![CDATA[ |
| This sample demonstrates how to use basic functionalities of Camera2 |
| API. You can learn how to iterate through characteristics of all the |
| cameras attached to the device, display a camera preview, and take |
| pictures. |
| ]]> |
| </description> |
| |
| <intro> |
| <![CDATA[ |
| The [Camera2 API][1] provides an interface to individual camera |
| devices connected to an Android device. It replaces the deprecated |
| Camera class. |
| |
| Use [getCameraIdList][2] to get a list of all the available |
| cameras. You can then use [getCameraCharacteristics][3] and find the |
| best camera that suits your need (front/rear facing, resolution etc). |
| |
| Create an instance of [CameraDevice.StateCallback][4] and open a |
| camera. It is ready to start camera preview when the camera is opened. |
| |
| This sample uses TextureView to show the camera preview. Create a |
| [CameraCaptureSession][5] and set a repeating [CaptureRequest][6] to it. |
| |
| Still image capture takes several steps. First, you need to lock the |
| focus of the camera by updating the CaptureRequest for the camera |
| preview. Then, in a similar way, you need to run a precapture |
| sequence. After that, it is ready to capture a picture. Create a new |
| CaptureRequest and call [capture][7]. Don't forget to unlock the focus |
| when you are done. |
| |
| [1]: https://developer.android.com/reference/android/hardware/camera2/package-summary.html |
| [2]: https://developer.android.com/reference/android/hardware/camera2/CameraManager.html#getCameraIdList() |
| [3]: https://developer.android.com/reference/android/hardware/camera2/CameraManager.html#getCameraCharacteristics(java.lang.String) |
| [4]: https://developer.android.com/reference/android/hardware/camera2/CameraDevice.StateCallback.html |
| [5]: https://developer.android.com/reference/android/hardware/camera2/CameraCaptureSession.html |
| [6]: https://developer.android.com/reference/android/hardware/camera2/CaptureRequest.html |
| [7]: https://developer.android.com/reference/android/hardware/camera2/CameraCaptureSession.html#capture(android.hardware.camera2.CaptureRequest, android.hardware.camera2.CameraCaptureSession.CaptureCallback, android.os.Handler) |
| ]]> |
| </intro> |
| </metadata> |
| |
| </sample> |