https://github.com/unity-technologies/xracceptancetests

This project is used to verify behavior of Unity configurations, compare features between Unity releases, and test for changes in performance.
https://github.com/unity-technologies/xracceptancetests

unity unity-3d unity3d vr xr

Last synced: 3 months ago
JSON representation

This project is used to verify behavior of Unity configurations, compare features between Unity releases, and test for changes in performance.

• Host: GitHub
• URL: https://github.com/unity-technologies/xracceptancetests
• Owner: Unity-Technologies
• License: other
• Created: 2018-08-09T16:30:18.000Z (over 6 years ago)
• Default Branch: xrsdk-2019.3
• Last Pushed: 2021-01-05T10:04:31.000Z (about 4 years ago)
• Last Synced: 2024-10-07T09:48:44.543Z (3 months ago)
• Topics: unity, unity-3d, unity3d, vr, xr
• Language: C#
• Homepage:
• Size: 860 MB
• Stars: 35
• Watchers: 8
• Forks: 6
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Unity XR Acceptance Tests

This project is used to test Unity’s XR features. Tests in this project are designed to be simple and platform agnostic. The behavior of specific features can be targeted by isolating the systems under test, therefore the scenes have been constructed to limit interaction between different systems and components. Furthermore, display and input systems have been implemented in a generic way so that the project does not rely on the platform specific features of plugins. The project should be used to verify behavior of player configurations, compare features between Unity releases, and test for changes in performance.

Full documentation including comparison images and expected results for all tests are included in the repo as XRAssessmentDocumentation.pdf

  

## XR SDK Setup

See https://forum.unity.com/threads/xr-plugins-and-subsystems.693463/ for instructions.

## Test Scenes

 - Materials

 - Baked Lighting

 - Real-time Lighting

 - Effects

 - Terrain

 - Canvas

 - API Checks

 - Performance

 - Input

## Configurations

These tests are designed to be run in the built-in renderer with multi-pass, single-pass, and single-pass instanced stereo rendering modes. Scenes should be tested to make sure they are displayed the same in the left eye, right eye, Editor GameView, and the player’s standalone mirror (if applicable). All combinations of settings supported by the target platform should be tested:

**Stereo Rendering Modes**

 - Multi Pass

 - Single Pass

 - Single Pass Instanced

**Graphics APIs**

 - Direct3D11

 - Direct3D12 (Experimental)

 - OpenGL

 - Vulkan

 - OpenES2

 - OpenES3

 - Metal

**Players**

 - Editor

 - Standalone

  

## Building

Tests can be run manually in the editor or in a built player. Batch building functionality has been included in this project to provide an easy-to-use script and build configuration system that can build a common set of configurations for testing. In addition, this system allows for multiple build configurations to be built at once to reduce overhead of managing multiple test build configurations. Finally, utilization of the batch builds will maintain a consistent set of build settings across test passes to reduce configuration errors.

**Usage**

The build scripts located in the root of this project are available to build the most common configurations of the project for testing across supported platforms. Scripts are available for Windows (.bat) and macOS (.command) in the BuildScripts folder. A Build Windows UI is available in the Editor to run batch builds and allow customization of the build configurations

Pass the location of the Unity executable to run from the command line:

  

**Windows Example:**

    BuildWindows.bat 

  

**MacOS Example:**

    BuildmacOS.command /Content/Unity...

  

The builds will be located in:

  

    \Builds\\\-

  

For example,

    ...\Builds\StandaloneWindows64\Oculus\Instancing-Direct3D11.exe

    

    ...\Builds\StandaloneWindows64\Oculus\MultiPass-Direct3D11.exe

## Scene Navigation

Gaze based controls have been implemented for scene navigation to allow the project to run on a variety of platforms without platform specific input dependencies. Gaze at the gray arrows in any scene to transition to the next or previous scene. The arrows will progressively fill for several seconds as long as gaze focus is maintained. The scene will transition once the arrow is completely filled.