Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

카메라 렌즈 및 기능

참고: 이 페이지에서는 Camera2 패키지를 다룹니다. 앱에 Camera2의 특정 하위 수준 기능이 필요하지 않다면 CameraX를 사용하는 것이 좋습니다. CameraX와 Camera2는 모두 Android 5.0(API 수준 21) 이상을 지원합니다.

많은 최신 Android 기기에는 기기의 전면, 후면 또는 양면에 두 개 이상의 카메라가 있습니다. 각 렌즈는 연속 촬영, 수동 제어, 모션 추적과 같은 고유한 기능을 가질 수 있습니다. 수표를 입금하는 앱은 첫 번째 후면 카메라만 사용할 수 있지만 소셜 미디어 앱은 전면 카메라를 기본으로 사용하면서 사용자가 사용 가능한 모든 렌즈 간에 전환할 수 있는 옵션을 제공할 수 있습니다. 또한 사용자의 선택을 기억할 수 있습니다.

이 페이지에서는 카메라 렌즈와 그 기능을 나열하여 특정 상황에서 사용할 렌즈를 앱 내에서 결정하는 방법을 설명합니다. 다음 코드 스니펫은 모든 카메라 목록을 가져와 반복합니다.

try {
    val cameraIdList = cameraManager.cameraIdList // may be empty

    // iterate over available camera devices.
    for (cameraId in cameraIdList) {
        val characteristics = cameraManager.getCameraCharacteristics(cameraId)
        val cameraLensFacing = characteristics.get(CameraCharacteristics.LENS_FACING)
        val cameraCapabilities = characteristics.get(CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES)

        // check if the selected camera device supports basic features
        // ensures backward compatibility with the original Camera API.
        val isBackwardCompatible = cameraCapabilities?.contains(
            CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE
        ) ?: false
        // ...
    }
} catch (e: CameraAccessException) {
    e.message?.let { Log.e(TAG, it) }
    // ...
}CameraEnumeration.kt

cameraLensFacing 변수는 기기 화면을 기준으로 카메라가 향하는 방향을 설명하며 다음 값 중 하나를 가집니다.

렌즈 방향 구성에 관한 자세한 내용은 CameraCharacteristics.LENS_FACING을 참고하세요.

이전 코드 샘플의 cameraCapabilities 변수에는 카메라가 표준 프레임을 출력으로 생성할 수 있는지 여부(예: 깊이 센서 데이터만 생성하는 경우와 반대)를 비롯한 기타 기능에 관한 정보가 포함되어 있습니다. CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE가 카메라의 나열된 기능 중 하나인지 확인할 수 있습니다. 이 기능은 isBackwardCompatible에 플래그로 저장됩니다.

합리적인 기본값 선택

앱에서 기본적으로 특정 카메라를 열 수 있습니다(사용 가능한 경우). 예를 들어 셀카 앱은 전면 카메라를 열고 증강 현실 앱은 후면 카메라로 시작할 수 있습니다. 다음 함수는 지정된 방향을 향하는 첫 번째 카메라를 반환합니다.

fun getFirstCameraIdFacing(
    cameraManager: CameraManager,
    facing: Int = CameraMetadata.LENS_FACING_BACK
): String? {
    try {
        // Get list of all compatible cameras.
        val cameraIds = cameraManager.cameraIdList.filter {
            val characteristics = cameraManager.getCameraCharacteristics(it)
            val capabilities = characteristics.get(CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES)
            capabilities?.contains(
                CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE
            ) ?: false
        }

        // Iterate over the list of cameras and return the first one matching desired
        // lens-facing configuration.
        cameraIds.forEach {
            val characteristics = cameraManager.getCameraCharacteristics(it)
            if (characteristics.get(CameraCharacteristics.LENS_FACING) == facing) {
                return it
            }
        }

        // If no camera matched desired orientation, return the first one from the list.
        return cameraIds.firstOrNull()
    } catch (e: CameraAccessException) {
        e.message?.let { Log.e(TAG, it) }
        return null
    }
}CameraEnumeration.kt

카메라 전환 사용 설정

많은 카메라 앱은 사용자에게 카메라 간에 전환할 수 있는 옵션을 제공합니다.

카메라 전환 버튼이 표시된 Google 카메라 앱 인터페이스 — **그림 1.** Google 카메라 앱의 카메라 전환 버튼

많은 기기에는 같은 방향을 향하는 카메라가 여러 개 있습니다. 일부 기기에는 외장 USB 카메라도 있습니다. 사용자에게 다양한 방향의 카메라 간에 전환할 수 있는 UI를 제공하려면 가능한 각 렌즈 방향 구성에 사용 가능한 첫 번째 카메라를 선택합니다.

다음 카메라를 선택하는 보편적인 로직은 없지만 다음 코드는 대부분의 사용 사례에서 작동합니다.

fun filterCompatibleCameras(
    cameraIds: Array<String>,
    cameraManager: CameraManager
): List<String> {
    return cameraIds.filter {
        val characteristics = cameraManager.getCameraCharacteristics(it)
        characteristics.get(CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES)?.contains(
            CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE
        ) ?: false
    }
}

fun filterCameraIdsFacing(
    cameraIds: List<String>,
    cameraManager: CameraManager,
    facing: Int
): List<String> {
    return cameraIds.filter {
        val characteristics = cameraManager.getCameraCharacteristics(it)
        characteristics.get(CameraCharacteristics.LENS_FACING) == facing
    }
}

fun getNextCameraId(cameraManager: CameraManager, currCameraId: String? = null): String? {
    // Get all front, back and external cameras in 3 separate lists.
    val cameraIds = filterCompatibleCameras(cameraManager.cameraIdList, cameraManager)
    val backCameras = filterCameraIdsFacing(
        cameraIds, cameraManager, CameraMetadata.LENS_FACING_BACK
    )
    val frontCameras = filterCameraIdsFacing(
        cameraIds, cameraManager, CameraMetadata.LENS_FACING_FRONT
    )
    val externalCameras = filterCameraIdsFacing(
        cameraIds, cameraManager, CameraMetadata.LENS_FACING_EXTERNAL
    )

    // The recommended order of iteration is: all external, first back, first front.
    val allCameras = (
        externalCameras + listOf(
            backCameras.firstOrNull(), frontCameras.firstOrNull()
        )
        ).filterNotNull()

    // Get the index of the currently selected camera in the list.
    val cameraIndex = allCameras.indexOf(currCameraId)

    // The selected camera may not be in the list, for example it could be an
    // external camera that has been removed by the user.
    return if (cameraIndex == -1) {
        // Return the first camera from the list.
        allCameras.getOrNull(0)
    } else {
        // Return the next camera from the list, wrap around if necessary.
        allCameras.getOrNull((cameraIndex + 1) % allCameras.size)
    }
}CameraEnumeration.kt

이 코드는 다양한 구성의 여러 기기에서 작동합니다. 극단적인 사례를 고려하는 방법에 관한 자세한 내용은 CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_LOGICAL_MULTI_CAMERA를 참고하세요.

호환되는 앱 만들기

지원 중단된 Camera API를 계속 사용하는 앱의 경우 Camera.getNumberOfCameras()에서 반환하는 카메라 수는 OEM 구현에 따라 다릅니다. 시스템에 논리 다중 카메라가 있는 경우 앱 하위 호환성을 유지하기 위해 이 메서드는 모든 논리 카메라 및 기본 실제 카메라 그룹에 대해 하나의 카메라만 노출합니다. 모든 카메라를 보려면 Camera2 API를 사용하세요.

카메라 방향에 관한 자세한 내용은 Camera.CameraInfo.orientation를 참고하세요.

일반적으로 Camera.getCameraInfo() API를 사용하여 모든 카메라 orientation를 쿼리하고 카메라를 전환하는 사용자에게 사용 가능한 각 방향에 대해 하나의 카메라만 노출합니다.

모든 기기 유형 수용

앱이 항상 카메라가 한두 개 있는 휴대기기에서 실행된다고 가정하지 마세요. 대신 앱에 가장 적합한 카메라를 선택합니다. 특정 카메라가 필요하지 않은 경우 선택한 방향을 향하는 첫 번째 카메라를 선택합니다. 특정 방향을 향하는 카메라를 사용할 수 없는 경우 사용자가 다른 카메라로 여정을 완료할 수 있는지 고려합니다. 카메라 하드웨어를 기반으로 특정 기기에서 앱의 사용 가능 여부를 제한하지 마세요. 외부 카메라가 연결되어 있으면 사용자는 이를 기본값으로 선호할 가능성이 높습니다.

카메라 렌즈 및 기능 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

합리적인 기본값 선택

카메라 전환 사용 설정

호환되는 앱 만들기

모든 기기 유형 수용

카메라 렌즈 및 기능