Blueprint Playback

Persona playback setup

1. Create or open a Blueprint actor or character that should speak.
2. Add the ElevenLabs Persona Component.
3. Create an ElevenLabs Persona Mapping Data asset.
4. Add entries for each line. Each entry needs an Audio ID, a SoundWave or sound asset, and optionally a facial animation asset.
5. Assign the mapping data asset to the component.
6. Set the default face mesh component name if your character uses a specific face component.
7. In Blueprint, call Play Persona Cue By Id with the Audio ID you want to play.

Try the example project

The separate example demonstrates saved-audio playback with original test tones. It does not include generated speech, a MetaHuman or face animation, and this playback exercise needs no API key.

1. Install the matching plugin separately, then open EVSExample.uproject in Unreal Engine 5.8.2 on Windows, matching the supplied example binaries.
2. Open /Game/ElevenLabsExample/Maps/L_VoiceStudioExample if it is not already the startup map.
3. Press Play and click inside the viewport. Press 1 for the ascending Hello tone, 2 for the descending Reply tone, or Space to stop playback.
4. Stop Play and open /Game/ElevenLabsExample/Data/DA_OriginalToneCues. Change an entry's Volume Multiplier or Pitch Multiplier, save, and play that cue again to compare.
5. Replace an entry's Audio with your own saved SoundWave. Keep the Hello and Reply IDs to use the example's existing key bindings.

The map actor Voice Studio runtime example exposes Cue Mappings and Persona. Its initial audio assets are SW_ToneHello and SW_ToneReply.

Blueprint-callable actions

The default face component name is Face. Facial playback switches that component to single-animation mode; default stop behavior restores its prior animation mode. Use compatible saved animation and test alongside your character's animation Blueprint.