Das Unity Plug-in ist ein Unity-Lokalisierungspaket, das es Unity-Entwicklern ermöglicht, Lokalisierungsaufgaben zu verwalten, indem sie ihre Ausgangssprache-Strings und Übersetzungen mit Phrase Strings synchronisieren.
Das Plug-in setzt voraus, dass der Unity-Entwickler die Lokalisierung über Unity Localization verwendet oder zu verwenden plant, insbesondere String Table Collections. Es wird empfohlen, die Unity-Dokumentation zu konsultieren, um mit Unity Localization zu beginnen.
Hinweis
Aufgrund kontinuierlicher Verbesserungen kann die Benutzeroberfläche nicht genau so aussehen wie im Video dargestellt.
Voraussetzungen
-
Eine Reihe von Locales und eine oder mehrere String Table Collections anlegen
-
Mit einigen Textobjekten verknüpfen und/oder programmgesteuert über Unity-Skripte verwenden
Installation und Konfiguration
Es gibt verschiedene Möglichkeiten, das Plug-in zu installieren:
-
Aus dem Asset Store installieren
-
Aus dem Paketarchiv installieren, indem die lokale
.unitypackage-Datei als individuelles Paket importiert wird -
Aus lokal ausgechecktem Quellcode kann auf eine der folgenden Arten installiert werden:
-
Quellcode direkt in das Verzeichnis
YourProject/Packages/com.phrase.pluginauschecken -
Erstellen einer symbolischen Verknüpfung zum Verzeichnis
unity_plugininYourProject/Packagesalscom.phrase.plugin.
-
Nach der Installation zu den Projekt-Assets hinzufügen und Konfiguration abschließen:
-
Verbindungsumgebung einrichten und das API-Zugriffs-Token, das in Phrase generiert wurde, bereitstellen
-
Verfügbare Projekte abrufen und eines aus der Liste auswählen
Die Liste der Locales wird automatisch abgerufen
-
Bei einer Diskrepanz der Locales zwischen Unity und Phrase Strings fehlende Locales entweder lokal oder in Phrase anlegen, indem die entsprechende Option gewählt wird
-
Die String Tables auswählen, die mit Phrase verbunden und synchronisiert werden sollen
-
Festlegen, welche Locales nach Unity gezogen und welche zu Phrase übertragen werden sollen Diese Auswahl wirkt sich sowohl auf den globalen Push/Pull (im Phrase Provider-Inspektor) als auch auf den individuellen String Table Push/Pull (im Table Extension Drawer) aus
Die Einstellungen sind global und wirken sich sowohl auf die Phrase Extension (welche nur bei verbundenen Collections funktioniert) als auch auf das Phrase-Fenster (das ausschließlich Schlüssel aus verbundenen String Tables anzeigt) aus
Die anfängliche Key-Liste (in der Regel nur die Quell-Locale) kann nun zu Phrase Strings übertragen werden Nachdem die Schlüssel in die Ziel-Locales übersetzt wurden, werden sie über denselben -Screen zurück nach Unity geholt
Hinweis
Push & Pull-Operationen sind auch über die -Erweiterung einer String Table Collection verfügbar
Push & Pull
Lokalisierungsschlüssel können über den -Screen (welcher alle verbundenen String Tables mit Phrase synchronisiert) sowie über den -Erweiterungsbereich der einzelnen String Tables gepusht und gepullt werden
Wenn eine String Table mit dem Phrase Provider verbunden ist, zeigt ihr Inspektor einen Phrase-Bereich, der das Pushen und/oder Pullen von Inhalten aus der Tabelle ermöglicht String Tables, die nicht mit dem Phrase Provider verbunden sind, besitzen keinen Phrase-Bereich; die Erweiterung erscheint nur, wenn eine String Table Collection verknüpft ist
Übersetzungen werden üblicherweise in mehreren String Table Collections organisiert Beispiele basieren auf dem Spielabschnitt oder der Art der referenzierten Elemente (z. B. Waffen, Gegenstände, Charaktere usw.). In diesem Fall ist es erforderlich, eine Collection zu verbinden, die nur einen Teil der in Phrase Strings vorhandenen Übersetzungsschlüssel enthält Im Dropdown-Menü eine Option auswählen, um die Teilmenge der Schlüssel festzulegen, die zur jeweiligen Tabelle gepusht bzw. gepullt werden sollen
-
Nur Schlüssel mit dem angegebenen Präfix im Namen werden in die Zieltabelle importiert (gepullt) Die Unity-Key-Namen enthalten das Präfix selbst nicht. Beim Pushen wird die gesamte Tabelle zu Phrase hochgeladen, wobei den Schlüsseln automatisch Präfixe vorangestellt werden
-
Nur Keys mit passendem Tag werden in die Zieltabelle importiert. Beim Übertragen wird das Tag allen Keys aus dieser Tabelle zugewiesen.
-
Alle Phrase-Schlüssel werden beim Pull in die Zieltabelle importiert (typischerweise, wenn nur eine einzige Collection mit Phrase verbunden ist)
Hinweis
Push- und Pull-Vorgänge aus dem Table Extension Drawer richten sich nach der im Phrase Provider-Inspektor ausgewählten Liste der Locales Um ausschließlich Inhalte aus einer einzelnen Table Collection zu synchronisieren, die Phrase Extension verwenden Um alle verbundenen Inhalte zu synchronisieren, den Phrase Provider einsetzen
Vor dem Push einer String Table überprüfen, ob Ziel-Locales im Phrase Provider oder im Extension Drawer ausgewählt sind Ein Push ohne ausgewählte Ziel-Locales erstellt oder aktualisiert zwar den Job in Phrase Strings, propagiert diesen jedoch nicht an nachgelagerte Integrationen, wie die automatische Projekterstellung mit TMS-Synchronisierung Dieser Fehler tritt ohne sichtbare Fehlermeldung in Unity oder in Phrase Strings auf.
Zur Fehlerbehebung die fehlenden Ziel-Locales dem betroffenen Job in Phrase Strings hinzufügen und die nachgelagerte Integration erneut auslösen Falls im Unity-Projekt keine Ziel-Locales konfiguriert sind, funktionieren exportierte Übersetzungen zurück nach Unity erst, sobald auch auf Unity-Seite die Locales eingerichtet wurden
Phrase-Fenster
Über das Menü Window/Phrase das -Editor-Fenster öffnen und bei Bedarf an die Hauptoberfläche andocken
Das -Fenster zeigt die an die Textobjekte der Lokalisierungsszene angehängten Schlüssel und ermöglicht, deren Metadaten zu bearbeiten sowie Screenshots hochzuladen
Alle in der Auswahl befindlichen Textobjekte, die mit einer Phrase-aktivierten String Table verbunden sind, sowie deren zugehörige Schlüssel werden angezeigt Die Beschreibung eines Schlüssels und die maximale Zeichenlänge können festgelegt werden; diese Einstellungen werden beim nächsten Push der enthaltenen String Table mit Phrase synchronisiert
Hinweis
Die Schlüssel-Metadaten (wie Beschreibung und maximale Länge) lassen sich auch im Editor der String Table Collection einsehen und bearbeiten
Die Schaltfläche Update screenshot verwenden, um einen screenshot der aktuellen Spielansicht zu exportieren und an alle aufgeführten Phrase-Schlüssel anzuhängen
Neben dem Schlüsseleintrag auf Open in Phrase klicken, um ihn im Phrase Strings Editor zu öffnen