當地語系化電子郵件範本 - XBOX Game Development Documentation

PlayFab 正在推出代替遊戲開發人員儲存當地語系化字串的支援。此外，我們也正在新增必要的邏輯，以便為您的玩家提供其慣用語言的正確字串。本教學課程將逐步引導您了解如何使用當地語系化電子郵件範本。透過當地語系化電子郵件範本，您可以建立電子郵件的多個翻譯版本，並將所有版本與一個範本識別碼建立關聯。

在此功能發行之前推出的任何範本都會保留其行為。不過，您可以輕鬆地將它們更新為使用新電子郵件範本所採用的新當地語系化格式。

需求

這是進階教學課程。請確認已符合所有需求，否則您將無法完成本教學課程。

如需電子郵件範本的簡介，請參閱使用電子郵件範本傳送帳戶復原電子郵件教學課程。
請檢閱設定預設語言教學課程中，關於如何使用遊戲預設語言和玩家慣用語言的資訊。您必須設定遊戲預設語言，才能繼續使用當地語系化電子郵件範本。

更新現有的電子郵件範本

我們首先要做的，是更新我們在上述使用電子郵件範本傳送帳戶復原電子郵件教學課程中建立的現有帳戶復原電子郵件範本。

從左側功能表選取 Content。
前往 Email Templates 索引標籤。
移至 Template name 欄位，然後選取 Account Recovery 範本。

Game Manager - Content - Email Templates - 編輯電子郵件範本

在本教學課程中，我們假設您的遊戲預設語言是英文。您會看到現有版本的範本顯示為預設語言版本。

新增更多語言非常簡單，只要選取提供的 + 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 按鈕時，您會被重新導向回包含電子郵件範本清單的頁面。如您所見，新增了一個新的語言版本，但沒有新增新範本，因為所有語言版本都儲存在同一個範本識別碼下。

傳送當地語系化電子郵件

接下來，我們將傳送新的當地語系化版本電子郵件。如設定預設語言教學課程中所述，PlayFab 會負責將遊戲支援的語言與玩家的慣用語言進行比對等繁重工作。您只需要告訴我們傳送電子郵件即可。若要驗證此行為，請建立兩個測試玩家。讓其中一位新玩家不設定慣用語言。這將示範在未指定語言，或遊戲語言與玩家語言不相符時，PlayFab 如何退回使用遊戲的預設語言。使用 Game Manager 或 SetProfileLanguage API 設定另一位新玩家的語言。在此範例中，我們使用法文。

使用 SetProfileLanguage API 時，語言字串必須以 ISO 639-1 格式指定 (例如 “en”、“es” 或 “ja”)。目前不支援代碼 “zh”。

在繼續下一個步驟之前，請確認您已依照使用電子郵件範本傳送帳戶復原電子郵件的步驟 2教學課程中的說明，為兩位玩家設定聯絡電子郵件。針對每位玩家使用一次 SendCustomAccountRecoveryEmail API 來傳送此範本：

以法文傳送一次給慣用語言為法文的玩家。
以預設語言傳送一次給未設定慣用語言的玩家。

傳送給沒有慣用語言之玩家的範例電子郵件如下所示。

傳送給慣用語言為法文之玩家的範例電子郵件如下所示。

結論

如您所見，PlayFab 注意到您的範本對法文的支援與玩家的語言喜好設定相符。在沒有相符項目或沒有喜好設定的情況下，玩家會收到遊戲預設語言的字串。如果您對本教學課程有任何問題或意見反應，請透過我們的論壇或 Slack 頻道與我們聯絡。

​需求

​更新現有的電子郵件範本

​傳送當地語系化電子郵件

​結論

需求

更新現有的電子郵件範本

傳送當地語系化電子郵件

結論