Use the XR Plug-in Management settings to configure XR support in a Unity project.
These settings let you choose which platforms and devices the project can target. After you have enabled an XR plug-in, you can find settings for that plug-in in its own section underneath XR Plug-in Management.
The XR Plug-in Management section of the Project Settings
The XR Plug-in Management settings:
标签 | 设置 | 目的 |
---|---|---|
A | Build target tabs | A tab is shown for each platform build target installed for the current Unity Editor. You can add additional platform support modules with the Unity Hub. |
B | Initialize XR on Startup | Whether the game or application should start in XR mode immediately. If disabled, then your application logic is responsible for initializing XR at the appropriate time. For example, your app could start with a normal desktop display and then switch to XR on demand. See Automatic XR loading for more information. |
C | Plug-in Providers | The list of known XR provider plug-ins. This list contains the plug-ins officially supported by Unity or its strategic partners as well as any third-party provider plug-ins you have installed with the Package Manager. When you enable a provider plug-in, Unity adds the associated package to the project if it is not already installed. Disabling a plug-in does not remove the package. (You can remove packages with the Package Manager.) |
D | Provider plug-in settings | The settings for each installed XR provider plug-in appear in their own pages within the XR Plug-in Management section. For information about the available settings for a specific plug-in refer to that plug-in’s documentation. You can find a list of plug-ins and links to their documentation in Provider plug-ins. |
E | Project Validation | Displays the results of project validation checks for the plug-ins you have enabled. To view the checks, select the Project Validation page inside the XR Plug-in Management section of your Project Settings. |
E | XR Simulation settings | The AR Foundation package provides an XR Simulation feature, which lets you test AR Scenes in the Unity Editor. See XR Simulation project settings for a description of these settings and options. |
The project validation system helps you avoid common scene and project configuration issues for the XR packages you have installed. The XR packages you have installed can include rules for the validation system. The system evaluates these rules when you make a build and whenever you have the Project Validation window open. To open the window, go to your project settings (menu: Edit > Project Settings) and then select Project Validation in the XR Plug-in Management section. The rules are checked per platform build target. Some rules may examine the current scene to verify that the project settings support features used in that scene.
The Project Validation section of the XR Plug-in Management settings
属性 | 描述 |
---|---|
Platform tabs | The validation checks for each platform are grouped by platform. You can select a platform tab to view the validation checks for that platform. |
Issue list | The list of issues found in the project when evaluating the rules. Each issue has a severity level, description, and action button. |
Show all | Select to show all issues, regardless of severity. Issues marked with a green check indicate validation checks that passed and do not require any action. Successful checks are only displayed when you enable Show all. |
Ignore build errors | Select to ignore build errors. This option can sometimes be useful when debugging build problems. |
Fix all | Click to correct all issues that have a fix available. |
Tip: If the issue has scene objects associated with it, you can click on the message to select or highlight these objects in the Unity Editor.
The status icons to the left of an individual validation issue indicate the status and severity of the issue.
状态 | info |
---|---|
![]() |
Validation passed because the project and scene are either set up correctly, or the rule is not applicable. Successful checks are hidden in the project validation issue list unless you enable the Show all option. |
![]() |
Validation failed, but does not block building the project. You can safely ignore these if you have set up your project differently than recommended. |
![]() |
Validation failed and will block building the project. These issues cannot be ignored. You must fix them in order to build the project. |
The Fix button automatically fixes the issue in your project or Scene. The Edit button takes you to the appropriate place in the Unity Editor where you can correct the issue in your project. Both the Fix and Edit buttons provide a tooltip explaining the steps to manually correct the issue.
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.