# Creating an immersive space in visionOS Enhance your visionOS app by adding an immersive space using RealityKit. ## Overview This sample code project demonstrates how to create an in visionOS, showcasing a collection of rocks orbiting around a person, like the scene in the following video:  The `TurnTableSystem` runs the core functionality to manage the rotational dynamics of entities through the `TurnTableComponent`, which defines the speed and rotation axis. The `Entity` class extends with a method to populate the immersive space with 3D rock entities and then apply a random transformation to create a halo effect. The `ImmersiveView` integrates these features and showcases the potential of SwiftUI and RealityKit to build an exciting augmented reality experience. ### Create the turntable system The sample creates a custom system and corresponding component to apply a series of random rotations to the content in the immersive environment, resulting in a collection of objects that orbit around a person. ```swift import SwiftUI import RealityKit struct TurnTableComponent: Component { /// The duration of the orbit effect. var time: TimeInterval = 0 /// The speed at which the entity moves over time. var speed: TimeInterval /// The axis that the object orbits around. var axis: SIMD3 /// Initialize the turntable component by setting the speed and axis variables. init(speed: TimeInterval = 1.0, axis: SIMD3 = [0, 1, 0]) { self.speed = speed self.axis = axis } } ``` The `TurnTableComponent` stores the time, speed, and axis information that decides how each of the entities rotates over time. The `TurnTableSystem` checks the current scene for any rendered content that contains a `TurnTableComponent`. If it detects the component, the system applies the value of `deltaTime` to the component’s `time` value and sets the orientation value to the component’s `axis` variable. ```swift import SwiftUI import RealityKit struct TurnTableSystem: System { /// A value to check whether the entity has the required component. static let query = EntityQuery(where: .has(TurnTableComponent.self)) /// Initialize the system with the RealityKit scene. init(scene: RealityKit.Scene) { } // Update the entities to apply the time value and orientation. func update(context: SceneUpdateContext) { // Iterate over entities that match the query and are currently rendering. for entity in context.entities(matching: Self.query, updatingSystemWhen: .rendering) { /// The variable to get the `TurnTableComponent` from the entity. var comp = entity.components[TurnTableComponent.self]! // Set the time variable to increase as time passes. comp.time += context.deltaTime // Update the component in the entity. entity.components[TurnTableComponent.self] = comp // Adjust the orientation to update the angle, speed, and axis of rotation. entity.setOrientation(simd_quatf(angle: Float(0.1 * comp.speed), axis: comp.axis), relativeTo: entity) } } } ``` ### Extend the entity class The sample extends the class to load a file as a model component and apply the model for the halo effect. ```swift import RealityKit extension Entity { /// The name of the 3D model resource file. static var fileName: String = "rock" /// The model component loads a given filename. static var rockModel: ModelComponent = { let rock = try! Entity.loadModel(named: fileName) return rock.model! }() //... } ``` To create a halo effect, the sample extends the `Entity` class with a custom method called `addHalo()`. The method loops through the total number of rocks that the app creates, and makes an array of entities with random size, speed, and rotation. ```swift import RealityKit extension Entity { // ... /// Assign a series of random rotations, translations, and scales for each rock model. func addHalo() { /// The number of models to generate. let modelCount: Int = 50 // Create each model and apply a random transform, scale, and time interval. for _ in 0.. instance property to call the immersive space that the `Immersion` app structure defines. ```swift import SwiftUI struct MainView: View { /// The environment value to get the `OpenImmersiveSpaceAction` instance. @Environment(\.openImmersiveSpace) var openImmersiveSpace var body: some View { // Displays a line of text and // opens a new `ImmersiveSpace` environment. Text("Immersive Content Example") .onAppear { Task { await openImmersiveSpace(id: "ImmersiveScene") } } } } ``` ## See Also #### Related samples [Creating an interactive 3D model in visionOS](/documentation/visionOS/creating-an-interactable-3d-model-in-visionos) Display an interactive car model using gestures in a reality view. #### Related articles --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)