How to launch into an immersive space in VisionOS

Update the info.plist to allow for immersive experiences and configure your immersive space in the app.

Oscar de la Hera Gomez
Written by Oscar de la Hera Gomez
First published on 08/12/2024 at 11:19
Last Updated on 08/12/2024 at 11:53
<p>A flower that represents VisionOS with the text “Immersive Experiences” beneath it.</p>

Update the info.plist to allow for immersive experiences and configure your immersive space in the app.

SubscribeWhat is a Space in Spatial Computing?What is Immersion in Spatial Computing?

The code for this tutorial can be found in the repository linked below on the 101/open-in-immersive-style-starter branch.

Download Open Source VisionOS Project

The fundamentals for this tutorial were taken from Apple's WWDC Go Beyond the Window with SwiftUI.

Go Beyond the Window with SwiftUI

Step One: Setup the Immersive Space

<p>A screenshot of the VisionOS Simulator showing the immersive space.</p>

Follow the tutorial below to learn how to trigger the activation of immersive spaces from a window.

How to create an app that allows immersion in VisionOS

Step Two: Update the plist

<p>A screenshot of XCode showing the plist. We have highlighted the elements that must be changed. These are listed below.</p>

In the info.plist file: 

  • Set the Preferred Default Scene Session Role to Immersive Space Application Session Role.
  • In the Scene Configuration, add a new array called Immersive Space Application Session Role and in its first item set the Initial Immersion Style to Mixed Immersion (or Progressive or Full).

Please note that the style set in "Initial Immersion Style" must match the style set in the app.

Step Three: Update the App

<p>A screenshot of XCode showing the updated App file. Inside the body sits only the immersive scene.</p>

In the App, update the scene to be set to the initial style set in Step Two.

You can also remove the window as it is no longer needed. That said, Apple requires a way for the app to be open and close the app - windows are normally used for this.

To learn how to add multiple immersive styles to an immersive space, consult the link below.

How to create spaces with multiple immersion styles in VisionOS

Step Four: Test

<p>A screenshot of the simulator showing how the app launched into the immersive space.</p>

Run the app and confirm it launches into an immersive space.

Looking to learn more about VisionOS, Spatial Computing, Design and Technology?

Search our blog to learn more about visionOS, spatial computing, design and technology.

Search our Blog

Any Questions?

We are actively looking for feedback on how to improve this resource. Please send us a note to inquiries@delasign.com with any thoughts or feedback you may have.
SubscribeContact UsVisit our BlogView our ServicesView our Work

Partner with us

We would love to get to know you and see how we can help your organization with its goals and needs.
Let's Talk

Stay Informed

Get occasional updates about our company, research, and product launches.
Subscribe