Мобильный real-time перевод: провайдеры, debounce и кэш

Клиенты часто приходят с задачей real-time перевода в мобильном приложении — для чата, текстового ввода или документов. Каждый сценарий требует своего подхода: задержка 200–400 мс для чата, debounce для live-ввода, батч с прогресс-баром для документов. За многолетний опыт мы реализовали более 30 проектов с переводом для медицинского туризма, e-commerce и мессенджеров. Гарантируем стабильную работу и соблюдение App Store Review Guidelines. Снижаем стоимость интеграции за счёт продуманной архитектуры. В этой статье разбираем стек, архитектуру и практические приёмы.

Как выбрать провайдера перевода?

Мы сертифицированные разработчики Google Cloud и имеем опыт интеграции всех трёх основных провайдеров. Сравнение в таблице:

Google Cloud Translation — стандарт для продакшена. Поддерживает формальные/неформальные регистры, REST и gRPC. DeepL — выбор, когда критично качество перевода сложных текстов (немецкий, французский). ML Kit — основа для офлайн-сценариев: модель ~15 МБ на языковую пару, скачивается один раз.

Почему важен debounce?

Главная ошибка live-перевода — отправлять запрос на каждое нажатие клавиши. На скорости печати 200 символов/минуту это 3–4 запроса в секунду, из которых 90% уйдут в мусор до ответа. Правильный паттерн — debounce с отменой предыдущих незавершённых запросов.

На iOS (Combine):

@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) 

flatMap(maxPublishers: .max(1)) — это switchMap: при новом вводе отменяет предыдущий запрос. Без этого старые ответы могут перезаписать актуальный перевод.

На Android (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, "") 

flatMapLatest — эквивалент switchMap, отменяет предыдущий coroutine.

Без отмены при быстром вводе pipeline захлебнётся: каждый новый символ запускает перевод, но ответы приходят в произвольном порядке. Пользователь видит «мерцание» перевода. Использование flatMapLatest гарантирует, что в момент нового ввода предыдущий перевод отменяется, и в UI попадает только последний результат.

Интеграция с 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 } 

Для access_token в продакшене — сервисный аккаунт GCP, JWT-подпись на бэкенде. Мобильный клиент получает краткосрочный токен через свой /api/translate-token эндпоинт. 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) с ключом sha256(source_text + target_lang). TTL 7 дней для обычного контента, без TTL для статичных строк UI. На уровне HTTP — Cache-Control для GET-запросов. Согласно документации Google Cloud Translation, поддерживаются GET-запросы с параметрами, что позволяет кэшировать на уровне URLCache / OkHttp Cache. Это существенно сокращает расходы на API.

Пример из практики

В приложении для медицинского туризма (iOS + Android) переводили описания клиник и отзывы пациентов (en→ru, ru→en, de→ru). Cloud-перевод для контента при загрузке, ML Kit офлайн для интерфейса консультации. Debounce 700 мс для поисковой строки. Кэш перевода в Room снизил количество API-запросов на 73% в течение первой недели после запуска, а скорость отображения перевода выросла на 40%. Экономия бюджета на API составила значительную сумму.

Процесс работы

1. Аналитика: изучаем сценарии использования (чат, live, батч), требования к задержке и языкам.
2. Проектирование: выбираем провайдера, архитектуру (облачный/офлайн/гибрид), проектируем debounce и кэш.
3. Реализация: интеграция через бэкенд, написание модуля перевода, настройка отмены запросов.
4. Тестирование: проверяем задержки при разных нагрузках, качество перевода, работу в офлайн.
5. Деплой: публикация в App Store / Google Play, мониторинг ошибок через Crashlytics.

Что входит в работу

• Исходный код iOS и/или Android с интеграцией выбранного провайдера.
• Документация по архитектуре, ключам доступа и эксплуатации.
• Настройка бэкенд-токенов и доступа к API.
• Обучение команды работе с решением.
• Гарантийная поддержка 1 месяц после сдачи.

Сроки и стоимость

Базовая интеграция одного провайдера с debounce и кэшем занимает от 5 до 7 дней. Добавление ML Kit офлайн, автоопределения языка и форматированного текста — от 4 до 6 дней. Точные сроки и стоимость рассчитываются индивидуально, с учётом вашего бюджета. Получите консультацию по выбору провайдера и архитектуры перевода. Свяжитесь с нами для оценки вашего проекта.