> ## 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.

# PartyTranslation

> 翻譯。

翻譯。

## 語法

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

### 成員

**`result`**   [PartyStateChangeResult](/zh-TW/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult)

表示翻譯作業是否成功。

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

**`errorDetail`**   PartyError

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

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

**`languageCode`**   [PartyString](/zh-TW/services/playfab/multiplayer/networking/reference/typedefs)

翻譯的語言代碼。

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

**`options`**   [PartyTranslationReceivedOptions](/zh-TW/services/playfab/multiplayer/networking/reference/enums/partytranslationreceivedoptions)

描述翻譯的其他選項。

**`translation`**   [PartyString](/zh-TW/services/playfab/multiplayer/networking/reference/typedefs)

翻譯字串。

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

## 需求

**標頭：** Party.h

## 另請參閱

[Party 成員](/zh-TW/services/playfab/multiplayer/networking/reference/party_members)


## Related topics

- [PartyChatTextReceivedStateChange](/zh-TW/services/playfab/multiplayer/networking/reference/structs/partychattextreceivedstatechange.md)
- [PartyVoiceChatTranscriptionReceivedStateChange](/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyvoicechattranscriptionreceivedstatechange.md)
- [Party C/C++ API 概觀](/zh-TW/services/playfab/multiplayer/networking/reference/party_members.md)
- [PartyTranslationReceivedOptions](/zh-TW/services/playfab/multiplayer/networking/reference/enums/partytranslationreceivedoptions.md)
- [使用 Cognitive Services](/zh-TW/services/playfab/multiplayer/networking/party-unreal-engine-oss-cognitive-services-interface.md)