[BOOK-491] feat: 텍스트 인식 실패 케이스 처리

seoyoon513 · seoyoon513 · commit ef0c3001b7df · 2026-01-21T22:25:07.000+09:00
diff --git a/feature/record/src/main/kotlin/com/ninecraft/booket/feature/record/ocr/OcrPresenter.kt b/feature/record/src/main/kotlin/com/ninecraft/booket/feature/record/ocr/OcrPresenter.kt
@@ -2,6 +2,7 @@ package com.ninecraft.booket.feature.record.ocr
 
 import android.net.Uri
 import androidx.compose.runtime.Composable
+import androidx.compose.runtime.LaunchedEffect
 import androidx.compose.runtime.getValue
 import androidx.compose.runtime.mutableStateOf
 import androidx.compose.runtime.rememberCoroutineScope
@@ -27,6 +28,7 @@ import kotlinx.collections.immutable.persistentListOf
 import kotlinx.collections.immutable.persistentSetOf
 import kotlinx.collections.immutable.toPersistentList
 import kotlinx.collections.immutable.toPersistentSet
+import kotlinx.coroutines.delay
 import kotlinx.coroutines.launch
 
 @AssistedInject
@@ -44,6 +46,7 @@ class OcrPresenter(
 
     companion object {
         private const val RECORD_OCR_SENTENCE = "record_OCR_sentence"
+        private const val CAMERA_MAX_FAILURES = 2
     }
 
     @Composable
@@ -56,11 +59,53 @@ class OcrPresenter(
         var selectedIndices by rememberRetained { mutableStateOf(persistentSetOf<Int>()) }
         var mergedSentence by rememberRetained { mutableStateOf("") }
         var isTextDetectionFailed by rememberRetained { mutableStateOf(false) }
+        var isCameraRecognitionFailedDialogVisible by rememberRetained { mutableStateOf(false) }
+        var isGalleryRecognitionFailedDialogVisible by rememberRetained { mutableStateOf(false) }
         var isRecaptureDialogVisible by rememberRetained { mutableStateOf(false) }
         var isLoading by rememberRetained { mutableStateOf(false) }
         var sideEffect by rememberRetained { mutableStateOf<OcrSideEffect?>(null) }
 
-        fun recognizeText(imageUri: Uri) {
+        var cameraFailureCount by rememberRetained { mutableStateOf(0) }
+
+        LaunchedEffect(isTextDetectionFailed) {
+            if (isTextDetectionFailed) {
+                delay(2000)
+                isTextDetectionFailed = false
+            }
+        }
+
+        fun handleRecognitionSuccess(text: String) {
+            isTextDetectionFailed = false
+            cameraFailureCount = 0
+
+            val sentences = text
+                .split("\n")
+                .map { it.trim() }
+                .filter { it.isNotEmpty() }
+
+            sentenceList = sentences.toPersistentList()
+            currentUi = OcrUi.RESULT
+            analyticsHelper.logScreenView(RECORD_OCR_SENTENCE)
+        }
+
+        fun handleRecognitionFailure(source: RecognizeSource) {
+            when (source) {
+                RecognizeSource.CAMERA -> {
+                    isTextDetectionFailed = true
+                    cameraFailureCount += 1
+
+                    if (cameraFailureCount >= CAMERA_MAX_FAILURES) {
+                        isCameraRecognitionFailedDialogVisible = true
+                    }
+                }
+
+                RecognizeSource.GALLERY -> {
+                    isGalleryRecognitionFailedDialogVisible = true
+                }
+            }
+        }
+
+        fun recognizeText(imageUri: Uri, source: RecognizeSource) {
             scope.launch {
                 try {
                     isLoading = true
@@ -69,21 +114,13 @@ class OcrPresenter(
                             val text = it.responses.firstOrNull()?.fullTextAnnotation?.text.orEmpty()
 
                             if (text.isNotBlank()) {
-                                isTextDetectionFailed = false
-                                val sentences = text
-                                    .split("\n")
-                                    .map { it.trim() }
-                                    .filter { it.isNotEmpty() }
-
-                                sentenceList = sentences.toPersistentList()
-                                currentUi = OcrUi.RESULT
-                                analyticsHelper.logScreenView(RECORD_OCR_SENTENCE)
+                                handleRecognitionSuccess(text)
                             } else {
-                                isTextDetectionFailed = true
+                                handleRecognitionFailure(source)
                             }
                         }
                         .onFailure { exception ->
-                            isTextDetectionFailed = true
+                            handleRecognitionFailure(source)
 
                             val handleErrorMessage = { message: String ->
                                 Logger.e("Cloud Vision API Error: ${exception.message}")
@@ -128,16 +165,20 @@ class OcrPresenter(
 
                 is OcrUiEvent.OnImageCaptured -> {
                     isTextDetectionFailed = false
+                    isCameraRecognitionFailedDialogVisible = false
+                    isGalleryRecognitionFailedDialogVisible = false
 
-                    recognizeText(event.imageUri)
+                    recognizeText(event.imageUri, RecognizeSource.CAMERA)
                 }
 
                 is OcrUiEvent.OnImageSelected -> {
                     currentUi = OcrUi.IMAGE
                     selectedImage = event.imageUri
+                    isTextDetectionFailed = false
+                    isGalleryRecognitionFailedDialogVisible = false
 
                     val pareUri = selectedImage.toUri()
-                    recognizeText(pareUri)
+                    recognizeText(pareUri, RecognizeSource.GALLERY)
                 }
 
                 is OcrUiEvent.OnReCaptureButtonClick -> {
@@ -168,9 +209,17 @@ class OcrPresenter(
                     isRecaptureDialogVisible = false
                 }
 
-                OcrUiEvent.OnImageViewClosed -> {
+                OcrUiEvent.OnImageContentClosed -> {
                     currentUi = OcrUi.CAMERA
                 }
+
+                OcrUiEvent.OnCameraRecognitionFailedDialogDismissed -> {
+                    isCameraRecognitionFailedDialogVisible = false
+                }
+
+                OcrUiEvent.OnImageRecognitionFailedDialogDismissed -> {
+                    isGalleryRecognitionFailedDialogVisible = false
+                }
             }
         }
 
@@ -185,6 +234,8 @@ class OcrPresenter(
             sentenceList = sentenceList,
             selectedIndices = selectedIndices,
             isTextDetectionFailed = isTextDetectionFailed,
+            isCameraRecognitionFailedDialogVisible = isCameraRecognitionFailedDialogVisible,
+            isGalleryRecognitionFailedDialogVisible = isGalleryRecognitionFailedDialogVisible,
             isRecaptureDialogVisible = isRecaptureDialogVisible,
             isLoading = isLoading,
             sideEffect = sideEffect,
diff --git a/feature/record/src/main/kotlin/com/ninecraft/booket/feature/record/ocr/OcrUiState.kt b/feature/record/src/main/kotlin/com/ninecraft/booket/feature/record/ocr/OcrUiState.kt
@@ -35,7 +35,7 @@ sealed interface OcrSideEffect {
 
 sealed interface OcrUiEvent : CircuitUiEvent {
     data object OnCloseClick : OcrUiEvent
-    data object OnImageViewClosed : OcrUiEvent
+    data object OnImageContentClosed : OcrUiEvent
     data object OnShowPermissionDialog : OcrUiEvent
     data object OnHidePermissionDialog : OcrUiEvent
     data object OnCaptureStart : OcrUiEvent
@@ -46,6 +46,8 @@ sealed interface OcrUiEvent : CircuitUiEvent {
     data object OnSelectionConfirmed : OcrUiEvent
     data object OnRecaptureDialogConfirmed : OcrUiEvent
     data object OnRecaptureDialogDismissed : OcrUiEvent
+    data object OnCameraRecognitionFailedDialogDismissed : OcrUiEvent
+    data object OnImageRecognitionFailedDialogDismissed : OcrUiEvent
     data class OnSentenceSelected(val index: Int) : OcrUiEvent
 }
 
@@ -54,3 +56,8 @@ enum class OcrUi {
     IMAGE,
     RESULT,
 }
+
+enum class RecognizeSource {
+    CAMERA,
+    GALLERY,
+}
diff --git a/feature/record/src/main/kotlin/com/ninecraft/booket/feature/record/ocr/content/OcrCameraContent.kt b/feature/record/src/main/kotlin/com/ninecraft/booket/feature/record/ocr/content/OcrCameraContent.kt
@@ -301,7 +301,9 @@ internal fun OcrCameraContent(
                 state.eventSink(OcrUiEvent.OnCloseClick)
             },
             dismissButtonText = stringResource(R.string.ocr_recognition_failed_dialog_camera),
-            onDismissRequest = {},
+            onDismissRequest = {
+                state.eventSink(OcrUiEvent.OnCameraRecognitionFailedDialogDismissed)
+            },
         )
     }
 }
diff --git a/feature/record/src/main/kotlin/com/ninecraft/booket/feature/record/ocr/content/OcrImageContent.kt b/feature/record/src/main/kotlin/com/ninecraft/booket/feature/record/ocr/content/OcrImageContent.kt
@@ -1,5 +1,8 @@
 package com.ninecraft.booket.feature.record.ocr.content
 
+import androidx.activity.compose.rememberLauncherForActivityResult
+import androidx.activity.result.PickVisualMediaRequest
+import androidx.activity.result.contract.ActivityResultContracts
 import androidx.compose.foundation.background
 import androidx.compose.foundation.layout.Box
 import androidx.compose.foundation.layout.Column
@@ -33,6 +36,15 @@ internal fun OcrImageContent(
     state: OcrUiState,
     modifier: Modifier = Modifier,
 ) {
+    val photoPickerLauncher = rememberLauncherForActivityResult(
+        contract = ActivityResultContracts.PickVisualMedia(),
+        onResult = { uri ->
+            if (uri != null) {
+                state.eventSink(OcrUiEvent.OnImageSelected(uri.toString()))
+            }
+        },
+    )
+
     ReedScaffold(
         modifier = modifier.fillMaxSize(),
         containerColor = Neutral950,
@@ -47,7 +59,7 @@ internal fun OcrImageContent(
                     .background(color = Color.Black),
                 isDark = true,
                 onClose = {
-                    state.eventSink(OcrUiEvent.OnImageViewClosed)
+                    state.eventSink(OcrUiEvent.OnImageContentClosed)
                 },
             )
             Box(
@@ -89,8 +101,11 @@ internal fun OcrImageContent(
             },
             dismissButtonText = stringResource(R.string.ocr_recognition_failed_dialog_image),
             onDismissRequest = {
-                // 갤러리 열기
-            }
+                state.eventSink(OcrUiEvent.OnImageRecognitionFailedDialogDismissed)
+                photoPickerLauncher.launch(
+                    PickVisualMediaRequest(ActivityResultContracts.PickVisualMedia.ImageOnly),
+                )
+            },
         )
     }
 }
diff --git a/feature/record/src/main/res/values/strings.xml b/feature/record/src/main/res/values/strings.xml
@@ -53,7 +53,7 @@
     <string name="emotion_edit_dialog_description">기록된 감정이 삭제됩니다.</string>
     <string name="ocr_recognition_failed_dialog_title">문장을 인식하지 못했어요</string>
     <string name="ocr_recognition_failed_dialog_description">직접 문장을 입력하시겠어요?</string>
-    <string name="ocr_recognition_failed_dialog_direct_input">직접 촬영하기</string>
+    <string name="ocr_recognition_failed_dialog_direct_input">직접 입력하기</string>
     <string name="ocr_recognition_failed_dialog_camera">다시 촬영하기</string>
     <string name="ocr_recognition_failed_dialog_image">이미지 선택하기</string>
 </resources>

Original file line number	Diff line number	Diff line change
`@@ -301,7 +301,9 @@ internal fun OcrCameraContent(`
`301`	`301`	`state.eventSink(OcrUiEvent.OnCloseClick)`
`302`	`302`	`},`
`303`	`303`	`dismissButtonText = stringResource(R.string.ocr_recognition_failed_dialog_camera),`
`304`		`- onDismissRequest = {},`
	`304`	`+ onDismissRequest = {`
	`305`	`+ state.eventSink(OcrUiEvent.OnCameraRecognitionFailedDialogDismissed)`
	`306`	`+ },`
`305`	`307`	`)`
`306`	`308`	`}`
`307`	`309`	`}`