Unity Localization Package pour le vietnamien : workflow complet

💡 Le package Unity Localization (com.unity.localization) permet d'ajouter le vietnamien (locale vi) à n'importe quel jeu Unity en cinq étapes : installer le package, ajouter la locale vi, créer une String Table Collection, renseigner les traductions, puis connecter les composants LocalizedString. Les deux pièges non évidents : l'atlas TextMeshPro doit couvrir les 134+ glyphes diacritiques du vietnamien, et les conteneurs UI doivent prévoir 15 à 30 % d'espace supplémentaire pour les chaînes vietnamiennes.

Le marché vietnamien du jeu mobile et les avantages de la localisation

Le Vietnam compte plus de 77 millions d'internautes et un segment jeu mobile en forte croissance. Google Play liste le vietnamien (vi) comme langue entièrement prise en charge pour les fiches de store et la détection de locale dans l'application. Les joueurs utilisant des appareils en langue vietnamienne s'attendent à ce que leurs jeux correspondent à leur langue.

Avec 97 millions de locuteurs vietnamiens dans le monde, l'ajout de cette langue est une décision commerciale réelle, pas une question de finition. Les studios chinois sont la plus grande source de jeux mobiles entrant sur le marché vietnamien, et les titres livrés avec le vietnamien dès le premier jour affichent un taux de rétention à J+7 et J+30 nettement plus élevé.

Comment installer le package Unity Localization et ajouter la locale vi ?

Ouvrez Window > Package Manager, passez à Unity Registry, recherchez "Localization" et installez com.unity.localization (nécessite Unity 2021.3 LTS ou ultérieur). Allez dans Edit > Project Settings > Localization, cliquez sur Add Locale, cochez Vietnamese (vi) et confirmez. Unity crée un asset Locale vi dans votre projet.

Définissez une locale par défaut (généralement l'anglais en) et ajoutez vi comme locale supportée. Le System Locale Selector détecte automatiquement la locale de l'appareil sur Android, iOS et Windows. Pour forcer le vietnamien pendant les tests en Editor :

// C# - forcer la locale vi à l'exécution pour les tests
LocalizationSettings.SelectedLocale =
    LocalizationSettings.AvailableLocales.GetLocale("vi");

Comment structurer les String Table Collections pour le vietnamien et exporter en XLIFF ?

Une String Table Collection stocke une ligne par chaîne et une colonne par locale. Ouvrez-la via Window > Asset Management > Localization Tables, cliquez sur New Table Collection, sélectionnez vos locales (dont vi) et nommez la collection. Bonnes pratiques pour le vietnamien :

• Nommage des clés : utilisez des chemins séparés par des points (ui.button.start, hud.label.hp, dlg.npc.guard.line_001), sans espaces.
• Gestion du pluriel : le vietnamien n'a pas de pluriel grammatical. Là où l'anglais exige {count:plural:apple|{} apples}, le vietnamien n'a généralement besoin que d'une seule forme, ce qui simplifie les Smart Strings.
• Préchargement : activez le préchargement pour les tables HUD et UI principales afin que les chaînes soient disponibles dès la première frame.
• Export XLIFF : allez dans Window > Asset Management > Localization Tables > Export, choisissez XLIFF 1.2 ou 2.0, définissez la source en en et la cible en vi, puis envoyez le fichier .xliff à votre traducteur ou à un outil CAT (Trados, memoQ, Smartcat). Importez le fichier traduit et reconstruisez les Addressables. Les traducteurs n'ont pas besoin d'accéder au projet Unity.

Pourquoi la configuration de l'atlas TextMeshPro est-elle cruciale pour les diacritiques vietnamiens ?

Le vietnamien s'écrit avec des lettres latines auxquelles s'ajoutent six tons (sắc, huyền, hỏi, ngã, nặng, ngang) superposés sur les voyelles, produisant 134+ variantes de glyphes distinctes. Un atlas TMP statique construit depuis les caractères ASCII affiche des rectangles ou des points d'interrogation pour des lettres comme ả, ụ, ễ ou ồ.

La solution recommandée : passez votre police TMP en mode Dynamic atlas (Atlas Population Mode: Dynamic dans le Font Asset Creator). Unity génère les glyphes à la demande à l'exécution, couvrant la plage Unicode complète du vietnamien. Pour les builds de production où le temps de chargement est critique, exportez le jeu de caractères depuis votre String Table (Window > Localization Tables > Export Character Set), puis faites cuire un atlas TMP statique à partir de ce jeu exact. Résultat : aucun glyphe manquant et aucune surcharge à l'exécution.

Quels sont les bugs de texte vietnamien les plus fréquents dans les jeux Unity ?

• Diacritiques manquants : un atlas TMP statique sans glyphes vietnamiens affiche ô comme o, ắ comme a, rendant le texte illisible. Solution : atlas dynamique ou atlas statique cuit depuis le jeu de caractères exporté de votre String Table.
• Débordement de texte UI : "Start" (5 caractères EN) devient "Bắt đầu" (7 caractères VI). Solution : lancez la pseudo-localisation avant d'envoyer aux traducteurs. L'outil gonfle les chaînes pour simuler l'expansion et signale les conteneurs trop étroits en amont.
• Chaînes codées en dur : tout .text = "Start Game" dans les scripts court-circuite les String Tables. Remplacez toutes les chaînes codées en dur par des références LocalizedString.
• Corruption d'encodage : les outils Windows qui enregistrent le XLIFF en Windows-1252 corrompent silencieusement les diacritiques vietnamiens. Le pipeline XLIFF natif d'Unity utilise UTF-8 par défaut ; assurez-vous que vos traducteurs exportent également en UTF-8.
• Locale de repli manquante : une clé sans valeur vi et sans repli configuré affiche une chaîne vide. Configurez une locale de repli dans Localization Settings.

Que peut-on gérer en interne et quand un spécialiste vietnamien natif est-il rentable ?

Votre équipe peut entièrement gérer en interne : installation du package, configuration des locales, structure des String Tables, export XLIFF, configuration de l'atlas de polices TMP, tests de pseudo-localisation et une première passe de traduction automatique pour les textes provisoires pendant le développement.

Un traducteur de jeux vietnamien natif rentabilise son coût quand :

• Des termes propres au genre sont en jeu. La traduction automatique choisit presque toujours le mauvais registre pour les noms de compétences RPG, les objets MOBA et les mécanismes de cartes, car ces termes ont des conventions vietnamiennes établies que les systèmes MT ne maîtrisent pas de manière fiable.
• Les dialogues contiennent des jeux de mots, des références culturelles ou des idiomes régionaux qui nécessitent une adaptation plutôt qu'une traduction littérale.
• Les fiches de store sur Google Play et l'App Store doivent paraître naturelles aux joueurs vietnamiens, et non manifestement issues d'une traduction automatique.
• Des tests LQA sur un appareil physique sont nécessaires. Seul un joueur natif peut repérer les erreurs qui semblent correctes sur papier mais sonnent faux en contexte de jeu.

Pour la localisation de jeux en vietnamien à partir de l'anglais ou du français, le service de traduction de jeux de Dao Huy couvre la gestion terminologique, la relecture en contexte et les passes LQA.

FAQ

Sources officielles

• Documentation Unity Localization Package ([email protected]) - configuration des locales, String Tables, export XLIFF, pseudo-localisation. Vérifié en novembre 2026.
• Google Play - langues supportées (vi = vietnamien) - confirmation du support vi pour la localisation des fiches de store. Vérifié en novembre 2026.
• Données de locale vietnamienne Unicode CLDR (vi) - jeu de caractères, diacritiques, système numérique. Vérifié en novembre 2026.
• W3C Internationalization - Language tags (BCP 47) - recommandation vi vs vi-VN, principe du tag le plus court. Vérifié en novembre 2026.