[BOOK-275] feat: CloudVision API 정의

Author: seoyoon513

core/ocr/build.gradle.kts

@@ -2,6 +2,7 @@
 
 plugins {
     alias(libs.plugins.booket.android.library)
+    alias(libs.plugins.booket.android.retrofit)
     alias(libs.plugins.booket.android.hilt)
 }
 

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

@@ -0,0 +1,34 @@
+package com.ninecraft.booket.core.ocr.analyzer
+
+import com.ninecraft.booket.core.ocr.model.AnnotateImageRequest
+import com.ninecraft.booket.core.ocr.model.CloudVisionRequest
+import com.ninecraft.booket.core.ocr.model.Feature
+import com.ninecraft.booket.core.ocr.model.ImageContext
+import com.ninecraft.booket.core.ocr.model.VisionImage
+import com.ninecraft.booket.core.ocr.service.CloudVisionService
+import com.orhanobut.logger.Logger
+import javax.inject.Inject
+
+class CloudOcrRecognizer @Inject constructor(
+    private val service: CloudVisionService,
+) {
+    suspend fun recognizeText(base64Image: String) {
+        try {
+            val request = CloudVisionRequest(
+                requests = listOf(
+                    AnnotateImageRequest(
+                        image = VisionImage(base64Image),
+                        features = listOf(Feature(type = "TEXT_DETECTION")),
+                        imageContext = ImageContext(languageHints = null),
+                    ),
+                ),
+            )
+            service.annotate(
+                key = "", // local properties 에서 key 가져오기
+                body = request,
+            )
+        } catch (e: Exception) {
+            Logger.e("${e.message}")
+        }
+    }
+}

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

@@ -0,0 +1,74 @@
+package com.ninecraft.booket.core.ocr.di
+
+import com.ninecraft.booket.core.ocr.service.CloudVisionService
+import dagger.Module
+import dagger.Provides
+import dagger.hilt.InstallIn
+import dagger.hilt.components.SingletonComponent
+import kotlinx.serialization.json.Json
+import okhttp3.MediaType.Companion.toMediaType
+import okhttp3.OkHttpClient
+import okhttp3.logging.HttpLoggingInterceptor
+import retrofit2.Retrofit
+import retrofit2.converter.kotlinx.serialization.asConverterFactory
+import java.util.concurrent.TimeUnit
+import javax.inject.Singleton
+
+
+private const val MaxTimeoutMillis = 15_000L
+
+private val jsonRule = Json {
+    // 기본값도 JSON에 포함하여 직렬화
+    encodeDefaults = true
+    // JSON에 정의되지 않은 키는 무시 (역직렬화 시 에러 방지)
+    ignoreUnknownKeys = true
+    // JSON을 보기 좋게 들여쓰기하여 포맷팅
+    prettyPrint = true
+    // 엄격하지 않은 파싱 (따옴표 없는 키, 후행 쉼표 등 허용)
+    isLenient = true
+}
+
+private val jsonConverterFactory = jsonRule.asConverterFactory("application/json".toMediaType())
+
+@Module
+@InstallIn(SingletonComponent::class)
+object CloudVisionNetworkModule {
+
+    @Provides
+    @Singleton
+    @CloudVisionOkHttp
+    fun provideOkHttp(): OkHttpClient {
+        val log = HttpLoggingInterceptor().apply {
+            level = HttpLoggingInterceptor.Level.BASIC
+        }
+        return OkHttpClient.Builder()
+            .addInterceptor(log)
+            .addInterceptor { chain ->
+                val req = chain.request().newBuilder()
+                    .build()
+                chain.proceed(req)
+            }
+            .connectTimeout(MaxTimeoutMillis, TimeUnit.MILLISECONDS)
+            .readTimeout(MaxTimeoutMillis, TimeUnit.MILLISECONDS)
+            .writeTimeout(MaxTimeoutMillis, TimeUnit.MILLISECONDS)
+            .build()
+    }
+
+    @Provides
+    @Singleton
+    @CloudVisionRetrofit
+    fun provideRetrofit(
+        @CloudVisionOkHttp okHttpClient: OkHttpClient,
+    ): Retrofit {
+        return Retrofit.Builder()
+            .baseUrl("https://vision.googleapis.com/")
+            .client(okHttpClient)
+            .addConverterFactory(jsonConverterFactory)
+            .build()
+    }
+
+    @Provides
+    @Singleton
+    fun provideVisionApi(@CloudVisionRetrofit retrofit: Retrofit): CloudVisionService =
+        retrofit.create(CloudVisionService::class.java)
+}

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

@@ -0,0 +1,11 @@
+package com.ninecraft.booket.core.ocr.di
+
+import javax.inject.Qualifier
+
+@Qualifier
+@Retention(AnnotationRetention.BINARY)
+annotation class CloudVisionOkHttp
+
+@Qualifier
+@Retention(AnnotationRetention.BINARY)
+annotation class CloudVisionRetrofit

core/ocr/src/main/kotlin/com/ninecraft/booket/core/ocr/model/CloudVisionRequest.kt

@@ -0,0 +1,31 @@
+package com.ninecraft.booket.core.ocr.model
+
+import kotlinx.serialization.Serializable
+
+
+@Serializable
+data class CloudVisionRequest(
+    val requests: List<AnnotateImageRequest>,
+)
+
+@Serializable
+data class AnnotateImageRequest(
+    val image: VisionImage,
+    val features: List<Feature>,
+    val imageContext: ImageContext? = null
+)
+
+@Serializable
+data class VisionImage(
+    val content: String,
+)
+
+@Serializable
+data class Feature(
+    val type: String = "TEXT_DETECTION",
+)
+
+@Serializable
+data class ImageContext(
+    val languageHints: List<String>? = null
+)

core/ocr/src/main/kotlin/com/ninecraft/booket/core/ocr/model/CloudVisionResponse.kt

@@ -0,0 +1,18 @@
+package com.ninecraft.booket.core.ocr.model
+
+import kotlinx.serialization.Serializable
+
+@Serializable
+data class CloudVisionResponse(
+    val response: List<AnnotateImageResponse>,
+)
+
+@Serializable
+data class AnnotateImageResponse(
+    val fullTextAnnotation: FullTextAnnotation? = null,
+)
+
+@Serializable
+data class FullTextAnnotation(
+    val text: String? = null,
+)

core/ocr/src/main/kotlin/com/ninecraft/booket/core/ocr/service/CloudVisionService.kt

@@ -0,0 +1,15 @@
+package com.ninecraft.booket.core.ocr.service
+
+import com.ninecraft.booket.core.ocr.model.CloudVisionRequest
+import com.ninecraft.booket.core.ocr.model.CloudVisionResponse
+import retrofit2.http.Body
+import retrofit2.http.POST
+import retrofit2.http.Query
+
+interface CloudVisionService {
+    @POST("v1/images:annotate")
+    suspend fun annotate(
+        @Query("key") key: String,
+        @Body body: CloudVisionRequest
+    ): CloudVisionResponse
+}