참고: 이 페이지에서는 Camera2 패키지에 관해 다룹니다. 앱에 Camera2의 특정 하위 수준 기능이 필요한 경우가 아니라면 CameraX를 사용하는 것이 좋습니다. CameraX와 Camera2는 모두 Android 5.0(API 수준 21) 이상을 지원합니다.
Camera2는 기기 제조업체가 다양한 Android 기기에 구현한 확장 프로그램에 액세스하기 위한 확장 프로그램 API를 제공합니다. 지원되는 확장 프로그램 모드 목록은 카메라 확장 프로그램을 참고하세요.
확장 프로그램을 지원하는 기기 목록은 지원되는 기기를 참고하세요.
확장 프로그램 아키텍처
다음 이미지는 카메라 확장 프로그램 아키텍처를 보여줍니다.
Camera2 애플리케이션은 Camera2 API를 통해 확장 프로그램을 사용할 수 있습니다. Camera2 API는 사용 가능한 확장 프로그램을 쿼리하고 확장 프로그램 카메라 세션을 구성하며 Camera Extensions OEM 라이브러리와 통신하는 방법을 제공합니다. 이렇게 하면 애플리케이션에서 야간, HDR, 자동, 빛망울 효과, 얼굴 보정과 같은 확장 프로그램을 사용할 수 있습니다.
Camera2 Extensions API 호환성을 위해 카메라 기기 테스트
다음 코드 스니펫은 기기가 Camera2 Extensions API를 지원하는지 확인합니다. 확장 프로그램이 모든 기기에서 지원되지는 않거나 기기에서 확장 프로그램의 하위 집합을 지원할 수 있습니다. 스니펫은 카메라 확장 프로그램을 지원하는 호환되는 카메라 ID 목록을 반환합니다.
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();
}
}
Camera2 Extensions API로 CameraExtensionSession 만들기
Camera2 Extensions API를 호환되는 기기와 함께 사용하면 특정 카메라 확장 프로그램에 액세스할 수 있습니다. 다음 코드 스니펫은 기존 Camera2 애플리케이션에 야간 캡처 모드를 사용하기 위한 CameraExtensionSession를 만드는 방법의 예를 보여줍니다.
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
);
}
추가 리소스
자세한 내용은 CameraExtensionCharacteristics를 참고하고 공개 Camera2 Extensions API 샘플을 확인하세요.