Plugin Unity je balíček Unity Localization, který umožňuje vývojářům Unity spravovat lokalizační úlohy synchronizací jejich zdrojových řetězců a překladů s Phrase Strings.
Plugin předpokládá, že vývojář Unity používá nebo plánuje použít lokalizaci prostřednictvím Unity Localization, konkrétně String Table Collections. Podívejte se do dokumentace Unity, jak začít s Unity Localization.
Poznámka
Z důvodu kontinuálního vylepšování nemusí uživatelské rozhraní vypadat stejně jako na videu.
Předpoklady
-
Vytvořte sadu jazykových kódů a jednu nebo více String Table Collections.
-
Propojte je s některými textovými objekty (a/nebo je začněte používat programově ze skriptů Unity).
Instalace a konfigurace
Existuje několik způsobů, jak nainstalovat plugin:
-
Nainstalujte z Asset Store.
-
Install from the package archive importováním místního souboru
.unitypackagejako vlastní balíček. -
Nainstalujte z místně staženého zdrojového kódu jedním z následujících způsobů:
-
Stažením zdrojového kódu přímo do adresáře
YourProject/Packages/com.phrase.plugin. -
Vytvořením symbolického odkazu na adresář
unity_pluginvYourProject/Packagesjakocom.phrase.plugin.
-
Po instalaci přidejte do projektových assetů a dokončete konfiguraci:
-
Nastavte prostředí připojení a poskytněte API přístupový token vygenerovaný v Phrase.
-
Načtěte dostupné projekty a vyberte jeden ze seznamu.
Seznam jazykových kódů se načte automaticky.
-
V případě neshody jazykových kódů mezi Unity a Phrase Strings vytvořte jakékoli chybějící jazykové kódy lokálně nebo v Phrase výběrem příslušné možnosti.
-
Vyberte tabulky řetězců, které chcete propojit a synchronizovat s Phrase.
-
Zvolte, které kódy jazyka mají být staženy do Unity a které budou odeslány do Phrase. Tento výběr ovlivňuje jak globální stažení/odeslání (v inspektoru poskytovatele Phrase), tak individuální stažení/odeslání tabulky řetězců (v panelu rozšíření tabulky).
Nastavení jsou globální a ovlivňují jak rozšíření Phrase (které funguje pouze u propojených kolekcí), tak okno Phrase (které zobrazuje pouze klíče z propojených tabulek řetězců).
Počáteční seznam klíčů (obvykle pouze zdrojová lokalizace) lze nyní odeslat do Phrase Strings. Jakmile jsou klíče přeloženy do cílových lokalizací, jsou staženy zpět do Unity prostřednictvím stejné obrazovky .
Poznámka
Operace Push and pull jsou také dostupné z rozšíření u kolekce tabulek řetězců.
Push a Pull
Uživatelé mohou odesílat a stahovat lokalizační klíče z obrazovky (což synchronizuje všechny propojené tabulky řetězců s Phrase) a z panelu rozšíření u jednotlivých tabulek řetězců.
Když je tabulka řetězců propojena s poskytovatelem Phrase, její inspektor zobrazí panel Phrase, který umožňuje odesílání a/nebo stahování obsahu z tabulky. Tabulky řetězců, které nejsou propojeny s poskytovatelem Phrase, nebudou mít panel Phrase; rozšíření se zobrazí pouze tehdy, když je propojena kolekce tabulek řetězců.
Uživatelé běžně organizují překlady do více kolekcí tabulek řetězců. Příklady by byly založeny na sekci hry nebo typu položek, na které se odkazuje (např. Zbraně, Předměty, Postavy atd.). V tomto případě by bylo nutné propojit kolekci pouze s některými ze všech existujících překladových klíčů v Phrase Strings. Vyberte možnost v rozevíracím seznamu pro určení podmnožiny klíčů, které budou odeslány/staženy do konkrétní tabulky:
-
Do cílové tabulky jsou importovány (staženy) pouze klíče se zadanou předponou v jejich názvech. Názvy klíčů v Unity nebudou obsahovat samotnou předponu. Při odeslání je celá tabulka nahrána do Phrase a předpony jsou automaticky připojeny k názvům klíčů.
-
Do cílové tabulky jsou importovány pouze klíče s odpovídajícím tag. Po odeslání je tag přiřazen ke všem klíčům z této tabulky.
-
Všechny klíče Phrase jsou importovány do cílové tabulky při stažení (obvykle když je s Phrase propojena pouze jedna kolekce).
Poznámka
Odesílání a stahování ze zásuvky rozšíření tabulky respektuje seznam jazykových kódů vybraných v inspektoru poskytovatele Phrase. Chcete-li synchronizovat obsah pouze z jedné kolekce tabulek, použijte rozšíření Phrase. Pro synchronizaci veškerého připojeného obsahu použijte poskytovatele Phrase.
Před odesláním tabulky řetězců ověřte, že jsou v poskytovateli Phrase nebo zásuvce rozšíření vybrány cílové jazykové kódy. Odeslání provedené bez vybraných cílových jazykových kódů sice vytvoří nebo aktualizuje zakázku v Phrase Strings, ale zakázka se nešíří prostřednictvím následných integrací, jako je synchronizace automatického vytváření projektu do TMS. K tomuto selhání dochází bez jakékoli viditelné chyby v Unity nebo v Phrase Strings.
Pro obnovení přidejte chybějící cílové jazykové kódy k ovlivněné zakázce v Phrase Strings a znovu spusťte následnou integraci. Pokud cílové jazykové kódy nejsou v projektu Unity vůbec nakonfigurovány, export překladů zpět do Unity nefunguje, dokud nejsou nastaveny také na straně Unity.
Okno Phrase
Vyberte Window/Phrase z nabídky pro otevření okna editoru a v případě potřeby jej připojte k hlavnímu rozhraní.
Okno vypisuje klíče připojené k textovým objektům z lokalizační scény a nabízí úpravu jejich metadat a nahrávání screenshotů.
Zobrazuje všechny textové objekty z výběru, které jsou připojeny k tabulce řetězců s povoleným Phrase, a jejich přidružené klíče. Uživatelé mohou nastavit popis klíče a maximální počet znaků, což se synchronizuje s Phrase při příštím odeslání obsahující tabulky řetězců.
Poznámka
Metadata klíče (jako je popis a maximální délka) můžete také zobrazit a upravit v editoru kolekce tabulky řetězců.
Použijte tlačítko Update screenshot k exportu screenshotu aktuálního zobrazení hry a jeho připojení ke všem uvedeným klíčům Phrase.
Klikněte na Open in Phrase vedle názvu klíče pro otevření klíče v editoru Strings editor Phrase.