Integration Testing

​

Why Integration Testing is Important

• The LIV SDK is correctly installed and configured.
• Mixed Reality capture works as expected in both editor and packaged builds.
• Advanced features like transparency, global clipping planes, and Meta Presence Platform functionality are fully operational.
• Performance and compatibility meet project requirements.

​

Preparation for Testing

​

Prerequisites

1. LIV SDK Installed:
   • Follow the steps outlined in Installing and Configuring the LIV SDK.
2. Meta Fork (Optional):
   • If using Meta-specific features, ensure the Meta Fork is installed and configured (see Meta Fork Specifics).
3. Hardware Setup:
   • Connect a SteamVR-compatible devices (Oculus Quest, HTC Vive, Valve Index, etc)
4. Packaging Configuration:
   • Ensure the project is set up for Windows 64-bit builds and uses DirectX 11 (mandatory for LIV).

​

Testing in the Editor

​

Step 1: Enable VR Preview

1. Launch your project in Unreal Editor.
2. Open the VR Preview mode:
   • Go to Play > VR Preview in the toolbar.

3. Verify that:
   • The LIV plugin is active.
   • Your VR headset is correctly tracked and rendering.

​

Step 2: Test MR Settings

1. Navigate to Edit > Project Settings > Plugins > LIV.
2. Adjust the following settings to test different MR features:
   • Capture Method:
     • Test the different capture methods :
       • ULivCaptureSingle
       • LivCaptureBackgroundTransparency
       • LivCaptureGlobalClipPlaneNoPostProcess
       • LivCaptureGlobalClipPlanePostProcess
       • LivCaptureMulti
   • Transparency:
     • Enable transparency and test with translucent materials in the scene.

• Toggle the background-only setting to verify its behavior.

​

Step 3: Test Meta Presence Platform Features

1. Enable Passthrough, Scene API, and Spatial Anchors in Project Settings > Meta XR.
2. Use sample scripts from Meta’s documentation to validate these features in the editor.

​

Testing in Packaged Builds

​

Step 1: Package the Project

1. Open your Unreal Engine project.
2. Go to File > Package Project > Windows.
3. Choose an output directory for the packaged build.
4. Verify that:
   • The build configuration is set to Development or Shipping.
   • The Default RHI is set to DirectX 11 in Project Settings > Platforms > Windows.

​

Step 2: Test with the LIV App

1. Download the LIV App:
   • Follow the setup instructions here: LIV App Guide.
2. Launch the Packaged Build:
   • Run the .exe file generated during packaging.

3. Open the LIV App:

• Start the LIV App and verify it detects your packaged application.

4. Test MR Output:
   • Select Mixed Reality Capture mode in the LIV App.
   • Validate the MR output in both automatic and manual launch modes:
     • Automatic: The LIV App detects the game automatically.
     • Manual: Manually select the .exe file in the LIV App.

​

Step 3: Validate Transparency and Global Clip Planes

1. Ensure the following are active in your build:
   • Transparency:
     • Verify translucent objects render correctly in the MR output.
   • Global Clip Plane:
     • Test scenes with clipping planes and ensure objects are composited properly.

​

Performance Testing

​

Step 1: Monitor Frame Rates

1. Use the Unreal Engine Stat Unit and Stat FPS commands to monitor frame rates.
2. Ensure that enabling MR capture does not cause significant performance degradation.

​

Step 2: Test on Target Hardware

1. Deploy the packaged build to a system with your target VR headset.
2. Validate that performance remains consistent across different hardware setups.

​

Tips for Successful Testing

1. Use Command-Line Logs:
   • Launch the packaged application with the log flag to view detailed runtime logs. "[GamePath]\MyGame.exe" -log
2. Simplify the Test Scene:
   • Use a minimal scene for initial testing to isolate MR capture issues.
3. Verify Engine Settings:
   • Double-check all relevant settings in Project Settings, especially under Plugins > LIV and Platforms > Windows.