> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 當地語系化電子郵件範本

> 在一個範本識別碼下建立具有多個翻譯版本的 PlayFab 電子郵件範本，讓玩家以其慣用語言收到帳戶電子郵件。

PlayFab 正在推出代替遊戲開發人員儲存當地語系化字串的支援。此外，我們也正在新增必要的邏輯，以便為您的玩家提供其慣用語言的正確字串。

本教學課程將逐步引導您了解如何使用當地語系化電子郵件範本。透過當地語系化電子郵件範本，您可以建立電子郵件的多個翻譯版本，並將*所有*版本與一個範本識別碼建立關聯。

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

## 需求

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

* 如需電子郵件範本的簡介，請參閱[使用電子郵件範本傳送帳戶復原電子郵件](/zh-TW/services/playfab/live-service-management/game-configuration/title-communications/emails/using-email-templates-to-send-an-account-recovery-email)教學課程。
* 請檢閱[設定預設語言](/zh-TW/services/playfab/live-service-management/game-configuration/title-communications/news/setting-default-languages)教學課程中，關於如何使用遊戲預設語言和玩家慣用語言的資訊。您必須設定遊戲預設語言，才能繼續使用當地語系化電子郵件範本。

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

我們首先要做的，是更新我們在上述[使用電子郵件範本傳送帳戶復原電子郵件](/zh-TW/services/playfab/live-service-management/game-configuration/title-communications/emails/using-email-templates-to-send-an-account-recovery-email)教學課程中建立的現有帳戶復原電子郵件範本。

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

![Game Manager - Content - Email Templates - 編輯電子郵件範本](https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/game-manager-content-edit-email-template.png?fit=max\&auto=format\&n=3hg2JQs0m7qmDqay\&q=85\&s=3ceed3a457f45f85944bb701147296a8)

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

![編輯電子郵件範本 - 主旨和本文 - 預設語言](https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-template-subject-and-body-default-language.png?fit=max\&auto=format\&n=3hg2JQs0m7qmDqay\&q=85\&s=73a86502d9ea115d84cc067bc0de8eff)

新增更多語言非常簡單，只要選取提供的 **+ ADD LANGUAGE** 連結，然後選擇要新增至範本的語言，並輸入當地語系化字串即可。

在此範例中，我們將在現有範本中新增下列法文字串。

法文電子郵件主旨：

```html theme={null}
Réinitialisation du mot de passe demandée
```

法文電子郵件本文：

```html theme={null}
<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.
```

結果應如下所示：

![編輯電子郵件範本 - 主旨和本文 - 法文](https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-template-subject-and-body-french-language.png?fit=max\&auto=format\&n=3hg2JQs0m7qmDqay\&q=85\&s=dfb61a203ed9ae23c1392bfb93c6247f)

當您選取 **SAVE EMAIL TEMPLATE** 按鈕時，您會被重新導向回包含電子郵件範本清單的頁面。

如您所見，新增了一個新的語言版本，但*沒有*新增新範本，因為所有語言版本都儲存在同一個範本識別碼下。

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

接下來，我們將傳送新的當地語系化版本電子郵件。如[設定預設語言](/zh-TW/services/playfab/live-service-management/game-configuration/title-communications/news/setting-default-languages)教學課程中所述，PlayFab 會負責將遊戲支援的語言與玩家的慣用語言進行比對等繁重工作。您只需要告訴我們傳送電子郵件即可。

若要驗證此行為，請建立兩個測試玩家。

讓其中一位新玩家不設定慣用語言。這將示範在未指定語言，或遊戲語言與玩家語言不相符時，PlayFab 如何退回使用遊戲的預設語言。

使用 Game Manager 或 [SetProfileLanguage](xref:titleid.playfabapi.com.profiles.accountmanagement.setprofilelanguage) API 設定*另一位*新玩家的語言。在此範例中，我們使用法文。

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

在繼續下一個步驟之前，請確認您已依照[使用電子郵件範本傳送帳戶復原電子郵件的步驟 2](/zh-TW/services/playfab/live-service-management/game-configuration/title-communications/emails/using-email-templates-to-send-an-account-recovery-email#step-2---add-username-password-login-email-and-contact-email-to-a-player)教學課程中的說明，為兩位玩家設定聯絡電子郵件。

針對每位玩家使用一次 [SendCustomAccountRecoveryEmail](xref:titleid.playfabapi.com.server.accountmanagement.sendcustomaccountrecoveryemail) API 來傳送此範本：

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

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

![電子郵件 - 密碼重設 - 預設語言](https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-password-reset-default-language.png?fit=max\&auto=format\&n=3hg2JQs0m7qmDqay\&q=85\&s=bb1e0e6cf1614c5e1cf0255ef60fea0e)

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

![電子郵件 - 密碼重設 - 法文](https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-password-reset-french-language.png?fit=max\&auto=format\&n=3hg2JQs0m7qmDqay\&q=85\&s=ce1d58bc1351db185ae7aaae37deba3c)

## 結論

如您所見，PlayFab 注意到您的範本對法文的支援與玩家的語言喜好設定相符。

在*沒有*相符項目或*沒有*喜好設定的情況下，玩家會收到遊戲預設語言的字串。

如果您對本教學課程有任何問題或意見反應，請透過我們的[論壇](https://community.playfab.com/questions/ask.html)或 Slack 頻道與我們聯絡。


## Related topics

- [使用電子郵件範本傳送帳戶復原電子郵件](/zh-TW/services/playfab/live-service-management/game-configuration/title-communications/emails/using-email-templates-to-send-an-account-recovery-email.md)
- [Economy v2 當地語系化](/zh-TW/build/game-principles/localization.md)
- [設定預設語言](/zh-TW/services/playfab/live-service-management/game-configuration/title-communications/news/setting-default-languages.md)
- [使用規則驗證聯絡電子郵件地址](/zh-TW/services/playfab/live-service-management/game-configuration/title-communications/emails/using-a-rule-to-verify-a-contact-email-address.md)
- [XGameUiTextEntryInputScope](/zh-TW/reference/system/xgameui/enums/xgameuitextentryinputscope.md)
