Перейти к основному содержимому

Начало работы

Предварительные требования​

Перед использованием AI Localization Automator убедитесь, что у вас есть:

  1. Локализуемый контент: Текстовые свойства, помеченные как локализуемые в вашем проекте
  2. Цель локализации: Настроенная цель локализации с собранным исходным текстом
  3. Целевые языки: Как минимум одна неродная культура, добавленная в вашу цель локализации
  4. Доступ к AI-провайдеру: API-ключ или доступ к выбранному сервису AI-переводов
Новинка в локализации UE?

Если вы не знакомы с созданием локализуемого текста в Unreal Engine, начните с нашего Руководства по настройке локализации, чтобы узнать, как создавать и настраивать локализуемый текстовый контент.

Доступ к менеджеру AI-переводов​

Плагин интегрируется напрямую в Localization Dashboard Unreal Engine:

  1. Откройте Localization Dashboard (Tools → Localization Dashboard)
  2. Выберите вашу цель локализации
  3. Найдите кнопку "AI Translate" на панели инструментов цели
  4. Нажмите кнопку, чтобы открыть менеджер AI-переводов

Требования к цели

Кнопка AI Translate появляется только для недвижковых целей локализации, у которых есть собранный исходный текст и настроены целевые культуры.

Первоначальная настройка​

Когда вы впервые откроете менеджер AI-переводов, вам потребуется настроить вашего провайдера переводов:

1. Выбор провайдера переводов​

Выберите из доступных AI-провайдеров в выпадающем списке:

  • Ollama: Работает локально для конфиденциальности и без затрат на API, требует локальной настройки
  • OpenAI: Лучшее общее качество, требует API-ключ
  • Anthropic Claude: Отлично подходит для нюансированных переводов, требует API-ключ
  • DeepSeek: Экономичный вариант, требует API-ключ
  • Google Gemini: Хорошее качество с конкурентоспособными ценами, требует API-ключ

2. Настройка параметров провайдера​

У каждого провайдера разные требования и опции конфигурации. Хотя интерфейс предоставляет полезные подсказки при наведении на каждый параметр, для полной информации обо всех доступных настройках и опциях конфигурации для каждого конкретного провайдера см. руководство Провайдеры переводов.

Облачные провайдеры (OpenAI, Claude, DeepSeek, Gemini) обычно требуют как минимум API-ключ для аутентификации, а также различные другие опции конфигурации, такие как выбор модели, настройки температуры, лимиты токенов и таймауты запросов.

Локальные провайдеры (Ollama) требуют как минимум указания Базового URL и Модели, плюс дополнительные параметры для тонкой настройки локального сервиса.

3. Настройка параметров перевода​

Настройте поведение процесса перевода:

  • Максимум одновременных запросов: Количество одновременных переводов (рекомендуется начинать с 10, хотя некоторые провайдеры могут требовать меньших значений - например, Ollama обычно работает лучше всего с максимум 4 запросами из-за ограничений локальной обработки)
  • Максимум попыток на перевод: Лимит повторных попыток для неудачных переводов (рекомендуется 2)
  • Максимум последовательных ошибок: Порог остановки для последовательных ошибок (рекомендуется 6)

Ваш первый перевод​

После завершения настройки вы готовы к переводу:

  1. Просмотрите контент: Таблица перевода показывает все обнаруженные текстовые записи
  2. Проверьте статус: Увидьте, какие переводы ожидают, завершены или завершились ошибкой
  3. Начните перевод: Нажмите "Start Translation", чтобы начать процесс
  4. Следите за прогрессом: Наблюдайте обновления прогресса в реальном времени и статусные сообщения
  5. Сохраните результаты: Используйте "Save Translations", чтобы записать завершенную работу в архивные файлы

Завершите процесс локализации​

После сохранения ваших переводов вам необходимо завершить UE локализационный workflow:

1. Вернитесь в Localization Dashboard​

Закройте AI Translation Manager и вернитесь в Localization Dashboard.

2. Соберите текст и проверьте результаты​

Нажмите кнопку "Gather Text" и дождитесь завершения процесса. Это обновляет систему локализации вашими новыми переводами. После завершения сбора проверьте, что статистика Word Count отображает ваши обновленные переводы - вы должны увидеть увеличенные проценты переводов для ваших целевых культур.

3. Компиляция текста​

Нажмите кнопку "Compile Text", чтобы завершить переводы. Это создаст бинарные файлы, которые ваша игра будет фактически использовать.

4. Упакуйте языки для дистрибуции​

После компиляции текста, чтобы переведённый текст отображался в упакованном проекте:

  1. Откройте Настройки проекта (Edit → Project Settings)
  2. Перейдите в раздел Packaging в левой боковой панели
  3. Разверните категорию Advanced в настройках Packaging
  4. Найдите поле "Languages to Package"
  5. Нажмите радиокнопку "Show Localized", чтобы отобразить только ранее локализованные языки
  6. Выберите языки для упаковки - вы можете нажать "All" с правой стороны текстового поля "Select", чтобы выбрать все локализованные языки
  7. Упакуйте ваш проект - указанные языки теперь будут включены и доступны в качестве опций локализации в вашей игре

Project Settings - Languages to Package

Этот шаг необходим для того, чтобы ваши переводы были доступны в финальной упакованной игре.

5. Протестируйте ваши переводы​

После завершения компиляции вы можете протестировать и предварительно просмотреть ваши переводы в редакторе или игре. Подробные инструкции по тестированию локализации смотрите в нашем Руководстве по тестированию локализации.

Следующие шаги​

Рекомендация для первого запуска

Начните с небольшого подмножества текста (например, 10-20 записей), чтобы протестировать конфигурацию вашего провайдера и убедиться, что переводы соответствуют вашим ожиданиям по качеству, прежде чем обрабатывать большие объёмы.