Le plug-in Unity est un package de localisation Unity qui permet aux développeurs Unity de gérer les tâches de localisation en synchronisant leurs chaînes source et leurs traductions avec Phrase Strings.
Le plug-in suppose que le développeur Unity utilise ou prévoit d'utiliser la localisation via Unity Localization, en particulier String Table Collections. Consulter la documentation Unity pour commencer avec Unity Localization.
Note
En raison des améliorations continues, l'interface utilisateur peut ne pas être exactement la même que celle présentée dans la vidéo.
Prérequis
-
Créez un ensemble de locales et une ou plusieurs String Table Collections.
-
Les connecter avec des objets texte (et/ou commencer à les utiliser par programmation à partir des scripts Unity).
Installation et configuration
Il existe plusieurs façons d'installer le plug-in :
-
Installer depuis l'Asset Store.
-
Installer depuis l'archive du package en important le fichier local
.unitypackageen tant que package personnalisé. -
Installez à partir du code source extrait localement en utilisant l'une des méthodes suivantes :
-
Extrayez directement la source dans le répertoire
YourProject/Packages/com.phrase.plugin. -
Créez un lien symbolique vers le répertoire
unity_plugindansYourProject/Packagesen tant quecom.phrase.plugin.
-
Une fois installé, ajoutez le aux ressources du projet et terminez la configuration :
-
Configurez l'environnement de connexion et fournissez le jeton d'accès API généré dans Phrase.
-
Récupérez les projets disponibles et sélectionnez-en un dans la liste.
La liste des locales est récupérée automatiquement.
-
En cas d'inadéquation entre les locales de Unity et Phrase Strings, créez les locales manquantes localement ou dans Phrase en sélectionnant l'option appropriée.
-
Sélectionnez les tables de chaînes à connecter et synchroniser avec Phrase.
-
Choisissez quelles locales doivent être importées dans Unity et lesquelles seront poussées vers Phrase. Cette sélection affecte à la fois les opérations globales de push/pull (dans l'inspecteur du fournisseur Phrase) et les opérations individuelles de push/pull pour chaque table de chaînes (dans le tiroir d'extension de table).
Les paramètres sont globaux et affectent à la fois l'extension Phrase (qui ne fonctionne que sur les collections connectées) et la fenêtre Phrase (qui n'affiche que les clés des tables de chaînes connectées).
La liste de clés initiale (généralement uniquement la locale source) peut désormais être envoyée vers Phrase Strings. Une fois traduites vers les locales cibles, les clés sont récupérées dans Unity via le même écran .
Remarque
Les opérations Push and pull sont également disponibles depuis l'extension sur une collection de tables de chaîne.
Commandes Push et Pull
Les utilisateurs peuvent envoyer et récupérer des clés de localisation depuis l'écran (ce qui synchronise toutes les tables de chaînes connectées avec Phrase), ainsi que depuis le tiroir d'extension sur les tables de chaînes individuelles.
Lorsqu'une table de chaînes est connectée au fournisseur Phrase, son inspecteur affiche un tiroir Phrase, qui permet d'envoyer et/ou de récupérer du contenu depuis la table. Les tables de chaînes non connectées au fournisseur Phrase n'auront pas de tiroir Phrase ; l'extension n'apparaîtra que lorsqu'une collection de tables de chaînes sera liée.
Les utilisateurs organisent généralement les traductions en plusieurs collections de tables de chaînes. Des exemples seraient basés sur la section du jeu ou le type d'éléments référencés (par ex. Armes, Éléments, Personnages, etc.). Dans ce cas, il serait nécessaire de connecter une collection avec seulement certaines des clés de traduction existantes dans Strings. Sélectionnez une option dans la liste déroulante pour spécifier le sous-ensemble de clés qui sera envoyé/récupéré vers la table particulière :
-
Seules les clés avec le préfixe donné dans leurs noms sont importées (tirées) vers la table cible. Les noms de clé Unity ne contiendront pas le préfixe lui-même. Lorsqu'elle est poussée, la table entière est téléchargée vers Phrase, et les préfixes sont automatiquement ajoutés aux noms de clé.
-
Seules les clés avec une balise correspondante sont importées vers la table cible. Une fois poussée, la balise est attribuée à toutes les clés de cette table.
-
Toutes les clés Phrase sont importées dans la table cible lors de l'extraction (généralement lorsqu'il n'y a qu'une seule collection connectée à Phrase).
Remarque
L'envoi et l'extraction depuis le tiroir de l'extension Table respectent la liste des locales choisies dans l'inspecteur du fournisseur Phrase. Pour ne synchroniser que le contenu d'une seule collection de tables, faites-le depuis l'extension Phrase. Pour synchroniser tout le contenu connecté, utilisez le fournisseur Phrase.
Vérifiez que les locales cibles sont sélectionnées dans le fournisseur Phrase ou le tiroir d'extension avant de pousser une table de chaînes. Un push effectué sans aucune locale cible sélectionnée crée ou met à jour la tâche dans Phrase Strings, mais cette tâche ne se propage pas aux intégrations en aval, telles que la synchronisation automatisée avec le TMS lors de la création de projet. Cet échec se produit sans aucune erreur visible dans Unity ou dans Phrase Strings.
Pour récupérer, ajoutez les locales cibles manquantes à la tâche affectée dans Phrase Strings et relancez l'intégration en aval. Si les locales cibles ne sont pas du tout configurées dans le projet Unity, l'exportation des traductions vers Unity ne fonctionne pas tant que les locales ne sont pas également configurées du côté Unity.
Fenêtre Phrase
Sélectionnez Window/Phrase dans le menu pour ouvrir la fenêtre de l'éditeur et l'attacher à l'interface principale, si nécessaire.
La fenêtre liste les clés attachées aux objets texte de la scène de localisation, et permet de modifier leurs métadonnées et de télécharger des screenshots.
Elle affiche tous les objets texte de la sélection qui sont connectés à une table de chaînes activée pour Phrase et leurs clés associées. Les utilisateurs peuvent définir la description de la clé et la longueur maximale en caractères, qui seront synchronisées avec Phrase la prochaine fois que la table de chaînes qui la contient sera poussée.
Remarque
Vous pouvez également afficher et modifier les métadonnées de la clé (telles que la description et la longueur maximale) depuis l'éditeur de collection de tables de chaînes.
Utilisez le bouton Update screenshot pour exporter un screenshot de la vue de jeu actuelle et l'attacher à toutes les clés Phrase listées.
Cliquez sur Open in Phrase à côté du nom de la clé pour ouvrir la clé dans l'éditeur de chaînes de Phrase.