ローカライズされたメールテンプレート - XBOX Game Development Documentation

PlayFab は、ゲーム開発者に代わってローカライズされた文字列を保存するためのサポートを導入しています。加えて、プレイヤーが希望する言語の正しい文字列を提供するのに必要なロジックを追加します。このチュートリアルでは、ローカライズされたメールテンプレートの使用方法を説明します。ローカライズされたメールテンプレートを使用すると、メールの複数の翻訳バージョンを作成し、それらのすべてを 1 つのテンプレート ID に関連付けることができます。

この機能がリリースされる前に導入されたテンプレートは、その動作を保持します。ただし、新しいメールテンプレートで使用される新しいローカライズ形式を使用するように簡単に更新できます。

要件

これは上級チュートリアルです。すべての要件が満たされていることを確認してください。満たされていない場合、このチュートリアルを完了できません。

メールテンプレートの概要については、メールテンプレートを使用したアカウントリカバリメールの送信チュートリアルを参照してください。
タイトルの既定の言語と、プレイヤーの優先言語を扱う方法については、既定の言語の設定チュートリアルの情報を確認してください。ローカライズされたメールテンプレートを続行するには、タイトルの既定の言語を設定する必要があります。

既存のメールテンプレートの更新

最初に、上記のメールテンプレートを使用したアカウントリカバリメールの送信チュートリアルで作成した既存のアカウントリカバリメールテンプレートを更新します。

左のメニューから Content を選択します。
Email Templates タブに移動します。
Template name フィールドに移動し、Account Recovery テンプレートを選択します。

このチュートリアルでは、タイトルの既定の言語が英語であると仮定します。テンプレートの既存バージョンが既定の言語バージョンとして表示されます。さらに言語を追加するのは簡単で、提供される + 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.

以下のようになります: SAVE EMAIL TEMPLATE ボタンを選択すると、メールテンプレートのリストを含むページにリダイレクトされます。ご覧のとおり、新しい言語バージョンが追加されましたが、すべての言語バージョンが同じテンプレート ID の下に保存されるため、新しいテンプレートは追加 されません。

ローカライズされたメールの送信

次に、メールの新しくローカライズされたバージョンを送信します。既定の言語の設定チュートリアルで述べたように、PlayFab はタイトルのサポート言語をプレイヤーの優先言語と一致させる面倒な作業を行います。メールを送信するよう指示するだけで済みます。この動作を確認するには、2 つのテストプレイヤーを作成します。新しいプレイヤーの 1 つには、優先言語を設定しないままにします。これにより、言語が指定されていない場合や、タイトルの言語とプレイヤーの言語の間に一致がない場合に、PlayFab がタイトルの既定にフォールバックする方法が示されます。 もう一方 の新しいプレイヤーの言語を、Game Manager または SetProfileLanguage API を使用して設定します。この例ではフランス語を使用しました。

SetProfileLanguage API を使用する場合、言語文字列は ISO 639-1 形式で指定する必要があります (たとえば、“en”、“es”、“ja”)。現時点では、コード “zh” はサポートされていません。

次の手順に進む前に、メールテンプレートを使用したアカウントリカバリメールの送信のステップ 2 チュートリアルで説明されているように、両方のプレイヤーに連絡先メールを設定していることを確認してください。このテンプレートを送信するには、プレイヤーごとに 1 回、SendCustomAccountRecoveryEmail API を使用します:

優先言語がフランス語のプレイヤーには、フランス語で 1 回。
優先言語が設定されていないプレイヤーには、既定の言語で 1 回。

優先言語を持たない プレイヤーへのサンプルメールを以下に示します。 優先言語がフランス語 のプレイヤーへのサンプルメールを以下に示します。

まとめ

ご覧のとおり、PlayFab はテンプレートのフランス語サポートとプレイヤーの言語設定の一致を認識しました。一致 しない 場合、または優先がない場合、プレイヤーはタイトルの既定の言語文字列を受け取りました。このチュートリアルに関するご質問やフィードバックがある場合は、フォーラムまたは Slack チャンネルからお問い合わせください。

​要件

​既存のメール テンプレートの更新

​ローカライズされたメールの送信

​まとめ

要件

既存のメールテンプレートの更新

ローカライズされたメールの送信

まとめ