本地化电子邮件模板

PlayFab 引入了代表游戏开发者存储本地化字符串的支持。 此外,我们会添加必要逻辑,以便为玩家提供其首选语言的正确字符串。

本教程介绍如何使用本地化电子邮件模板。 借助本地化电子邮件模板,可以创建电子邮件的多个翻译版本,然后将所有 版本与一个模板 ID 关联。

注意

发布此功能之前引入的任何模板都会保留其行为。 但是,可以轻松地将它们更新为使用新电子邮件模板所有的新本地化格式。

要求

这是高级 教程。 请确保满足所有要求,否则无法 完成本教程。

更新现有电子邮件模板

我们的第一件事是更新我们在上述使用电子邮件模板发送帐户恢复电子邮件教程中创建的现有帐户恢复电子邮件模板。

  1. 从左侧菜单中选择 Content
  2. 转到 Email Templates 选项卡。
  3. 移动到 Template name 字段,然后选择 Account Recovery模板。

Game Manager - Content - Email Templates - Edit Email Template

在本教程中,我们假设游戏默认语言是英语。 您会看到模板的现有版本显示为默认语言版本。

Edit Email Template - Subject and Body - Default Language

添加更多语言十分简单,只需选择提供的 + ADD LANGUAGE 链接,然后选择要添加到模板的语言,并输入本地化字符串。

在此示例中,我们将以下法语字符串添加到现有模板。

法语电子邮件主题:

Réinitialisation du mot de passe demandée

法语电子邮件正文:

<head></head>
<body><p>Vous avez récemment demandé un mot de passe avec nous. </p>
<p>Cliquez <a href="$ConfirmationUrl$">ici</a> s'il vous plaît pour être dirigé vers une page pour réinitialiser votre mot de passe.

下面是它看起来的样子:

Edit Email Template - Subject and Body - French Language

如果选择 SAVE EMAIL TEMPLATE 按钮,将重定向回到包含电子邮件模板列表的页面。

可以看到,新语言版本已添加,但是新模板 添加,因为所有语言版本都存储在相同模板 ID 下。

发送本地化电子邮件

接下来,我们发送新本地化版本的电子邮件。 如设置默认语言教程中所述,PlayFab 会进行大量工作将游戏的受支持语言与玩家的首选语言匹配。 您只需让我们发送电子邮件。

若要验证此行为,请创建两个测试玩家。

让其中一个新玩家没有首选语言。 这会演示在未指定语言,或是游戏语言与玩家语言不匹配时,PlayFab 如何回退到游戏默认设置。

使用 Game Manager 或使用 SetProfileLanguage API 设置另一个 新玩家的语言。 我们在此示例中使用法语。

注意

使用 SetProfileLanguage API 时,必须以 ISO 639-1 格式(例如,“en”、“es”或“ja”)指定语言字符串。 目前不支持代码"zh"。

在继续进行下一步之前,确保按照使用电子邮件模板发送帐户恢复电子邮件步骤 2教程中所述设置联系人电子邮件。

对每个玩家使用 SendCustomAccountRecoveryEmail API 一次以发送此模板:

  • 一次采用法语,用于首选语言是法语的玩家。
  • 一次采用默认语言,用于未设置首选语言的玩家。

下面是发送给没有首选语言 的玩家的示例电子邮件。

电子邮件 - 密码重置 - 默认语言

下面是发送给首选语言是法语 的玩家的示例电子邮件。

电子邮件 - 密码重置 - 法语

总结

可以看到,PlayFab 注意到模板的法语支持与玩家的语言首选项之间可匹配。

匹配或没有 首选项的情况下,玩家会收到游戏的默认语言字符串。

如果对本教程有任何问题或反馈,请通过我们的论坛或 Slack 通道联系我们。