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

# PartyLocalChatControl::SetTranscriptionOptions

> Configures the transcription options associated with voice chat audio for this chat control.

Configures the transcription options associated with voice chat audio for this chat control.

## Syntax

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

### Parameters

**`options`**   [PartyVoiceChatTranscriptionOptions](/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions)

Options associated with voice chat transcription, such as which chat controls should generate transcriptions for the local chat control, and whether those transcriptions should be translated to the local chat control's language.

**`asyncIdentifier`**   void\*\
*optional*

An optional, app-defined, pointer-sized context value that can be used to associate the completion state change with this call.

### Return value

PartyError

`c_partyErrorSuccess` if the asynchronous operation to set the transcription options began, or an error code otherwise. If this method fails, no related state changes will be generated. The human-readable form of the error code can be retrieved via [PartyManager::GetErrorMessage()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage).

## Remarks

Transcription is the process of generating strings representing spoken phrases in voice chat. The options specified via `options` specify the chat controls that should generate these transcription strings, which are subsequently provided to the local chat control via [PartyVoiceChatTranscriptionReceivedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyvoicechattranscriptionreceivedstatechange)s. <br /><br /> Only chat controls configured to use a language that supports transcription, via [PartyLocalDevice::CreateChatControl()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol), will provide transcriptions.   <br /><br /> Speech-to-text transcription functionality internally uses available region and latency measurement estimates to optimize service usage. If the [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) option was used to configure an update mode of [PartyRegionUpdateMode::Deferred](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode), then retrieving the set of available regions and measuring connection quality to them may not have started yet, or the last update may have exceeded the configured refresh interval age. If the local device isn't currently connecting or connected to any networks, and the application specifies option flags that include [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions), then SetTranscriptionOptions() ensures any deferred region update has started and the associated [PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange) is provided prior to this call's [PartySetTranscriptionOptionsCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange) completion.

## Requirements

**Header:** Party.h

## See also

[PartyLocalChatControl](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol)


## Related topics

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