docs.unity3d.com
    Show / Hide Table of Contents

    Project setup

    To enable the Meta OpenXR Feature in your project, follow the steps below:

    1. Go to Edit > Project Settings... > XR Plug-in Management.
    2. In the Android tab, under Plug-in Providers, enable OpenXR.
    3. While still in the Project Settings window, go to XR Plug-in Management > OpenXR.
    4. In the Android tab, under Interaction Profiles, add Oculus Touch Controller Profile.
    5. Under OpenXR Feature Groups, enable the Meta Quest feature group.
    Note

    XR Plug-in Management supports only one enabled plug-in provider at a time per build target. If your project also targets ARCore using the Google ARCore XR Plug-in, to avoid errors you should disable the Google ARCore plug-in provider before you build an APK for Meta Quest devices. Likewise, you should disable OpenXR before you build for ARCore.

    Scene setup

    To set up your scene for Meta OpenXR, first follow the standard AR Foundation scene setup. If your scene will use the Meta Quest device's Passthrough camera, see the additional information below.

    Ensure that the Tracked Pose Driver component on your camera is has "centerEyePositon [XR HMD]" included in the position and rotation input actions.

    Camera clear flags

    Meta Passthrough requires that your Camera's Clear Flags are set to Solid Color, with the Background color alpha channel value set to zero.

    If you have completed AR Foundation scene setup, follow these instructions to set your Camera's Clear Flags:

    • Your GameObject hierarchy should contain a GameObject named XR Origin. Expand its children to reveal the Camera Offset and Main Camera GameObjects.
    • Inspect the Main Camera GameObject.
    • The Camera component's Clear Flags should already be set to Solid Color. Select the Background color to open the color picker.
    • Set the color's A value to 0.

    Your scene is now configured to support Meta Passthrough.


    Did you find this page useful? Please give it a rating:

    Thanks for rating this page!

    Report a problem on this page

    What kind of problem would you like to report?

    • This page needs code samples
    • Code samples do not work
    • Information is missing
    • Information is incorrect
    • Information is unclear or confusing
    • There is a spelling/grammar error on this page
    • Something else

    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.

    In This Article
    • Scene setup
      • Camera clear flags
    Back to top
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023