תרגום בזמן אמת למובייל: ספקים, debounce וקאש

@Published var inputText: String = ""
inputText
    .publisher
    .debounce(for: .milliseconds(500), scheduler: RunLoop.main)
    .removeDuplicates()
    .filter { $0.count >= 3 }
    .flatMap(maxPublishers: .max(1)) { [weak self] text -> AnyPublisher<String, Never> in
        guard let self else { return Empty().eraseToAnyPublisher() }
        return self.translationService.translate(text)
            .replaceError(with: "")
            .eraseToAnyPublisher()
    }
    .receive(on: RunLoop.main)
    .assign(to: &$translatedText)

@Published var inputText: String = "" inputText .publisher .debounce(for: .milliseconds(500), scheduler: RunLoop.main) .removeDuplicates() .filter { $0.count >= 3 } .flatMap(maxPublishers: .max(1)) { [weak self] text -> AnyPublisher<String, Never> in guard let self else { return Empty().eraseToAnyPublisher() } return self.translationService.translate(text) .replaceError(with: "") .eraseToAnyPublisher() } .receive(on: RunLoop.main) .assign(to: &$translatedText) — זהו switchMap: הוא מבטל את הבקשה הקודמת על קלט חדש. ללא זה, תשובות ישנות יכולות לדרוס את התרגום הנוכחי.

באנדרואיד (Kotlin Flow):

val translatedText: StateFlow<String> = inputText
    .debounce(500)
    .filter { it.length >= 3 }
    .distinctUntilChanged()
    .flatMapLatest { text ->
        flow {
            emit(translationRepo.translate(text))
        }.catch { emit("") }
    }
    .stateIn(viewModelScope, SharingStarted.Lazily, "")

flatMap(maxPublishers: .max(1)) — המקבילה של switchMap, מבטל את ה-coroutine הקודם.

ללא ביטול, במהלך הקלדה מהירה הצינור מוצף: כל תו חדש מפעיל תרגום, אבל התשובות מגיעות בסדר אקראי. המשתמש רואה תרגום "מהבהב". שימוש ב-val translatedText: StateFlow<String> = inputText .debounce(500) .filter { it.length >= 3 } .distinctUntilChanged() .flatMapLatest { text -> flow { emit(translationRepo.translate(text)) } .catch { emit("") } } .stateIn(viewModelScope, SharingStarted.Lazily, "") מבטיח שעל קלט חדש התרגום הקודם מבוטל, ורק התוצאה העדכנית ביותר מגיעה לממשק המשתמש.

אינטגרציה עם Google Cloud Translation v3

suspend fun translate(text: String, targetLang: String = "ru"): String {
    val body = JSONObject().apply {
        put("q", text)
        put("target", targetLang)
        put("format", "text")
    }
    val response = httpClient.post("https://translation.googleapis.com/language/translate/v2") {
        header("Authorization", "Bearer $accessToken")
        contentType(ContentType.Application.Json)
        setBody(body.toString())
    }
    return response.body<TranslationResponse>().data.translations[0].translatedText
}

עבור flatMapLatest בייצור — חשבון שירות של GCP, חתימת JWT בשרת. לקוח הנייד מקבל טוקן קצר מועד דרך נקודת קצה flatMapLatest משלו. אין מפתח API של GCP בתוך APK/IPA.

ML Kit לתרחישים לא מקוונים

// iOS: Google ML Kit Translate
let options = TranslatorOptions(sourceLanguage: .english, targetLanguage: .russian)
let translator = Translator.translator(options: options)
translator.downloadModelIfNeeded { error in
    guard error == nil else { return }
    translator.translate("Hello world") { result, error in
        print(result ?? "")
    }
}

המודל מורד פעם אחת דרך Wi-Fi. לאחר מכן, הוא עובד לא מקוון. השהיית המכשיר היא 20–50 אלפיות השנייה למשפט. אידיאלי למסנג'רים, כתוביות וידאו לא מקוונות ואפליקציות נסיעות.

שמירת תרגום במטמון

בקשות חוזרות לאותו טקסט מבזבזות כסף. שמור במטמון ברמת SQLite (Room/CoreData) עם מפתח suspend fun translate(text: String, targetLang: String = "ru"): String { val body = JSONObject().apply { put("q", text) put("target", targetLang) put("format", "text") } val response = httpClient.post("https://translation.googleapis.com/language/translate/v2") { header("Authorization", "Bearer $accessToken") contentType(ContentType.Application.Json) setBody(body.toString()) } return response.body<TranslationResponse>().data.translations[0].translatedText } . TTL של 7 ימים לתוכן רגיל, ללא TTL למחרוזות UI סטטיות. ברמת HTTP, access_token לבקשות GET. לפי תיעוד Google Cloud Translation, בקשות GET עם פרמטרים נתמכות, מה שמאפשר שמירה במטמון ברמת /api/translate-token / OkHttp // iOS: Google ML Kit Translate let options = TranslatorOptions(sourceLanguage: .english, targetLanguage: .russian) let translator = Translator.translator(options: options) translator.downloadModelIfNeeded { error in guard error == nil else { return } translator.translate("Hello world") { result, error in print(result ?? "") } } . זה מפחית משמעותית עלויות API — שמירה במטמון משפרת יעילות עד פי 10 לעומת תרגום ללא מטמון.

מקרה בוחן

בפרויקט עבור לקוח שלנו, אפליקציית תיירות רפואית (iOS + Android), תרגמנו תיאורי מרפאות וביקורות מטופלים (אנ→רו, רו→אנ, דה→רו). תרגום ענן לתוכן בעת טעינה, ML Kit לא מקוון לממשק הייעוץ. Debounce של 700 אלפיות השנייה לשורת החיפוש. מטמון תרגום ב-Room הפחית בקשות API ב-73% בשבוע הראשון לאחר ההשקה, ומהירות הצגת התרגום עלתה ב-40%. החיסכון בתקציב ה-API היה משמעותי — מעל $500 לחודש עבור הלקוח שלנו.

תהליך

1. אנליטיקה: לימוד תרחישי שימוש (צ'אט, חי, אצווה), דרישות השהיה ושפה.
2. עיצוב: בחירת ספק וארכיטקטורה (ענן/לא מקוון/היברידי), עיצוב debounce ומטמון.
3. יישום: אינטגרציה דרך השרת, כתיבת מודול תרגום, הגדרת ביטול בקשות.
4. בדיקות: בדיקת השהיות בעומסים שונים, איכות תרגום, התנהגות לא מקוונת.
5. השקה: פרסום ל-App Store / Google Play, ניטור שגיאות דרך Crashlytics.

מה כלול

• קוד מקור ל-iOS ו/או אנדרואיד עם אינטגרציה של הספק הנבחר.
• תיעוד על ארכיטקטורה, מפתחות גישה ותפעול.
• הגדרת טוקנים בשרת וגישת API.
• הכשרת הצוות שלך לשימוש בפתרון.
• תמיכה באחריות למשך חודש לאחר המסירה.

לוחות זמנים ועלות

אינטגרציה בסיסית של ספק אחד עם debounce ומטמון אורכת 5 עד 7 ימים ועולה החל מ-$1,500. הוספת ML Kit לא מקוון, זיהוי שפה אוטומטי וטקסט מעוצב אורכת 4 עד 6 ימים. לוחות זמנים ועלות מדויקים מחושבים באופן אישי, תוך התחשבות בתקציב שלך. קבלו ייעוץ על בחירת ספק וארכיטקטורת תרגום. צרו קשר להערכת הפרויקט שלכם.