Troubleshooting#

General Troubleshooting#

From Unreal Editor, you can view log messages with Window > Output Log. Filter the log messages on LogACE to see messages specifically from the NVIDIA ACE plugin. This shows you warnings or errors for common mistakes, such as not setting Loading Behavior Override to ForceInline on a Sound Wave asset’s properties. If you receive no audio or facial animation at all, check the log to see if the usual sequence of log messages has occurred. Logs for a typical Audio2Face animation sequence are similar to this:

LogACERuntime: sending A2F asset SoundWave /Game/Audio/SampleInput.SampleInput
LogACERuntime: [ACE SID 0] Started A2F session at http://203.0.113.44:52000
LogACEA2FRemote: Connected to a2f service at URL:"http://203.0.113.44:52000"
LogACERuntime: start playing audio on BP_Maria_C /Game/Maps/UEDPIE_0_ACETestMap.ACETestMap:PersistentLevel.BP_Maria_C_2
LogACERuntime: [ACE SID 0] begin animation on BP_Maria_C /Game/Maps/UEDPIE_0_ACETestMap.ACETestMap:PersistentLevel.BP_Maria_C_2 at 0.000000
LogACERuntime: [ACE SID 0 callback] received 114 animation samples, 60800 audio samples for clip on BP_Maria_C /Game/Maps/UEDPIE_0_ACETestMap.ACETestMap:PersistentLevel.BP_Maria_C_2
LogACERuntime: [ACE SID 0] Sent 60371 samples to A2F
LogACERuntime: [ACE SID 0] End of samples
LogACERuntime: [ACE SID 0]: resetting animation on BP_Maria_C /Game/Maps/UEDPIE_0_ACETestMap.ACETestMap:PersistentLevel.BP_Maria_C_2

These messages are also written to the application’s log file. If you’re running in standalone mode or from a packaged build, search the log file for LogACE messages to help troubleshoot issues.

Failed to connect Error#

  • Verify that the URL is complete and correct. The server address must include scheme (http or https), host (IP address or hostname), and port number.

  • Try pinging the host. Make sure the host is accessible and available.

  • Make sure you are running the correct version of the service. The ACE Unreal plugin requires at least v1.0 of the Audio2Face service or v1.0.1 of the AnimGraph service.

Failed to connect log

Lip Corners Stretch Down Too Much in MetaHuman Facial Animations#

Verify that you are using the plugin’s mh_arkit_mapping_pose_A2F pose mapping. See Update the ARKit pose mapping and animation sequence section.

Lips Don’t Open Wide Enough in MetaHuman Facial Animations#

Verify that the default MetaHuman MouthClose animation is not active. See Bypass the default MetaHuman MouthClose animation section.

Project Settings Don’t Persist#

If your NVIDIA ACE project settings don’t seem to persist between Unreal Editor runs, it may be because something is corrupt in your machine’s local saved config files. Try deleting the project’s Saved\Config\WindowsEditor folder and starting the editor again.

Other Animation Synchronization Issues#

Extra logging is available for troubleshooting animation synchronization issues when communicating with NVIDIA ACE services like Audio2Face or AnimGraph. Enable Verbose or VeryVerbose logging in the LogACECore and LogACERuntime categories by passing the standard Unreal -logcmds command line option to your application. See https://dev.epicgames.com/documentation/en-us/unreal-engine/logging-in-unreal-engine#consolecommands for more details on -logcmds.

As an example, you could add this to your application command line: -logcmds=”LogACECore Verbose,LogACERuntime Verbose”

On this page