Skip to main content

​
Recording Issues

Symptoms: StartRecording() returns but no recording begins.Solutions:
  1. Verify the Tracking ID is set in Project Settings
  2. Ensure a valid SceneCaptureComponent2D is registered
  3. Check log for errors: LogLCK, LogLCKEncoding
// Verify capture component is registered
if (!Service->IsInitialized())
{
    UE_LOG(LogTemp, Error, TEXT("Service not initialized"));
}
Symptoms: Recording ends without calling StopRecording().Solutions:
  1. Check OnRecordingError delegate for error messages
  2. Verify disk space is available
  3. Check for encoder errors in LogLCKEncoding
Service->OnRecordingError.AddDynamic(this, &AMyActor::HandleError);
void AMyActor::HandleError(FString Message, int32 Code)
{
    UE_LOG(LogTemp, Error, TEXT("Recording error %d: %s"), Code, *Message);
}
Symptoms: Recording looks blurry or has artifacts.Solutions:
  1. Increase video bitrate in recording settings
  2. Use a higher quality profile (HD, 2K, 4K)
  3. Check render target resolution matches recording resolution
// Ensure settings match your quality needs
Service->ApplyRecordingSettings(
    1920, 1080,  // Match render target
    30,
    12000000,    // HD default bitrate
    256000,
    48000
);
Symptoms: Recording file is black but audio works.Solutions:
  1. Verify SceneCaptureComponent2D is capturing
  2. Check capture component has a valid render target
  3. Ensure capture component is enabled and visible
// Verify capture is working
CaptureComponent->bCaptureEveryFrame = true;
CaptureComponent->CaptureScene();

​
Audio Issues

Symptoms: Video records but audio is silent.Solutions:
  1. Verify audio plugins are enabled
  2. Check that audio sources are registered
  3. Ensure audio permissions are granted (Android)
// Check audio sources
TArray<ILCKAudioSource*> Sources;
IModularFeatures::Get().GetModularFeatureImplementations<ILCKAudioSource>(
    ILCKAudioSource::GetModularFeatureName(), Sources);

if (Sources.Num() == 0)
{
    UE_LOG(LogTemp, Warning, TEXT("No audio sources!"));
}
Symptoms: Audio has crackling, popping, or pitch issues.Solutions:
  1. Check sample rate matches between source and encoder
  2. Verify buffer sizes are adequate
  3. Check for CPU overload
// Match sample rates
int32 SourceRate = ULCKUnrealAudioBPL::GetUnrealAudioSamplerate();
Params.Samplerate = SourceRate;  // Must match
Symptoms: Game audio records but no microphone.Solutions:
  1. Check SetMicrophoneEnabled(true) is called
  2. Verify microphone permissions (Android)
  3. Check if another app is using the microphone
// Ensure mic is enabled
Service->SetMicrophoneEnabled(true);

// Verify
if (Service->IsMicrophoneEnabled())
{
    UE_LOG(LogTemp, Log, TEXT("Mic enabled"));
}

​
Platform Issues

Symptoms: Recording fails on Android devices.Solutions:
  1. Ensure Vulkan is enabled — OpenGL ES is not supported for video encoding
  2. Remove OpenGL ES from your project’s graphics API list
  3. Check device supports hardware H.264 encoding
  4. Verify RECORD_AUDIO permission is granted at runtime
; AndroidEngine.ini
[/Script/AndroidRuntimeSettings.AndroidRuntimeSettings]
bEnableVulkanSM5Support=True
Symptoms: Recording fails with encoder initialization error.Solutions:
  1. Verify Windows Media Foundation is available
  2. Check GPU drivers are up to date
  3. Ensure AVCodecsCore plugin is enabled
Symptoms: Frame drops during recording on Quest.Solutions:
  1. Reduce recording resolution to HD (1080p) or SD (720p)
  2. Lower video bitrate
  3. Reduce framerate to 30 FPS (SD default)
  4. Vulkan must be enabled (required for encoding on Android)

​
UI Issues

Symptoms: UI buttons don’t register touches.Solutions:
  1. Verify collision profile is set correctly
  2. Check button is visible and enabled
  3. Verify interactor collision settings
// Ensure collision is set up
Button->CollisionBox->SetCollisionProfileName(
    FLCKConstants::UICollisionProfileName
);
Symptoms: UI components don’t appear.Solutions:
  1. Call Show() on showable components
  2. Check component is attached to visible actor
  3. Verify materials are loaded
// Make sure to show UI
Button->Show();

​
Plugin Issues

Symptoms: Plugin features unavailable at runtime.Solutions:
  1. Verify plugin is enabled in .uproject
  2. Check module dependencies in Build.cs
  3. Look for load errors in Output Log
// Verify in .uproject
{
  "Plugins": [
    { "Name": "LCK", "Enabled": true },
    { "Name": "LCKTablet", "Enabled": true }
  ]
}
Symptoms: Linker errors or undefined symbols.Solutions: Ensure all required modules are listed:
PublicDependencyModuleNames.AddRange(new string[] {
    "LCKCore",
    "LCKAudio",
    "LCKUI",      // If using UI
    "LCKTablet"   // If using tablet
});

​
Diagnostic Commands

​
Enable Verbose Logging

; DefaultEngine.ini
[Core.Log]
LogLCK=VeryVerbose
LogLCKEncoding=VeryVerbose
LogLCKAudio=VeryVerbose
LogLCKUI=Verbose
LogLCKTablet=Verbose

​
Runtime Diagnostics

void AMyActor::DiagnoseLCK()
{
    // Check subsystem
    auto* Subsystem = GetWorld()->GetSubsystem<ULCKSubsystem>();
    UE_LOG(LogTemp, Log, TEXT("Subsystem: %s"),
        Subsystem ? TEXT("OK") : TEXT("MISSING"));

    // Check service
    auto* Service = Subsystem ? Subsystem->GetService() : nullptr;
    UE_LOG(LogTemp, Log, TEXT("Service: %s"),
        Service ? TEXT("OK") : TEXT("MISSING"));

    // Check recorder
    auto* Recorder = GetWorld()->GetSubsystem<ULCKRecorderSubsystem>();
    UE_LOG(LogTemp, Log, TEXT("Recorder: %s"),
        Recorder ? TEXT("OK") : TEXT("MISSING"));

    // Check audio sources
    TArray<ILCKAudioSource*> Sources;
    IModularFeatures::Get().GetModularFeatureImplementations<ILCKAudioSource>(
        ILCKAudioSource::GetModularFeatureName(), Sources);
    UE_LOG(LogTemp, Log, TEXT("Audio sources: %d"), Sources.Num());
}

​
Getting Help

If you can’t resolve an issue:
  1. Enable verbose logging and capture the output
  2. Note the exact error message and conditions
  3. Join our Community Discord