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

# PartyTranslation

> 翻譯。

翻譯。

## 語法

```cpp theme={null}
struct PartyTranslation {  
    PartyStateChangeResult result;  
    PartyError errorDetail;  
    PartyString languageCode;  
    PartyTranslationReceivedOptions options;  
    PartyString translation;  
}  
```

### 成員

**`result`**   [PartyStateChangeResult](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md)

表示翻譯作業是否成功。

成功時，`translation` 是包含翻譯文字的非零長度字串。失敗時，此字串是空的。

**`errorDetail`**   PartyError

診斷值，提供有關任何潛在錯誤狀況的其他疑難排解資訊。

可透過 [PartyManager::GetErrorMessage()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md) 擷取此錯誤詳細資料的人類可讀形式。

**`languageCode`**   [PartyString](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/typedefs.md)

翻譯的語言代碼。

語言代碼採用 BCP 47 格式，例如 en-US 代表英文 (美國)。支援的語言代碼列舉於[語言支援](https://learn.microsoft.com/en-us/azure/ai-services/speech-service/language-support)中。

**`options`**   [PartyTranslationReceivedOptions](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partytranslationreceivedoptions.md)

描述翻譯的其他選項。

**`translation`**   [PartyString](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/typedefs.md)

翻譯字串。

根據預設，不雅內容遮罩處理會啟用，並將不雅字詞的每個字元取代為星號。不雅內容遮罩處理會在翻譯未遮罩的來源轉譯之後套用。視內容而定，轉譯可能包含已遮罩的不雅內容，但翻譯則不包含。同樣地，翻譯也可能包含已遮罩的不雅內容，但原始轉譯則不包含。可透過 [PartyVoiceChatTranscriptionOptions::DisableProfanityMasking](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md) 停用不雅內容遮罩處理。\
\
 翻譯字串最多可達 `c_maxChatTextMessageLength` 個字元 (不包括 Null 結束字元)。如果翻譯後的字串長度會超過該限制，就會發生截斷；即使原始字串長度小於或等於 `c_maxChatTextMessageLength`，也可能因語言差異而發生這種情況。在此情況下，`options` 會包含 [PartyTranslationReceivedOptions::Truncated](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partytranslationreceivedoptions.md)。截斷可能發生在 UTF-8 位元組序列中的任意位置，且可能不會產生完整、有效的字元或字詞。即使經過截斷，字串一律以 Null 結束。

## 需求

**標頭：** Party.h

## 另請參閱

[Party 成員](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/party_members.md)


## Related topics

- [PartyChatTextReceivedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partychattextreceivedstatechange.md)
- [PartyVoiceChatTranscriptionReceivedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyvoicechattranscriptionreceivedstatechange.md)
- [Party C/C++ API 概觀](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/party_members.md)
- [PartyTranslationReceivedOptions](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partytranslationreceivedoptions.md)
- [XblNetworkAddressTranslationSetting](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_c/enums/xblnetworkaddresstranslationsetting.md)