Lưu ý: Trang này đề cập đến gói Camera2. Trừ phi ứng dụng của bạn yêu cầu các tính năng cụ thể ở cấp độ thấp từ Camera2, bạn nên sử dụng CameraX. Cả CameraX và Camera2 đều hỗ trợ Android 5.0 (API cấp 21) trở lên.
Camera2 cung cấp API Extensions dùng cho việc truy cập vào các tiện ích mà nhà sản xuất thiết bị đã triển khai trên nhiều thiết bị Android. Để biết danh sách các chế độ được hỗ trợ của tiện ích, hãy xem bài viết Tiện ích dành cho máy ảnh.
Để biết danh sách các thiết bị hỗ trợ tiện ích, hãy xem bài viết Thiết bị được hỗ trợ.
Cấu trúc tiện ích
Hình ảnh sau đây cho thấy cấu trúc của các tiện ích máy ảnh.
Ứng dụng Camera2 có thể sử dụng các tiện ích thông qua API Camera2. Camera2 API cung cấp cách truy vấn các tiện ích có sẵn, định cấu hình tiện ích phiên camera và giao tiếp với thư viện OEM Tiện ích máy ảnh. Chiến dịch này cho phép ứng dụng của bạn sử dụng các tiện ích như Ban đêm, HDR, Tự động, Bokeh hoặc Làm đẹp khuôn mặt.
Kiểm thử thiết bị máy ảnh để biết khả năng tương thích của Camera2 Extensions API
Đoạn mã sau đây kiểm tra xem thiết bị có hỗ trợ Camera2 hay không API Extensions. Không phải thiết bị nào cũng hỗ trợ các tiện ích hoặc thiết bị có thể hỗ trợ một nhóm nhỏ tiện ích. Đoạn mã trả về danh sách mã máy ảnh tương thích có hỗ trợ các tiện ích máy ảnh.
Kotlin
private fun getExtensionCameraIds(cameraManager: CameraManager): List<String> =
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
cameraManager.cameraIdList.filter { cameraId ->
val characteristics = cameraManager.getCameraCharacteristics(cameraId)
val extensionCharacteristics =
cameraManager.getCameraExtensionCharacteristics(cameraId)
val capabilities =
characteristics.get(CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES)
extensionCharacteristics.supportedExtensions.isNotEmpty() &&
capabilities?.contains(
CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE
) ?: false
}
} else emptyList()
Java
private List<String> getExtensionCameraIds(CameraManager cameraManager)
throws CameraAccessException {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
return Arrays.stream(cameraManager.getCameraIdList()).filter(cameraId -> {
try {
CameraCharacteristics characteristics =
cameraManager.getCameraCharacteristics(cameraId);
CameraExtensionCharacteristics extensionCharacteristics =
cameraManager.getCameraExtensionCharacteristics(cameraId);
IntStream capabilities =
Arrays.stream(
characteristics.get(
CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES
)
);
return !extensionCharacteristics.getSupportedExtensions().isEmpty() &&
capabilities.anyMatch(capability -> capability == CameraCharacteristics
.REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE
);
} catch (CameraAccessException e) {
throw new RuntimeException(e);
}
}).collect(Collectors.toList());
} else {
return Collections.emptyList();
}
}
Tạo CameraExtensionSession bằng Camera2 Extensions API
Camera2 Extensions API (API Tiện ích Camera2) khi được dùng với các thiết bị tương thích, cho phép bạn truy cập
một số tiện ích máy ảnh nhất định. Đoạn mã sau đây cho thấy một ví dụ về
cách tạo CameraExtensionSession
để dùng chế độ chụp đêm cho ứng dụng Camera2 hiện có.
Kotlin
private val captureCallbacks = object : CameraExtensionSession.ExtensionCaptureCallback() {
// Implement Capture Callbacks
}
private val extensionSessionStateCallback = object : CameraExtensionSession.StateCallback() {
override fun onConfigured(session: CameraExtensionSession) {
cameraExtensionSession = session
try {
val captureRequest =
cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW).apply {
addTarget(previewSurface)
}.build()
session.setRepeatingRequest(
captureRequest,
Dispatchers.IO.asExecutor(),
captureCallbacks
)
} catch (e: CameraAccessException) {
Snackbar.make(
previewView,
"Failed to preview capture request",
Snackbar.LENGTH_SHORT
).show()
requireActivity().finish()
}
}
override fun onClosed(session: CameraExtensionSession) {
super.onClosed(session)
cameraDevice.close()
}
override fun onConfigureFailed(session: CameraExtensionSession) {
Snackbar.make(
previewView,
"Failed to start camera extension preview",
Snackbar.LENGTH_SHORT
).show()
requireActivity().finish()
}
}
private fun startExtensionSession() {
val outputConfig = arrayListOf(
OutputConfiguration(stillImageReader.surface),
OutputConfiguration(previewSurface)
)
val extensionConfiguration = ExtensionSessionConfiguration(
CameraExtensionCharacteristics.EXTENSION_NIGHT,
outputConfig,
Dispatchers.IO.asExecutor(),
extensionSessionStateCallback
)
cameraDevice.createExtensionSession(extensionConfiguration)
}
Java
private CameraExtensionSession.ExtensionCaptureCallback captureCallbacks =
new CameraExtensionSession.ExtensionCaptureCallback() {
// Implement Capture Callbacks
};
private CameraExtensionSession.StateCallback extensionSessionStateCallback =
new CameraExtensionSession.StateCallback() {
@Override
public void onConfigured(@NonNull CameraExtensionSession session) {
cameraExtensionSession = session;
try {
CaptureRequest.Builder captureRequestBuilder =
cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW);
captureRequestBuilder.addTarget(previewSurface);
CaptureRequest captureRequest = captureRequestBuilder.build();
session.setRepeatingRequest(captureRequest, backgroundExecutor, captureCallbacks);
} catch (CameraAccessException e) {
Snackbar.make(
previewView,
"Failed to preview capture request",
Snackbar.LENGTH_SHORT
).show();
requireActivity().finish();
}
}
@Override
public void onClosed(@NonNull CameraExtensionSession session) {
super.onClosed(session);
cameraDevice.close();
}
@Override
public void onConfigureFailed(@NonNull CameraExtensionSession session) {
Snackbar.make(
previewView,
"Failed to start camera extension preview",
Snackbar.LENGTH_SHORT
).show();
requireActivity().finish();
}
};
private void startExtensionSession() {
ArrayList<OutputConfiguration> outputConfig = new ArrayList<>();
outputConfig.add(new OutputConfiguration(stillImageReader.getSurface()));
outputConfig.add(new OutputConfiguration(previewSurface));
ExtensionSessionConfiguration extensionConfiguration = new ExtensionSessionConfiguration(
CameraExtensionCharacteristics.EXTENSION_NIGHT,
outputConfig,
backgroundExecutor,
extensionSessionStateCallback
);
}
Tài nguyên khác
Để biết thêm thông tin, hãy xem
CameraExtensionCharacteristics
và xem các mẫu công khai của CameraX Extensions API
để tìm hiểu thêm.