O plug-in do Unity é um pacote de localização do Unity que permite aos desenvolvedores do Unity gerenciar tarefas de localização, sincronizando suas strings de origem e traduções com o Phrase Strings.
O plug-in pressupõe que o desenvolvedor do Unity utiliza ou planeja utilizar a localização por meio do Unity Localization, em particular String Table Collections. Consulte a documentação do Unity para começar a usar o Unity Localization.
Nota
Devido a melhorias constantes, a interface do usuário pode não ser exatamente a mesma que é apresentada no vídeo.
Pré-requisitos
-
Crie um conjunto de locales e uma ou mais String Table Collections.
-
Conecte-os a alguns objetos de texto (e/ou comece a usá-los programaticamente a partir dos scripts do Unity).
Instalação e configuração
Existem várias maneiras de instalar o plug-in:
-
Instalar a partir da Asset Store.
-
Instalar a partir do arquivo do pacote importando o arquivo
.unitypackagelocal como um pacote personalizado. -
Instalar a partir do código-fonte verificado localmente, seja:
-
Verificando o código-fonte diretamente no diretório
YourProject/Packages/com.phrase.plugin. -
Criando um link simbólico para o diretório
unity_pluginemYourProject/Packagescomocom.phrase.plugin.
-
Uma vez instalado, adicione o aos ativos do projeto e conclua a configuração:
-
Configure o ambiente de conexão e forneça o token de acesso à API gerado no Phrase.
-
Busque os projetos disponíveis e selecione um da lista.
A lista de locales é buscada automaticamente.
-
No caso de incompatibilidade de locale entre o Unity e o Phrase Strings, crie quaisquer locales ausentes localmente ou no Phrase selecionando a opção relevante.
-
Selecione as String Tables para conectar e sincronizar com o Phrase.
-
Escolha quais locais devem ser recebidos no Unity e quais serão enviados para o Phrase. Essa seleção afeta tanto o Pull/Push global (no inspetor do Phrase Provider) quanto o Push/Pull individual da String Table (na gaveta de extensão da Table).
As configurações são globais e afetam tanto a extensão Phrase (que só funciona em Collections conectadas) quanto a janela Phrase (que só exibe chaves de String Tables conectadas).
A lista de chaves inicial (geralmente apenas o idioma de origem) agora pode ser enviada para o Phrase Strings. Uma vez traduzidas para os idiomas de destino, as chaves são recebidas de volta no Unity através da mesma tela .
Nota
As operações de Push and pull também estão disponíveis na extensão em uma String Table Collection.
Push e pull
Os usuários podem enviar e receber chaves de localização da tela (e isso sincroniza todas as String Tables conectadas com o Phrase), e da gaveta de extensão nas String Tables individuais.
Quando uma String Table está conectada ao Phrase Provider, seu inspetor mostra uma gaveta Phrase, que permite enviar e/ou receber conteúdo da tabela. String Tables não conectadas ao Phrase Provider não terão a gaveta Phrase; a extensão só aparecerá quando uma String Table Collection estiver vinculada.
Os usuários geralmente organizam as traduções em várias String Table Collections. Exemplos seriam baseados na seção do jogo ou no tipo de itens referidos (por exemplo, Armas, Itens, Personagens, etc.). Nesse caso, seria necessário conectar uma coleção com apenas algumas de todas as chaves de tradução existentes no Phrase Strings. Selecione uma opção no menu suspenso para especificar o subconjunto de chaves que será enviado/recebido para a tabela específica:
-
Apenas chaves com o prefixo fornecido em seus nomes são importadas (recebidas) para a tabela de tradução. Os nomes das chaves do Unity não conterão o prefixo em si. Ao enviar, a tabela inteira é carregada para o Phrase, e os prefixos são anexados automaticamente aos nomes das chaves.
-
Apenas chaves com a tag correspondente são importadas para a tabela de tradução. Ao ser enviado, a tag é atribuída a todas as chaves desta tabela.
-
Todas as chaves do Phrase são importadas para a tabela de destino quando extraídas (normalmente quando há apenas uma única Collection conectada ao Phrase).
Nota
O envio e a extração da gaveta de extensão da tabela respeitam a lista de locais de destino escolhidos no inspetor do Phrase Provider. Para sincronizar apenas o conteúdo de uma única coleção de tabela, faça isso a partir da extensão Phrase. Para sincronizar todo o conteúdo conectado, use o Phrase Provider.
Verifique se os locais de destino estão selecionados no Phrase Provider ou na gaveta de extensão antes de enviar uma String Table. Um envio feito sem nenhum local de destino selecionado ainda cria ou atualiza o trabalho no Phrase Strings, mas o trabalho não se propaga por integrações downstream, como a sincronização da Criação Automatizada de Projeto com o TMS. Essa falha ocorre sem nenhum erro visível no Unity ou no Phrase Strings.
Para recuperar, adicione os locais de destino ausentes ao trabalho afetado no Phrase Strings e acione novamente a integração downstream. Se os locais de destino não estiverem configurados no projeto Unity, exportar traduções de volta para o Unity não funcionará até que os locais de destino também estejam configurados no lado do Unity.
Janela Phrase
Selecione Window/Phrase no menu para abrir a janela do editor e anexá-la à interface principal, se necessário.
A janela lista as chaves anexadas aos objetos de texto da cena de localização e oferece a edição de seus metadados e o upload de screenshots.
Ela mostra todos os objetos de texto da seleção que estão conectados a uma string table habilitada para Phrase e suas chaves associadas. Os usuários podem definir a descrição da chave e o comprimento máximo de caracteres, que serão sincronizados com o Phrase na próxima vez que a String Table contida for enviada.
Nota
Você também pode visualizar e editar os metadados da chave (como descrição e comprimento máximo) no editor de String Table Collection.
Use o botão Update screenshot para exportar um screenshot da visualização atual do jogo e anexá-lo a todas as chaves Phrase listadas.
Clique em Open in Phrase ao lado do nome da chave para abrir a chave no editor de Strings do Phrase.