Плагин Unity — это пакет Unity Localization, который позволяет разработчикам управлять задачами локализации путём синхронизации их исходных строк и переводов с Phrase Strings.
плагин предполагает, что разработчик Unity использует или планирует использовать локализацию через Unity Localization, в частности String Table Collections. Обратитесь к документации Unity, чтобы начать работу с Unity Localization.
Примечание
Из-за постоянных доработок пользовательский интерфейс может быть не совсем таким, как представлено в видео.
Предварительные требования
-
Создать набор локалей и одну или несколько «String Table Collections».
-
Подключите их к некоторым текстовым объектам (и/или начните использовать их программно из скриптов Unity).
Установка и настройка
Существует несколько способов установки плагина:
-
Установите из Asset Store.
-
Установите из архива пакета, импортировав локальный файл
.unitypackageкак Пользовательский пакет. -
Установите из локально извлечённого исходного кода одним из следующих способов:
-
Извлечение исходного кода непосредственно в каталог
YourProject/Packages/com.phrase.plugin. -
Создание символической ссылки на каталог
unity_pluginвYourProject/Packagesкакcom.phrase.plugin.
-
После установки добавьте в активы проекта и завершите настройку:
-
Настройте среду подключения и предоставьте токен доступа к API, сгенерированный в Phrase.
-
Получите список доступных проектов и выберите один из них.
Список локалей извлекается автоматически.
-
В случае несоответствия локалей между Unity и Phrase Strings необходимо создать отсутствующие локали локально или в Phrase, выбрав соответствующий вариант.
-
Выберите таблицы строк для подключения и синхронизации с Phrase.
-
Выберите, какие локали должны быть получены в Unity, а какие будут отправлены в Phrase. Этот выбор влияет как на глобальную отправку/получение (в инспекторе поставщика Phrase), так и на отправку/получение отдельных таблиц строк (в выдвижной панели расширения таблицы).
Настройки являются глобальными и влияют как на расширение Phrase (которое работает только с подключёнными коллекциями), так и на окно Phrase (которое отображает только ключи из подключённых таблиц строк).
Первоначальный список ключей (обычно только исходная локаль) теперь можно отправить в Phrase Strings. После перевода на целевые локали ключи возвращаются в Unity через тот же экран .
Примечание
Операции Push and pull также доступны из расширения в коллекции таблиц строк.
Push и pull
Пользователи могут отправлять и получать ключи локализации с экрана (это синхронизирует все подключённые таблицы строк с Phrase), а также из выдвижной панели расширения в отдельных таблицах строк.
Когда таблица строк подключена к поставщику Phrase, в её инспекторе отображается панель Phrase, которая позволяет отправлять и/или получать контент из таблицы. Таблицы строк, не подключённые к поставщику Phrase, не будут иметь панели Phrase; расширение появится только тогда, когда коллекция таблиц строк будет связана.
Пользователи обычно организуют переводы в несколько коллекций таблиц строк. Примеры будут основаны на разделе игры или типе элементов, к которым они относятся (например, оружие, предметы, персонажи и т. д.). В этом случае потребуется подключить коллекцию только с некоторыми из всех существующих ключей перевода в Phrase Strings. Выберите опцию в раскрывающемся списке , чтобы указать подмножество ключей, которые будут отправлены/получены для конкретной таблицы:
-
Только ключи с указанным префиксом в именах импортируются (получаются) в целевую таблицу. Имена ключей Unity не будут содержать сам префикс. При отправке вся таблица загружается в Phrase, а префиксы автоматически добавляются к именам ключей.
-
Только ключи с соответствующим tag импортируются в целевую таблицу. При отправке тег назначается всем ключам из этой таблицы.
-
Все ключи Phrase импортируются в таблицу перевода при получении (обычно когда с Phrase связана только одна коллекция).
Примечание
Отправка и получение из панели расширения таблицы учитывают список локалей, выбранных в инспекторе поставщика Phrase. Чтобы синхронизировать контент только из одной коллекции таблиц, сделайте это из расширения Phrase. Чтобы синхронизировать весь подключенный контент, используйте поставщик Phrase.
Подтвердите, что целевые локали выбраны в поставщике Phrase или на панели расширения перед отправкой таблицы строк. Отправка, выполненная без выбора целевых локалей, все равно создает или обновляет задание в Phrase Strings, но задание не передается через последующие интеграции, такие как автоматическое создание проекта, синхронизируемое с TMS. Этот сбой происходит без каких-либо видимых ошибок в Unity или в Phrase Strings.
Для восстановления добавьте недостающие целевые локали к затронутому заданию в Phrase Strings и повторно запустите последующую интеграцию. Если целевые локали не настроены в проекте Unity вообще, экспорт переводов обратно в Unity не будет работать, пока локали не будут настроены также и на стороне Unity.
Окно Phrase
Выберите Window/Phrase в меню, чтобы открыть окно редактора и прикрепить его к основному интерфейсу, если нужно.
Окно «Phrase» отображает список ключей, привязанных к текстовым объектам из сцены локализации, и позволяет редактировать их метаданные и загружать «screenshots».
Оно показывает все текстовые объекты из выделения, которые подключены к таблице строк с поддержкой Phrase, и связанные с ними ключи. Пользователи могут задать описание ключа и максимальную длину символов, которые будут синхронизированы с Phrase при следующей отправке содержащейся в них таблицы строк.
Примечание
Вы также можете просматривать и редактировать метаданные ключа (такие как описание и максимальная длина) в редакторе коллекции таблиц строк.
Используйте кнопку «Update screenshot», чтобы экспортировать «screenshot» текущего вида игры и прикрепить его ко всем перечисленным ключам Phrase.
Нажмите «Open in Phrase» рядом с именем ключа, чтобы открыть ключ в «Strings editor» Phrase.