docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Boundary visibility

    The Meta Quest Boundary Visibility feature enables you to suppress the visibility of the boundary so users can move freely with Passthrough enabled.

    A Meta Quest 3 screenshot shows a Passthrough image of a room with a system warning displayed. The warning reads, "Return to your boundary"
    When boundary visibility isn't suppressed, the system may warn the user when they leave the boundary.

    Enable the boundary visibility feature

    To enable boundary visibility in your app:

    1. Go to Project Settings > XR Plug-in Management > OpenXR.
    2. Select either the Windows, Mac, Linux settings tab to configure Quest Link on Windows, or the Android settings tab to configure builds.
    3. Under the OpenXR Feature Groups heading, select the Meta Quest feature group.
    4. If disabled, enable the Meta Quest: Boundary Visibility OpenXR feature.

    Meta Quest feature group in the Unity Editor
    The Meta Quest feature group, shown with all features enabled.

    Suppress boundary visibility automatically

    If your app is a free-roaming passthrough experience, you might want to hide the boundary when your app starts. Enable the Suppress Visibility setting to automatically hide the boundary.

    Access the Suppress Visibility setting by selecting the gear icon next to the Meta Quest: Boundary Visibility feature, as shown in the following image:

    Suppress visibility
    Supress Visibility setting.

    The boundary remains invisible for the lifetime of the OpenXR loader unless you take further action.

    Important

    Boundary visibility can only be suppressed if Passthrough is rendered to the screen.

    If your app enables Passthrough sometime after it starts, refer to the following section to change boundary visibility at runtime.

    Change boundary visibility at runtime

    Use the BoundaryVisibilityFeature scripting API to control the exact timing of when your app requests to change boundary visibility, and receive notifications when boundary visibility changes. Refer to the following example code to understand how to change boundary visibility:

    var feature = OpenXRSettings.Instance.GetFeature<BoundaryVisibilityFeature>();
    var result = feature.TryRequestBoundaryVisibility(
        XrBoundaryVisibility.VisibilitySuppressed);
    
    if ((int)result ==
        BoundaryVisibilityFeature.XR_BOUNDARY_VISIBILITY_SUPPRESSION_NOT_ALLOWED_META)
    {
        // The runtime did not accept the request to suppress the boundary.
        // Your app must render passthrough to suppress boundary visibility.
    }
    
    if (result < 0)
    {
        // XrResult values less than zero are errors.
        // Handle error here.
    }
    
    In This Article
    Back to top
    Copyright © 2025 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)