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. Consulta 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.
-
Collegali ad alcuni oggetti di testo (o, in alternativa, usali programmaticamente dagli script di 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:
-
Effettua il check-out del codice sorgente direttamente nella directory
YourProject/Packages/com.phrase.plugin. -
Creazione di un collegamento simbolico alla directory
unity_plugininYourProject/Packagescomecom.phrase.plugin.
-
Una volta installato, aggiungi 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 disallineamento dei locali tra Unity e Phrase Strings, crea quelli mancanti, localmente o in Phrase, selezionando l'opzione pertinente.
-
Selezionare le tabelle stringa da connettere e sincronizzare con Phrase.
-
Scegli quali locali devono essere importati (pull) in Unity e quali verranno inviati (push) a Phrase. Questa selezione influisce sia sul pull/push globale (nell'inspector del fornitore Phrase) che sul push/pull della tabella stringa individuale (nel cassetto 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 chiavi iniziale (solitamente solo la locale di origine) può ora essere inviato (push) a Phrase Strings. Una volta tradotte nelle locali di destinazione, le chiavi vengono importate (pull) 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 eseguire il push e il pull delle chiavi di localizzazione dalla schermata (e ciò sincronizza tutte le tabelle stringa connesse con Phrase), e dal cassetto dell'estensione sulle singole tabelle stringa.
Quando una tabella stringa è connessa con il fornitore Phrase, il suo inspector mostra un cassetto Phrase, che consente di eseguire il push e/o il pull del contenuto dalla tabella. Le tabelle stringa non connesse con il fornitore Phrase non avranno il cassetto Phrase; l'estensione apparirà solo quando viene collegata una raccolta di tabelle stringa.
Gli utenti solitamente organizzano le traduzioni in più raccolte di tabelle stringa. Gli esempi si baserebbero sulla sezione del gioco o sul tipo di elementi a cui si fa riferimento (ad es. armi, oggetti, personaggi ecc.). In questo caso, è necessario collegare una raccolta che contiene solo una parte delle chiavi di traduzione esistenti in Phrase Strings. Seleziona un'opzione nel menu a discesa per specificare il sottoinsieme di chiavi che verranno inviate/importate nella tabella specifica:
-
Solo le chiavi con il prefisso specificato nei loro nomi vengono importate (pull) nella tabella di destinazione. I nomi delle chiavi Unity non conterranno il prefisso stesso. Quando viene eseguito il push, 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 raccolta collegata a Phrase).
Nota
Il push e il pull dal cassetto dell'estensione Tabella rispettano l'elenco dei locali selezionati nell'inspector del Phrase Provider. Per sincronizzare solo il contenuto di una singola raccolta di tabelle, utilizza l'estensione Phrase. Per sincronizzare tutto il contenuto collegato, utilizza il Phrase Provider.
Verificare che le lingue di destinazione siano selezionate nel Phrase Provider o nel cassetto dell'estensione prima di eseguire il push di una tabella di stringhe. Un push effettuato senza alcuna lingua di destinazione selezionata crea o aggiorna comunque il job in Phrase Strings, ma il job non si propaga attraverso le integrazioni a valle, come la sincronizzazione della creazione automatica del progetto al TMS. Questo problema si verifica senza alcun messaggio di errore visibile in Unity o in Phrase Strings.
Per recuperare, aggiungi le lingue di destinazione mancanti al job interessato in Phrase Strings e riattiva l'integrazione a valle. Se le lingue di destinazione non sono affatto configurate nel progetto Unity, l'esportazione delle traduzioni in Unity non funziona finché le lingue di destinazione 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 tabella di stringhe abilitata per Phrase e le relative chiavi associate. Gli utenti possono impostare la descrizione della chiave e la lunghezza massima dei caratteri, che verranno sincronizzate con Phrase la prossima volta che la String Table contenente viene inviata.
Nota
Puoi anche visualizzare e modificare i metadati della chiave (come descrizione e lunghezza massima) dall'editor della raccolta String Table.
Usa il pulsante Update screenshot per esportare uno screenshot della vista di gioco corrente e allegarlo a tutte le chiavi Phrase elencate.
Clicca su Open in Phrase accanto al nome della chiave per aprire la chiave nell'editor Strings di Phrase.