Take Photos Using Camera2 API
The Android Camera2 API was introduced in Android API level 21 corresponding to Android 5.0 Lollipop. Camera2 API introduced new features to control, capture and manipulate captured images.
Camera2 API offers developers more control over the camera hardware, allowing for fine-grained adjustments such as shutter speed (ISO), autofocus, and RAW capture. Camera2 API Reference provides detailed documentation.
For this tutorial, Camera2 API will be used to place the camera in a TextureView and save a photo. This is part of the ongoing Chicken Webcam App series. Most of the samples did not work in Android Studio, instead trail and error .
This is a native Kotlin Android application, and not the HTML5 application that runs in a web browser. Kotlin is a cross-platform, statically typed, general-purpose high-level programming language with type inference.
Requirements For Native Android Application
Glossary:
IP
Internet Protocol address is a numerical label that is assigned to a device connected to a computer network.
Wi-Fi
Wireless network protocols based on the IEEE 802.11 standards for local area networks.
WLAN
Wireless LAN is a computer network that links 2 or more devices.
TCP/IP
Transmission Control Protocol/Internet Protocol is a framework for computer networking.
USB
Universal Serial Bus is a standard for digital data transmission and power delivery between electronics.
ADB
Android Debug Bridge.
API
Application Programming Interface is a set of rules or protocols that enables software applications to communicate with each other to exchange data, features, and functionality.
UI
User Interface is the point of interaction between humans and machines, allowing effective operation and control of the machine from the human end.
TextureView
Android component used for rendering video and graphics into the Android UI hierarchy.
File
The named storage location on a computer that stores data, information, or instructions.
Android Devices
| Name | Description | Recording | Power |
|---|---|---|---|
| Sony Xperia XA1 Ultra | Updated to Android 8.0 and latest web browser. | Takes photos and videos on front and back cameras. | USB Type-C 2.0 10W charging |
| Samsung Galaxy S21 FE 5G | Updated to Android 14.0 and default camera application. | Takes photos and videos on front and back cameras. | USB Type-C 2.0 <25W charging |
| Medium PHone API 36 | Android Emulator. | Takes audio, photos and videos on front camera. | N/A |
| Name | Description | Example |
Take Photo
if (null == cameraDevice) {
Log.e(TAG, "cameraDevice is null")
return
}
val manager = getSystemService(CAMERA_SERVICE) as CameraManager
try {
val characteristics = manager.getCameraCharacteristics(
cameraDevice!!.id
)
var jpegSizes: Array<Size>? = null
if (characteristics != null) {
jpegSizes =
characteristics.get(CameraCharacteristics.SCALER_STREAM_CONFIGURATION_MAP)!!
.getOutputSizes(ImageFormat.JPEG)
}
var width = 640
var height = 480
if (jpegSizes != null && 0 < jpegSizes.size) {
width = jpegSizes[0].width
height = jpegSizes[0].height
}
val reader = ImageReader.newInstance(width, height, ImageFormat.JPEG, 1)
val outputSurfaces: MutableList<Surface> = ArrayList(2)
outputSurfaces.add(reader.surface)
outputSurfaces.add(Surface(textureView!!.surfaceTexture))
val captureBuilder =
cameraDevice!!.createCaptureRequest(CameraDevice.TEMPLATE_STILL_CAPTURE)
captureBuilder.addTarget(reader.surface)
captureBuilder.set(CaptureRequest.CONTROL_MODE, CameraMetadata.CONTROL_MODE_AUTO)
// Orientation
val rotation = windowManager.defaultDisplay.rotation
captureBuilder.set(
CaptureRequest.JPEG_ORIENTATION,
ORIENTATIONS[rotation]
)
val file = File(Environment.getExternalStorageDirectory().toString() + "/Download/pic.jpg")
val readerListener: OnImageAvailableListener = object : OnImageAvailableListener {
override fun onImageAvailable(reader: ImageReader) {
var image: Image? = null
try {
image = reader.acquireLatestImage()
val buffer = image.planes[0].buffer
val bytes = ByteArray(buffer.capacity())
buffer[bytes]
save(bytes)
} catch (e: FileNotFoundException) {
e.printStackTrace()
} catch (e: IOException) {
e.printStackTrace()
} finally {
image?.close()
}
}
@Throws(IOException::class)
fun save(bytes: ByteArray?) {
var output: OutputStream? = null
try {
output = FileOutputStream(file)
output.write(bytes)
} finally {
output?.close()
}
}
}
reader.setOnImageAvailableListener(readerListener, mBackgroundHandler)
val captureListener: CaptureCallback = object : CaptureCallback() {
override fun onCaptureCompleted(
session: CameraCaptureSession,
request: CaptureRequest,
result: TotalCaptureResult
) {
super.onCaptureCompleted(session, request, result)
Toast.makeText(this@MainActivity, "Saved:$file", Toast.LENGTH_SHORT).show()
createCameraPreview()
}
}
cameraDevice!!.createCaptureSession(
outputSurfaces,
object : CameraCaptureSession.StateCallback() {
override fun onConfigured(session: CameraCaptureSession) {
try {
session.capture(
captureBuilder.build(),
captureListener,
mBackgroundHandler
)
} catch (e: CameraAccessException) {
e.printStackTrace()
}
}
override fun onConfigureFailed(session: CameraCaptureSession) {
}
},
mBackgroundHandler
)
} catch (e: CameraAccessException) {
e.printStackTrace()
}
Download
The Android SDK tools can be downloaded from SDK Platform Tools and installed on your workstation.
Explanation
- Use the ADB tool to connect to your Android device if applicable.
- Generate an Android Layout XML file as app -> res/xml/activity_main.xml.
- Generate an Android Manifest Permissions of for Camera as app -> manifests/AndroidManifest.xml.
- Generate Android code snippet to show camera preview and a take photo button.
Usage
You can use any IDE or text editor to compile and execute Android code. For this tutorial, Android Studio IDE was used, but it was not needed for coding the camera preview.
Open Source
Kotlin is licensed under the Apache License version 2.0. The permissive license requires the preservation of the copyright notice and disclaimer. It allows commercial use, modification, distribution, and allows making derivatives proprietary, consult the license for more specific details.
Android is licensed under the Apache License version 2.0 for the userspace software and GNU General Public License (GPL) version 2 for the Linux kernel. The permissive license requires the preservation of the copyright notice and disclaimer, while the copyleft license comes with strict rules and requirements to ensure the software remains free and open-source. It allows commercial use, modification, distribution, and allows making derivatives proprietary, consult the license for more specific details.
Conclusion:
The Android Camera2 API can be used by Kotlin to preview the camera. The API is supported in Android versions starting from 5.0. A photo can be taken and saved on the Android device.
You can use an emulator to test the application but a real device is recommended via USB or WiFi connection for debugging.
If you enjoy this article, consider supporting me by purchasing one of my OjamboShop.com Online Programming Courses or publications at Edward Ojambo Programming Books or simply donate here Ojambo.com Donate
References:
- Downloads & Installation Instructions For PHP
- SDK Platform Tools For Android
- Customer Sets Price Plugin for WooCommerce on Ojambo.com
- Learning JavaScript Course on OjamboShop.com
- Learning Python Course on OjamboShop.com
- Learning PHP Course on OjamboShop.com
- Learning JavaScript Paperback on Amazon
- Learning JavaScript Ebook on Amazon
- Learning Python Ebook on Amazon
- Learning PHP Ebook on Amazon
- OjamboServices.com For Custom Websites, Applications & Tutorials