Pular para o conteúdo principal
O PlayFab está introduzindo o suporte ao armazenamento de cadeias de caracteres localizadas em nome dos desenvolvedores de jogos. Além disso, estamos adicionando a lógica necessária para fornecer aos seus jogadores as cadeias de caracteres corretas para o idioma de preferência deles. Este tutorial mostra como usar modelos de email localizados. Com os modelos de email localizados, você pode criar várias versões traduzidas de um email e associar todas elas a uma única ID de modelo.
Todos os modelos criados antes do lançamento deste recurso manterão seu comportamento. No entanto, você pode atualizá-los facilmente para usar o novo formato localizado usado pelos novos modelos de email.

​
Requisitos

Este é um tutorial avançado. Verifique se todos os requisitos foram atendidos; caso contrário, você não conseguirá concluir este tutorial.

​
Atualizar um modelo de email existente

A primeira coisa que faremos é atualizar o modelo de email de recuperação de conta existente que criamos no tutorial Usar modelos de email para enviar um email de recuperação de conta mencionado acima.
  1. Selecione Content no menu à esquerda.
  2. Acesse a guia Email Templates.
  3. Vá para o campo Template name e selecione o modelo Account Recovery.
Game Manager: Content: Email Templates: editar modelo de email Para os fins deste tutorial, vamos supor que o idioma padrão do seu título seja o inglês. Você verá que a versão existente do modelo aparece como a versão no idioma padrão. Editar modelo de email: assunto e corpo: idioma padrão Adicionar mais idiomas é tão simples quanto selecionar o link + ADD LANGUAGE fornecido, escolher o idioma que você deseja adicionar ao modelo e digitar as cadeias de caracteres localizadas. Neste exemplo, vamos adicionar as seguintes cadeias de caracteres em francês ao nosso modelo existente. Assunto do email em francês:
Corpo do email em francês:
Veja como deve ficar: Editar modelo de email: assunto e corpo: idioma francês Ao selecionar o botão SAVE EMAIL TEMPLATE, você será redirecionado de volta à página que contém a lista dos seus modelos de email. Como você pode ver, uma nova versão de idioma foi adicionada, mas um novo modelo não foi adicionado, pois todas as versões de idioma são armazenadas na mesma ID de modelo.

​
Enviar emails localizados

Em seguida, enviaremos nossa nova versão localizada do email. Conforme mencionado no tutorial Definir idiomas padrão, o PlayFab faz o trabalho pesado de corresponder os idiomas compatíveis do seu título ao idioma preferencial dos seus jogadores. Tudo o que você precisa fazer é nos dizer para enviar o email. Para verificar esse comportamento, crie dois jogadores de teste. Deixe um dos novos jogadores sem idioma preferencial. Isso demonstrará como o PlayFab recorre ao idioma padrão do título se não houver idioma especificado ou se não houver correspondência entre o idioma do título e o idioma do jogador. Defina o idioma do outro novo jogador usando o Game Manager ou a API SetProfileLanguage. Usamos o francês neste exemplo.
Ao usar a API SetProfileLanguage, a cadeia de caracteres de idioma deve ser especificada no formato ISO 639-1 (por exemplo, “en”, “es” ou “ja”). No momento, o código “zh” não tem suporte.
Antes de continuar para a próxima etapa, verifique se você definiu o email de contato nos dois jogadores, conforme explicado na Etapa 2 do tutorial Usar modelos de email para enviar um email de recuperação de conta. Use a API SendCustomAccountRecoveryEmail uma vez por jogador para enviar este modelo:
  • Uma vez em francês para o jogador cujo idioma preferencial é o francês.
  • Uma vez no idioma padrão para um jogador sem idioma preferencial definido.
Um exemplo de email para o jogador sem idioma preferencial é mostrado abaixo. Email: redefinição de senha: idioma padrão Um exemplo de email para o jogador cujo idioma preferencial é o francês é mostrado abaixo. Email: redefinição de senha: idioma francês

​
Conclusão

Como você pode ver, o PlayFab percebeu que havia uma correspondência entre o suporte do seu modelo ao francês e a preferência de idioma do jogador. Onde não havia correspondência ou não havia preferência, o jogador recebeu as cadeias de caracteres no idioma padrão do seu título. Se você tiver dúvidas ou comentários sobre este tutorial, entre em contato conosco pelos nossos fóruns ou pelo canal do Slack.
Última modificação em 8 de outubro de 2026