feat: OCR 모듈 구성, 화면 및 기능 연동

app/build.gradle.kts

@@ -46,6 +46,7 @@ dependencies {
         projects.core.model,
         projects.core.network,
         projects.core.ui,
+        projects.core.ocr,
 
         projects.feature.home,
         projects.feature.library,

app/src/main/AndroidManifest.xml

@@ -2,7 +2,12 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
     xmlns:tools="http://schemas.android.com/tools">
 
+    <uses-feature
+        android:name="android.hardware.camera"
+        android:required="false" />
+
     <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.CAMERA" />
 
     <application
         android:name=".BooketApplication"

core/ocr/.gitignore

@@ -0,0 +1 @@
+/build

core/ocr/build.gradle.kts

@@ -0,0 +1,19 @@
+@file:Suppress("INLINE_FROM_HIGHER_PLATFORM")
+
+plugins {
+    alias(libs.plugins.booket.android.library)
+    alias(libs.plugins.booket.android.hilt)
+}
+
+android {
+    namespace = "com.ninecraft.booket.core.ocr"
+}
+
+dependencies {
+    implementations(
+        libs.logger,
+        libs.androidx.camera.core,
+
+        libs.google.mlkit.text.recognition.korean,
+    )
+}

core/ocr/src/main/kotlin/com/ninecraft/booket/core/ocr/analyzer/LiveTextAnalyzer.kt

@@ -0,0 +1,75 @@
+package com.ninecraft.booket.core.ocr.analyzer
+
+import androidx.annotation.OptIn
+import androidx.camera.core.ExperimentalGetImage
+import androidx.camera.core.ImageProxy
+import com.google.mlkit.vision.common.InputImage
+import com.google.mlkit.vision.text.TextRecognizer
+import com.orhanobut.logger.Logger
+import dagger.assisted.Assisted
+import dagger.assisted.AssistedFactory
+import dagger.assisted.AssistedInject
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.SupervisorJob
+import kotlinx.coroutines.delay
+import kotlinx.coroutines.launch
+import kotlin.coroutines.resume
+import kotlin.coroutines.suspendCoroutine
+
+/**
+ * 실시간 카메라 스트림에서 프레임 단위로 텍스트 분석하는 Analyzer 클래스
+ *
+ * ML Kit의 TextRecognizer를 사용하여 `ImageProxy` 객체로부터 텍스트를 추출한다
+ *
+ * @param textRecognizer ML Kit의 TextRecognizer 인스턴스
+ * @param onTextDetected 텍스트 인식 성공 시 호출되는 콜백 (인식된 전체 텍스트 전달)
+ *
+ * 안정적인 연속 프레임 분석을 위해 CoroutineScope에 [SupervisorJob]을 사용하여
+ * 한 프레임 분석에서 예외가 발생해도 다음 프레임 분석에 영향을 주지 않도록 설계
+ */
+class LiveTextAnalyzer @AssistedInject constructor(
+    private val textRecognizer: TextRecognizer,
+    @Assisted private val onTextDetected: (String) -> Unit,
+) : TextAnalyzer {
+
+    companion object {
+        const val THROTTLE_TIMEOUT_MS = 1_000L // 프레임 처리 간 인터벌
+    }
+
+    private val scope = CoroutineScope(Dispatchers.IO + SupervisorJob())
+
+    @OptIn(ExperimentalGetImage::class)
+    override fun analyze(imageProxy: ImageProxy) {
+        scope.launch {
+            val mediaImage = imageProxy.image ?: run { imageProxy.close(); return@launch }
+            val inputImage = InputImage.fromMediaImage(mediaImage, imageProxy.imageInfo.rotationDegrees)
+
+            suspendCoroutine { continuation ->
+                textRecognizer.process(inputImage)
+                    .addOnCompleteListener { visionText ->
+                        onTextDetected(visionText.result.text)
+                    }
+                    .addOnFailureListener { exception ->
+                        Logger.e(exception.message ?: "Unknown error")
+                    }
+                    .addOnCompleteListener {
+                        continuation.resume(Unit)
+                    }
+            }
+            delay(THROTTLE_TIMEOUT_MS)
+        }.invokeOnCompletion { exception ->
+            if (exception != null) {
+                Logger.e(exception.message ?: "Unknown error")
+            }
+            imageProxy.close()
+        }
+    }
+
+    @AssistedFactory
+    interface Factory {
+        fun create(
+            onTextDetected: (String) -> Unit,
+        ): LiveTextAnalyzer
+    }
+}

core/ocr/src/main/kotlin/com/ninecraft/booket/core/ocr/analyzer/StillTextAnalyzer.kt

@@ -0,0 +1,70 @@
+package com.ninecraft.booket.core.ocr.analyzer
+
+import androidx.annotation.OptIn
+import androidx.camera.core.ExperimentalGetImage
+import androidx.camera.core.ImageProxy
+import com.google.mlkit.vision.common.InputImage
+import com.google.mlkit.vision.text.TextRecognizer
+import com.orhanobut.logger.Logger
+import dagger.assisted.Assisted
+import dagger.assisted.AssistedFactory
+import dagger.assisted.AssistedInject
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.launch
+import kotlin.coroutines.resume
+import kotlin.coroutines.suspendCoroutine
+
+/**
+ * 정적인 카메라 이미지에서 텍스트를 분석하는 클래스
+ *
+ * CameraX의 단일 ImageProxy 프레임을 받아 ML Kit을 통해 텍스트를 추출하고 결과를 콜백으로 전달한다.
+ *
+ * @param textRecognizer ML Kit의 TextRecognizer 인스턴스
+ * @param onTextDetected 텍스트 인식 성공 시 호출되는 콜백 (인식된 전체 텍스트 전달)
+ * @param onFailure 인식 실패 시 호출되는 콜백
+ *
+ * 분석이 끝난 후 반드시 imageProxy.close() 호출하여 리소스 해제
+ */
+class StillTextAnalyzer @AssistedInject constructor(
+    private val textRecognizer: TextRecognizer,
+    @Assisted private val onTextDetected: (String) -> Unit,
+    @Assisted private val onFailure: () -> Unit,
+) : TextAnalyzer {
+
+    val scope = CoroutineScope(Dispatchers.IO)
+
+    @OptIn(ExperimentalGetImage::class)
+    override fun analyze(imageProxy: ImageProxy) {
+        scope.launch {
+            val mediaImage = imageProxy.image ?: run { imageProxy.close(); return@launch }
+            val inputImage = InputImage.fromMediaImage(mediaImage, imageProxy.imageInfo.rotationDegrees)
+
+            suspendCoroutine { continuation ->
+                textRecognizer.process(inputImage)
+                    .addOnCompleteListener { visionText ->
+                        onTextDetected(visionText.result.text)
+                    }
+                    .addOnFailureListener {
+                        onFailure()
+                    }
+                    .addOnCompleteListener {
+                        continuation.resume(Unit)
+                    }
+            }
+        }.invokeOnCompletion { exception ->
+            if (exception != null) {
+                Logger.e(exception.message ?: "Unknown error")
+            }
+            imageProxy.close()
+        }
+    }
+
+    @AssistedFactory
+    interface Factory {
+        fun create(
+            onTextDetected: (String) -> Unit,
+            onFailure: () -> Unit,
+        ): StillTextAnalyzer
+    }
+}

core/ocr/src/main/kotlin/com/ninecraft/booket/core/ocr/analyzer/TextAnalyzer.kt

@@ -0,0 +1,7 @@
+package com.ninecraft.booket.core.ocr.analyzer
+
+import androidx.camera.core.ImageProxy
+
+interface TextAnalyzer {
+    fun analyze(imageProxy: ImageProxy)
+}

core/ocr/src/main/kotlin/com/ninecraft/booket/core/ocr/di/OcrModule.kt

@@ -0,0 +1,20 @@
+package com.ninecraft.booket.core.ocr.di
+
+import com.google.mlkit.vision.text.TextRecognition
+import com.google.mlkit.vision.text.TextRecognizer
+import com.google.mlkit.vision.text.korean.KoreanTextRecognizerOptions
+import dagger.Module
+import dagger.Provides
+import dagger.hilt.InstallIn
+import dagger.hilt.components.SingletonComponent
+import javax.inject.Singleton
+
+@Module
+@InstallIn(SingletonComponent::class)
+object OcrModule {
+
+    @Provides
+    @Singleton
+    fun provideTextRecognizer(): TextRecognizer =
+        TextRecognition.getClient(KoreanTextRecognizerOptions.Builder().build())
+}

core/ui/src/main/kotlin/com/ninecraft/booket/core/ui/component/ReedTopAppBar.kt

@@ -15,17 +15,20 @@ import androidx.compose.material3.Text
 import androidx.compose.runtime.Composable
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.Color
 import androidx.compose.ui.res.painterResource
 import androidx.compose.ui.text.style.TextAlign
 import androidx.compose.ui.tooling.preview.Preview
 import androidx.compose.ui.unit.dp
 import com.ninecraft.booket.core.designsystem.R
+import com.ninecraft.booket.core.designsystem.theme.Neutral950
 import com.ninecraft.booket.core.designsystem.theme.ReedTheme
 import com.ninecraft.booket.core.designsystem.theme.White
 
 @Composable
 fun ReedTopAppBar(
     modifier: Modifier = Modifier,
+    isDark: Boolean = false,
     title: String = "",
     @DrawableRes startIconRes: Int? = null,
     startIconDescription: String = "",
@@ -38,7 +41,7 @@ fun ReedTopAppBar(
         modifier = modifier
             .fillMaxWidth()
             .height(60.dp)
-            .background(color = White)
+            .background(color = if (isDark) Neutral950 else White)
             .padding(horizontal = ReedTheme.spacing.spacing2),
         horizontalArrangement = Arrangement.Start,
         verticalAlignment = Alignment.CenterVertically,
@@ -50,6 +53,7 @@ fun ReedTopAppBar(
                 Icon(
                     painter = painterResource(id = startIconRes),
                     contentDescription = startIconDescription,
+                    tint = if (isDark) White else Color.Unspecified,
                 )
             }
         } else {
@@ -70,6 +74,7 @@ fun ReedTopAppBar(
                 Icon(
                     painter = painterResource(id = endIconRes),
                     contentDescription = endIconDescription,
+                    tint = if (isDark) White else Color.Unspecified,
                 )
             }
         } else {
@@ -81,11 +86,13 @@ fun ReedTopAppBar(
 @Composable
 fun ReedBackTopAppBar(
     modifier: Modifier = Modifier,
+    isDark: Boolean = false,
     title: String = "",
     onBackClick: () -> Unit = {},
 ) {
     ReedTopAppBar(
         modifier = modifier,
+        isDark = isDark,
         title = title,
         startIconRes = R.drawable.ic_chevron_left,
         startIconDescription = "Back",
@@ -96,11 +103,13 @@ fun ReedBackTopAppBar(
 @Composable
 fun ReedCloseTopAppBar(
     modifier: Modifier = Modifier,
+    isDark: Boolean = false,
     title: String = "",
     onClose: () -> Unit = {},
 ) {
     ReedTopAppBar(
         modifier = modifier,
+        isDark = isDark,
         title = title,
         endIconRes = R.drawable.ic_close,
         endIconDescription = "Close",

feature/library/src/main/kotlin/com/ninecraft/booket/feature/library/component/LibraryBookItem.kt

@@ -53,11 +53,7 @@ fun LibraryBookItem(
                 .clip(RoundedCornerShape(size = ReedTheme.radius.sm)),
             placeholder = painterResource(designR.drawable.ic_placeholder),
         )
-        Column(
-            modifier = Modifier
-                .weight(1f)
-                .padding(end = ReedTheme.spacing.spacing5),
-        ) {
+        Column(modifier = Modifier.weight(1f)) {
             Text(
                 text = book.bookTitle,
                 color = ReedTheme.colors.contentPrimary,

feature/record/build.gradle.kts

@@ -16,7 +16,15 @@ ksp {
 
 dependencies {
     implementations(
+        projects.core.ocr,
+
+        libs.compose.system.ui.controller,
+
         libs.androidx.activity.compose,
+        libs.androidx.camera.camera2,
+        libs.androidx.camera.lifecycle,
+        libs.androidx.camera.view,
+
         libs.logger,
     )
 }