Il plugin Unity è un pacchetto di localizzazione Unity che consente agli sviluppatori Unity di gestire le attività di localizzazione sincronizzando le loro stringhe di origine e le traduzioni con Phrase Strings.
Il plugin presuppone che lo sviluppatore Unity utilizzi o preveda di utilizzare la localizzazione tramite Unity Localization, in particolare String Table Collections. Consultare la documentazione di Unity per iniziare con Unity Localization.
Nota
A causa dei miglioramenti che vengono apportati regolarmente, l'interfaccia utente potrebbe apparire leggermente diversa da quella mostrata nel video.
Prerequisiti
-
Creare un set di impostazioni locali e una o più String Table Collections.
-
Collegarli con alcuni oggetti di testo (e/o iniziare a usarli a livello di programmazione dagli script Unity).
Installazione e configurazione
Esistono diversi modi per installare il plugin:
-
Installa dall'Asset Store.
-
Installa dall'archivio del pacchetto importando il file locale
.unitypackagecome pacchetto Personalizzato. -
Installa dal codice sorgente estratto localmente tramite:
-
Estrazione dell'origine direttamente nella directory
YourProject/Packages/com.phrase.plugin. -
Creazione di un collegamento simbolico alla directory
unity_plugininYourProject/Packagescomecom.phrase.plugin.
-
Una volta installato, aggiungere alle risorse del progetto e Completa la configurazione:
-
Configurare l'ambiente di connessione e fornire il token di accesso API generato in Phrase.
-
Recuperare i progetti disponibili e selezionarne uno dall'elenco.
L'elenco delle impostazioni locali viene recuperato automaticamente.
-
In caso di mancata corrispondenza delle impostazioni locali tra Unity e Phrase Strings, creare le impostazioni locali mancanti localmente o in Phrase selezionando l'opzione pertinente.
-
Selezionare le tabelle stringa da connettere e sincronizzare con Phrase.
-
Scegliere quali impostazioni locali devono essere ricevute in Unity e quali verranno inviate a Phrase. Questa selezione influisce sia sull'invio/ricezione globale (sull'inspector del fornitore Phrase) che sull'invio/ricezione della tabella stringa individuale (sul riquadro dell'estensione della tabella).
Le impostazioni sono globali e influiscono sia sull'estensione Phrase (che funziona solo sulle raccolte connesse) che sulla finestra Phrase (che visualizza solo le chiavi dalle tabelle stringa connesse).
L'elenco iniziale delle chiavi (solitamente solo le impostazioni locali di origine) può ora essere inviato a Strings. Una volta tradotte nelle impostazioni locali di destinazione, le chiavi vengono ricevute in Unity attraverso la stessa schermata .
Nota
Le operazioni di Push and pull sono disponibili anche dall'estensione su una raccolta di tabelle stringa.
Push e pull
Gli utenti possono inviare e ricevere chiavi di localizzazione dalla schermata (e ciò sincronizza tutte le tabelle stringa connesse con Phrase), e dal riquadro dell'estensione sulle singole tabelle stringa.
Quando una tabella stringa è connessa con il fornitore Phrase, il suo inspector mostra un riquadro Phrase, che consente di inviare e/o ricevere contenuto dalla tabella. Le tabelle stringa non connesse con il fornitore Phrase non avranno il riquadro Phrase; l'estensione apparirà solo quando una raccolta di tabelle stringa è collegata.
Gli utenti solitamente organizzano le traduzioni in più raccolte di tabelle stringa. Esempi potrebbero basarsi sulla sezione del gioco o sul tipo di elementi a cui si fa riferimento (ad es. armi, oggetti, personaggi ecc.). In questo caso, sarebbe necessario connettere una raccolta con solo alcune di tutte le chiavi di traduzione esistenti in Strings. Selezionare un'opzione nel menu a discesa per specificare il sottoinsieme di chiavi che verranno inviate/ricevute alla particolare tabella:
-
Solo le chiavi con il prefisso specificato nei loro nomi vengono importate (ricevute) nella tabella di destinazione. I nomi delle chiavi Unity non conterranno il prefisso stesso. Quando inviata, l'intera tabella viene caricata su Phrase e i prefissi vengono aggiunti automaticamente ai nomi delle chiavi.
-
Solo le chiavi con tag corrispondente vengono importate nella tabella di destinazione. Quando viene eseguito il push, il tag viene assegnato a tutte le chiavi di questa tabella.
-
Tutte le chiavi Phrase vengono importate nella tabella di destinazione quando viene eseguito il pull (solitamente quando è presente una sola collezione collegata a Phrase).
Nota
Il push e il pull dal cassetto dell'estensione Tabella rispettano l'elenco delle impostazioni locali scelte nell'ispettore del fornitore Phrase. Per sincronizzare solo il contenuto da una singola collezione di tabelle, farlo dall'estensione Phrase. Per sincronizzare tutto il contenuto collegato, usare il fornitore Phrase.
Verificare che le destinazioni siano selezionate nel fornitore Phrase o nel cassetto dell'estensione prima di eseguire il push di una stringa tabella. Un push effettuato senza alcuna destinazione selezionata crea o aggiorna comunque il lavoro in Phrase Strings, ma il lavoro non si propaga attraverso le integrazioni a valle, come la sincronizzazione della creazione automatica del progetto con il TMS. Questo errore si verifica senza alcun errore visibile in Unity o in Phrase Strings.
Per recuperare, aggiungere le destinazioni mancanti al lavoro interessato in Phrase Strings e riattivare l'integrazione a valle. Se le destinazioni non sono affatto configurate nel progetto Unity, l'esportazione delle traduzioni verso Unity non funziona finché le destinazioni non vengono configurate anche sul lato Unity.
Finestra Phrase
Selezionare Window/Phrase dal menu per aprire la finestra dell'editor e collegarla all'interfaccia principale, se necessario.
La finestra elenca le chiavi collegate agli oggetti di testo dalla scena di localizzazione e offre la possibilità di modificarne i metadati e caricare screenshots.
Mostra tutti gli oggetti di testo dalla selezione che sono collegati a una stringa tabella abilitata per Phrase e le relative chiavi associate. Gli utenti possono impostare la descrizione della chiave e la lunghezza massima del carattere, che verranno sincronizzate con Phrase al successivo push della stringa tabella contenitore.
Nota
È inoltre possibile visualizzare e modificare i metadati della chiave (come descrizione e lunghezza massima) dall'editor della collezione di stringhe tabella.
Usare il pulsante Update screenshot per esportare uno screenshot della vista di gioco corrente e collegarlo a tutte le chiavi Phrase elencate.
Fare clic su Open in Phrase accanto al nome della chiave per aprire la chiave nell'editor Strings Editor di Phrase.