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

# PartyLocalChatControl::SetTranscriptionOptions

> 設定此聊天控制項與語音聊天音訊相關聯的轉譯選項。

設定此聊天控制項與語音聊天音訊相關聯的轉譯選項。

## 語法

```cpp theme={null}
PartyError SetTranscriptionOptions(  
    PartyVoiceChatTranscriptionOptions options,  
    void* asyncIdentifier  
)  
```

### 參數

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

與語音聊天轉譯相關聯的選項，例如哪些聊天控制項應為本機聊天控制項產生轉譯，以及這些轉譯是否應翻譯為本機聊天控制項的語言。

**`asyncIdentifier`**   void\*\
*選用*

選用的應用程式定義指標大小內容值，可用來將完成狀態變更與此呼叫相關聯。

### 傳回值

PartyError

`c_partyErrorSuccess` (如果設定轉譯選項的非同步作業已開始)，否則為錯誤碼。如果此方法失敗，將不會產生任何相關的狀態變更。可透過 [PartyManager::GetErrorMessage()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md) 擷取錯誤碼的人類可讀形式。

## 備註

轉譯是產生代表語音聊天中口語片語之字串的程序。透過 `options` 指定的選項，會指定應產生這些轉譯字串的聊天控制項，這些字串隨後會透過 [PartyVoiceChatTranscriptionReceivedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyvoicechattranscriptionreceivedstatechange.md) 提供給本機聊天控制項。 \
\
 只有透過 [PartyLocalDevice::CreateChatControl()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol.md) 設定為使用支援轉譯之語言的聊天控制項才會提供轉譯。   \
\
 語音轉文字轉譯功能在內部會使用可用的區域和延遲測量估計值來最佳化服務使用量。如果使用 [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyoption.md) 選項將更新模式設定為 [PartyRegionUpdateMode::Deferred](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)，則可能尚未開始擷取可用區域集合並測量與其之間的連線品質，或上次更新可能已超過設定的重新整理間隔時間。如果本機裝置目前未連線或未正在連線到任何網路，且應用程式指定的選項旗標包含 [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md)，則 SetTranscriptionOptions() 會確保任何延後的區域更新已開始，且相關聯的 [PartyRegionsChangedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md) 會在此呼叫的 [PartySetTranscriptionOptionsCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange.md) 完成之前提供。

## 需求

**標頭：** Party.h

## 另請參閱

[PartyLocalChatControl](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol.md)


## Related topics

- [PartyLocalDevice::CreateChatControl](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol.md)
- [PartyLocalChatControl::GetLanguage](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md)
- [PartyVoiceChatTranscriptionOptions](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md)
- [PartySetTranscriptionOptionsCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange.md)
- [PartyVoiceChatTranscriptionReceivedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyvoicechattranscriptionreceivedstatechange.md)