Troubleshooting

This guide covers common issues and their solutions.

Connection Issues

Cannot connect to server

Symptoms: Connection fails, timeout errors

Solutions:

1. Verify the server URL is correct (should start with wss:// or ws://)
2. Check your network connection
3. Ensure the server is running and accessible
4. Verify your JWT token is valid and not expired

Connection drops frequently

Solutions:

1. Check network stability
2. Check server logs for issues

Audio Issues

No audio being captured

Solutions:

1. Verify microphone permissions are granted
2. Check the correct audio device is selected
3. Ensure the AudioCapture component is started
4. Check audio levels in Windows/macOS settings

Audio has echo or feedback

Solutions:

1. Enable bEnableEchoCancellation on Chimera Audio Capture
2. Feed render audio via FeedRenderAudioFloat
3. Use headphones instead of speakers
4. Increase distance between mic and speakers

Audio quality is poor

Solutions:

1. Increase sample rate (48000 recommended)
2. Enable noise suppression
3. Check for bandwidth limitations

Lip Sync Issues

Lip sync not moving

Solutions:

1. Verify MetaHuman has a valid Face mesh component
2. Check that audio is being received (OnAudioDataReceived event firing)
3. Ensure RuntimeMetaHumanLipSync plugin is enabled
4. Verify face mesh component is found (check Output Log)

Lip sync is delayed

Solutions:

1. Check overall audio pipeline latency
2. Verify sample rates match (48000 Hz recommended)
3. Optimize other game systems

Lip sync looks wrong

Solutions:

1. Ensure MetaHuman has proper animation setup
2. Check audio quality (clear speech works best)
3. Verify correct face mesh is targeted

License Issues

"License Invalid"

Solutions:

1. Check for typos in license key
2. Verify key format: A9ZC-XXXX-XXXX-XXXX-XXXX
3. Contact support if issue persists

"License Expired"

Solutions:

1. Check expiration date
2. Renew your license
3. Contact sales for renewal options

"Trial Expired"

Solutions:

1. Purchase a full license
2. Contact support for trial extension if needed

Build Issues

Plugin fails to compile

Solutions:

1. Ensure Unreal Engine 5.4+ is installed
2. Check all dependencies are present
3. Clean and rebuild the project

Missing symbols on package

Solutions:

1. Ensure plugin is properly included in build
2. Check platform-specific settings
3. Verify all binary files are included

Getting Help

If you can't resolve your issue:

1. Check the documentation
2. Search existing issues
3. Contact [email protected] with:
   • Unreal Engine version
   • Plugin version
   • Error messages
   • Steps to reproduce