Requirements

Unity Version Support

The visionOS and PolySpatial 2.x packages are compatible with Unity 6 (6000.22f1 or newer) for Apple Silicon

For Unity 2022.3 support, please refer instead to the 1.x packages (2022.3.18f1 or newer). Unity visionOS Support is not compatible with earlier LTS versions of Unity.

Please ensure to include visionOS Build Support module when installing the Unity Edtior.

Xcode and visionOS version

This package is compatible with:

  • Xcode 16 beta 1 or newer
  • visionOS 2.0 SDK or newer
Note

In some cases, you might need to use xcode-select --switch <path/to/Xcode.app> to specify the Xcode installation that Unity should target when building. If the path to Xcode is within /Applications or another protected folder, you may need to run the command as root.

Hardware

  • An Apple Silicon Mac is currently required for development.
  • If you do not have access to Apple Vision Pro, you can also develop with the visionOS simulator included with compatible versions of Xcode (16 beta 1 or newer).

For more information about setting up your development environment, refer to Development & Iteration.

Graphics

For RealityKit applications, Unity delegates all rendering to the platform so that the OS can provide the best performance, battery life, and rendering quality while taking into account all RealityKit applications that are running concurrently. This imposes significant constraints on the graphics features that are available. While we are constantly working to improve visual equivalency between Unity and RealityKit, there will likely be some visual differences.

Note that rendering for Virtual Reality (Fully Immersive) applications and Windowed applications is managed by Unity. In Hybrid mode, you can switch between, or even combine, rendering with Unity and RealityKit.

Render pipeline

While your project can use either the Universal Render Pipeline (URP) or the Built-in Render Pipeline, we recommend using URP when developing for visionOS. Features like Foveated Rendering for Metal and Stereo Render Targets will only be compatible with URP. Refer to our Migration guide to move from the Built-in pipeline to URP: Move on over to the Universal Render Pipeline with our advanced guide | Unity Blog.

Color space

Your project must use Linear color space.

Shaders and Materials

You can author custom shaders for visionOS using a subset of the Unity ShaderGraph. Behind the scenes, this is converted to MaterialX. ShaderLab and other custom coded shaders are not supported, as RealityKit for visionOS doesn't expose a low-level shading language.

Several important standard shaders for each pipeline have been mapped to their closest available RealityKit analog. Current support includes:

  • Standard URP shaders: Lit, Simple Lit, Unlit, and shaders for sprites, UI, and particles.
  • Standard Builtin shaders: Standard, Standard(Specular), and shaders for sprites, UI, and particles.

For more information, see PolySpatial Material Support.

Additional Information

For the latest list of features, fixes and changes, please refer to our changelog.

For more information about feature compatibility, please refer to the section on Supported Unity Features & Components.

For information about materials supported on this platform, see PolySpatial Material Support, and Shader Graph Support for details about implementing custom shaders via Unity Shader Graph and MaterialX.