El plugin de Unity es un paquete de Unity Localization que permite a los desarrolladores de Unity gestionar tareas de localización sincronizando sus cadenas fuente y traducciones con Phrase Strings.
El plugin asume que el desarrollador de Unity usa o planea usar la localización a través de Unity Localization, en particular String Table Collections. Consulta la documentación de Unity para empezar con Unity Localization.
Nota
Debido a las continuas mejoras, es posible que la interfaz de usuario no sea exactamente la misma que la que se presenta en el vídeo.
Requisitos previos
-
Crea un conjunto de localizaciones y una o más String Table Collections.
-
Conéctalos con algunos objetos de texto (y/o empieza a usarlos programáticamente desde los scripts de Unity).
Instalación y configuración
Existen varias formas de instalar el plugin:
-
Instala desde la Asset Store.
-
Instala desde el archivo del paquete importando el archivo local
.unitypackagecomo un paquete personalizado. -
Instala desde el código fuente local mediante:
-
Descarga el fuente directamente en el directorio
YourProject/Packages/com.phrase.plugin. -
Crea un enlace simbólico al directorio
unity_pluginenYourProject/Packagescomocom.phrase.plugin.
-
Una vez instalado, agrega a los project’s assets y completa la configuración:
-
Configura el entorno de conexión y proporciona el token de acceso a la API generado en Phrase.
-
Obtén los proyectos disponibles y selecciona uno de la lista.
La lista de localizaciones se obtiene automáticamente.
-
En caso de discrepancia de localización entre Unity y Phrase Strings, crea cualquier localización faltante localmente o en Phrase seleccionando la opción relevante.
-
Selecciona las tablas de cadena para conectar y sincronizar con Phrase.
-
Elige qué localizaciones deben extraerse a Unity y cuáles se enviarán a Phrase. Esta selección afecta tanto al pull/push global (en el inspector de Phrase Provider) como al pull/push individual de tabla de cadenas (en el cajón de extensión de tabla).
La configuración es global y afecta tanto a la extensión Phrase (que solo funciona en colecciones conectadas) como a la ventana Phrase (que solo muestra claves de tablas de cadena conectadas).
La lista de claves inicial (generalmente solo la localización fuente) ahora puede enviarse a Strings de Phrase. Una vez traducidas a las localizaciones meta, las claves se extraen de vuelta a Unity a través de la misma pantalla .
Nota
Las operaciones de Push and pull también están disponibles desde la extensión en una colección de tablas de cadena.
Push y pull
Los usuarios pueden hacer push y pull de claves de localización desde la pantalla (y eso sincroniza todas las tablas de cadena conectadas con Phrase), y desde el panel de la extensión en las tablas de cadena individuales.
Cuando una tabla de cadena está conectada al Phrase Provider, su inspector muestra un cajón Phrase que permite hacer push y/o pull del contenido de la tabla. Las tablas de cadena no conectadas con el proveedor Phrase no tendrán el cajón Phrase; la extensión solo aparecerá cuando una colección de tablas de cadena esté vinculada.
Los usuarios suelen organizar las traducciones en múltiples colecciones de tablas de cadena. Los ejemplos se basarían en la sección del juego o el tipo de elementos a los que se hace referencia (p. ej., armas, elementos, personajes, etc.). En este caso, sería necesario conectar una colección con solo algunas de todas las claves de traducción existentes en Strings de Phrase. Selecciona una opción en el menú desplegable para especificar el subconjunto de claves que se enviarán/extraerán a esa tabla:
-
Solo las claves con el prefijo dado en sus nombres se importan (extraen) a la tabla meta. Los nombres de clave de Unity no contendrán el prefijo en sí. Al enviarse, toda la tabla se carga en Phrase y los prefijos se añaden automáticamente a los nombres de las claves.
-
Solo las claves con la etiqueta coincidente se importan a la tabla meta. Al hacer push, la etiqueta se asigna a todas las claves de esta tabla.
-
Todas las claves de Phrase se importan a la tabla meta cuando se extraen (normalmente cuando solo hay una colección conectada con Phrase).
Nota
Las operaciones de push y pull desde el cajón de extensión de tabla respetan la lista de localizaciones meta seleccionadas en el inspector del Phrase Provider. Para sincronizar solo el contenido de una única colección de tablas, hazlo desde la extensión de Phrase. Para sincronizar todo el contenido conectado, usa el proveedor de Phrase.
Verifica que los locales estén seleccionados en el proveedor de Phrase o en el cajón de extensión antes de enviar una String Table. Un envío realizado sin ningún local seleccionado igual crea o actualiza el trabajo en Phrase Strings, pero el trabajo no se propaga a través de las integraciones posteriores, como la sincronización de creación de proyecto automatizada con TMS. Este fallo ocurre sin ningún error visible en Unity o en Phrase Strings.
Para recuperar, agrega los locales faltantes al trabajo afectado en Phrase Strings y vuelve a activar la integración posterior. Si los locales no están configurados en el proyecto de Unity en absoluto, exportar traducciones de vuelta a Unity no funciona hasta que los locales también estén configurados en el lado de Unity.
Ventana de Phrase
Selecciona Window/Phrase en el menú para abrir la ventana del editor de y adjuntarla a la interfaz principal, si es necesario.
La ventana de enumera las claves adjuntas a los objetos de texto de la escena de localización y ofrece editar sus metadatos y cargar capturas de pantalla.
Muestra todos los objetos de texto de la selección que están conectados a una cadena de tabla habilitada para Phrase y sus claves asociadas. Los usuarios pueden establecer la descripción de la clave y la longitud máxima de carácter, que se sincronizarán con Phrase la próxima vez que se haga push de la String Table que la contiene.
Nota
También puedes ver y editar los metadatos de la clave (como la descripción y la longitud máxima) desde el editor de la colección de cadenas de tabla.
Usa el botón Update screenshot para exportar una captura de pantalla de la vista actual del juego y adjuntarla a todas las claves de Phrase enumeradas.
Haz clic en Open in Phrase junto al nombre de la clave para abrir la clave en el editor de Strings de Phrase.