Skip to main content
Module: LCKFMOD | Version: 0.9.2 | Platforms: All

​
Overview

LCKFMOD provides integration with FMOD Studio, capturing game audio output for recording. This plugin hooks into the FMOD audio system to capture the final mixed output.

​
Supported Channels

ChannelSupportedDescription
GameYesFMOD Studio master bus output
MicrophoneNoUse LCKUnrealAudio or LCKOboe
VoiceChatNoUse LCKVivox

​
Requirements

LCKFMOD requires the FMODStudio plugin which must be downloaded separately from fmod.com. The LCKFMOD plugin is disabled by default and will not compile without FMODStudio installed.

​
Dependencies

// Add to your .Build.cs
PublicDependencyModuleNames.AddRange(new string[] {
    "LCKFMOD",
    "LCKAudio",
    "FMODStudio"
});

​
Automatic Integration

The plugin automatically:
  1. Detects FMOD Studio plugin presence
  2. Registers capture callback on the master bus
  3. Registers with the LCK audio system

​
Capture Point

LCKFMOD captures audio from the FMOD master bus after all mixing and effects processing: 
┌─────────────────────────────────────────┐
│          FMOD Studio System             │
├─────────────────────────────────────────┤
│  Events → Mixer → Effects → Master Bus  │
│                              ↓          │
│            DSP Tail Position (Capture)  │
└────────────────────────────┬────────────┘
                             │
                      ┌──────▼──────┐
                      │  LCKFMOD    │
                      │  Capture    │
                      └─────────────┘

​
Technical Details

​
DSP-Based Capture

The plugin uses FMOD’s DSP system to intercept audio non-destructively:
  • DSP attached at FMOD_CHANNELCONTROL_DSP_TAIL position
  • Audio callback runs on FMOD audio thread
  • Data is marshaled to game thread via AsyncTask
  • PCM format: 32-bit float, interleaved
// Audio data callback (simplified)
FMODSource->OnAudioDataDelegate.BindLambda([](
    TArrayView<const float> PCM,
    int32 Channels,
    ELCKAudioChannel SourceChannel)
{
    // PCM is interleaved float data
    // Callback runs on game thread after async marshaling
});

​
Configuration

​
Sample Rate

We recommend setting the sample rate explicitly to 48kHz rather than leaving it at 0 (auto): FMOD sample rate setting

​
Output Format

Set FMOD Output Format to Stereo. The default 5.1 surround is not supported at this time. FMOD output format
Voice chat and game audio must match in samplerate, otherwise audio distortion will occur in recordings.

​
Performance

LCKFMOD has minimal performance impact:
MetricImpact
CPU< 1% overhead
Memory~2MB buffer
Latency< 1 frame
FMOD’s audio processing is highly optimized. LCKFMOD adds negligible overhead to the existing audio pipeline.

​
Compatibility

FMOD VersionStatus
2.02.xSupported
2.01.xSupported
2.00.xSupported

​
Troubleshooting

  1. Verify FMOD Studio plugin is enabled
  2. Check that audio is playing through FMOD
  3. Verify master bus is not muted
  4. Check LogLCKFMOD for errors
  1. Check sample rate matches between FMOD and encoder
  2. Verify buffer sizes are adequate
  3. Check for CPU overload in FMOD profiler

​
Log Category

DECLARE_LOG_CATEGORY_EXTERN(LogLCKFMOD, Log, All);

​
See Also

Audio Overview

Audio system architecture

Wwise

Alternative middleware integration