Android

cameraX의 이것 저것



1. 배경

작년 이맘 때 쯤, 카메라를 사용하는 서비스를 운영 했었다.
증명을 위해 여러장의 사진(원본)을 찍어 s3로 올려야하는데 이 부분에서 업로드 지연, 사용자의 네트워크 상태로 인한 실패 등 여러 이슈들이 있었고, 그게 그 당시의 큰 숙제였다.

어떻게 하면 사용자의 불편함을 덜면서 사진을 전송할 수 있을까 고민하고 결과를 낼때쯤.. 프로젝트가 무산되어 결국 제대로 적용해보지 못하고 덮어두었었다.


이번에 위와 결이 비슷한 앱을 개발 검토하게 되면서 작년에 고민했던 것들을 다시 떠올려보았다.
작년과 크게 다른 것은 올려야하는 사진의 수가 두 배 이상이라는 것.

사용자 특성상 ‘찍는 속도’, ‘업로드 속도’가 중요할 것이라고 생각했고,
기존에 사용하던 Intent-startActivityForResult 구조가 아닌, cameraX를 사용하면 사진 촬영에 소요되는 시간을 줄일 수 있지 않을까 싶어 적용을 해봤다.


-) 다른 androidX 라이브러리 처럼 단순히 가져다 쓰면 되지 않을까? 했던 예상과는 다르게,,,,
3A 개념 이해부터 불친절한 camaraX document(모든 예제들이 camara2 및 camaraX 내부가 모두 camara2 기반)까지 생각지 못한 벽이 많아서 여기에 정리해 두고자 한다.




2. 3A 설정

2-1. 3A란?



2-2. 3A값 세팅

AWB, AF, AE 각각의 모드를 명시적으로 바꿀수 있다.
바꿀 수 있는 모든 상태값은 이 링크에서 볼 수 있으며, 대부분 빠른 자동 초점 조절을 위한 AF_MODE_CONTINUOUS_PICTURE을 많이 사용한다.

기존 camera2에서는,
사진을 찍기위해 생성한 captureRequest의 Builder에 set하여 모드를 세팅하면 되었는데,

captureBuilder.set(CaptureRequest.CONTROL_AE_MODE, CaptureRequest.CONTROL_AE_MODE_ON);


cameraX에서는 preview를 선언하기 전 Extender를 사용해서 미리 세팅한다.

// Preview
val previewBuilder = Preview.Builder()

val previewExtender = Camera2Interop.Extender(previewBuilder)
previewExtender.setCaptureRequestOption(
    CaptureRequest.CONTROL_AF_MODE, CaptureRequest.CONTROL_AF_MODE_CONTINUOUS_PICTURE
)

val preview = previewBuilder.setTargetAspectRatio(screenAspectRatio)
    .setTargetRotation(rotation)
    .build()



또한, Extender에 setSessionCaptureCallback 콜백함수를 달아서,
리턴되는 TotalCaptureResult를 통해 3A 상태를 확인할 수 있다.

프로젝트에서는 촬영 가능 상태값을 정의해두고 리턴값에 따라 촬영 버튼의 클릭 가능 여부(enable)를 바꾸어주었다.

previewExtender.setSessionCaptureCallback(object : CameraCaptureSession.CaptureCallback() {
    override fun onCaptureCompleted(
        session: CameraCaptureSession, request: CaptureRequest, result: TotalCaptureResult
    ) {
        super.onCaptureCompleted(session, request, result)

        val afState = result.get(CaptureResult.CONTROL_AF_STATE)
        val aeState = result.get(CaptureResult.CONTROL_AE_STATE)
        val awbState = result.get(CaptureResult.CONTROL_AWB_STATE)
        val lensState = result.get(CaptureResult.LENS_STATE)
        Log.d(
            "TEST",
            "afState : $afState, awbState : $awbState, aeState : $aeState, lensState : $lensState"
        )

        val value = afState == CaptureResult.CONTROL_AF_STATE_PASSIVE_FOCUSED
                && awbState == CaptureRequest.CONTROL_AWB_STATE_CONVERGED
                && lensState == CaptureRequest.LENS_STATE_STATIONARY

        if(value){
            //shutter on
        }else{
            
        }
    }
})




3. 수동 포커스 설정

기본 카메라를 보면, 자동으로 포커스를 잡다가 화면을 터치할 시 해당 위치 포커스가 된다.
이후 3-5초 후, 다시 자동 포커스로 돌아가는 것을 확인할 수 있다.

주의할 점

activityMainBinding.viewFinder.setOnTouchListener { _, event ->
    scaleGestureDetector.onTouchEvent(event)

    if (event.action == MotionEvent.ACTION_DOWN) {
        handler.removeCallbacksAndMessages(null)

        val factory = activityMainBinding.viewFinder.meteringPointFactory
        val point = factory.createPoint(event.x, event.y)
        val action = FocusMeteringAction.Builder(point, FocusMeteringAction.FLAG_AF)
            .setAutoCancelDuration(3, TimeUnit.SECONDS)
            .build()

        /*
        * ref
        * https://groups.google.com/a/android.com/g/camerax-developers/c/h0Q4Al8TXmc
        *
        * AF의 기본 설정은 계속해서 초점을 잡는 'CONTROL_AF_MODE_CONTINUOUS_PICTURE'로 되어있고,
        * startFocusAndMetering() 이 실행되면 위에서 선언한대로
        * '3초'간 'CONTROL_AF_MODE_AUTO'가 되어 클릭한 부분에 수동으로 초점을 맞출 수 있게된다.
        * 3초가 지나면 이전 상태인 'CONTROL_AF_MODE_CONTINUOUS_PICTURE'로 다시 돌아간다.
        */
        camera.cameraControl.startFocusAndMetering(action)
        cameraUiContainerBinding?.ivFocusCircle?.apply {
            visibility = View.VISIBLE
            x = event.x
            y = event.y
        }

        handler.postDelayed({
            cameraUiContainerBinding?.ivFocusCircle?.visibility = View.INVISIBLE
        }, 3000)
    }
    return@setOnTouchListener true
}

FocusMeteringAction를 이용하여 터치한 좌표에 포커스를 잡고,
setAutoCancelDuration를 설정해 주어 3초 후 기본상태로 돌아가도록 한다.
또한, ivFocusCircle 이미지뷰를 만들어서 해당 위치를 명시적으로 보이게 해준다.



3. 코드

전체 코드는 여기서 볼 수 있다.

Discussion and feedback