Contents

Previewing content and running simulations

Test and iterate on your scenes directly in Reality Composer Pro, with or without a linked Xcode project.

Overview

Reality Composer Pro lets you preview or simulate content on both real and virtual devices, with or without a linked Xcode project. You can iterate on your scene and build and run your app without leaving the editor.

[Image]

The Preview tab shows a preview of the currently selected entity you are working on. For example, you can preview any Reality Composer Pro entity in a simulated visionOS or Mac environment — this mode is suited for content creators who want to preview how their scenes look in real time. To test a scene with actual interactions, views, cameras, game controllers, and live code on a real or simulated device, you need to link your Xcode project first. See Linking an Xcode project to learn how.

Run simulations in the Reality Composer Pro Viewport

At the top of the Viewport, next to the Play icon, click Simulate to view a simulation in the Viewport.

Preview content on a connected device

At the top of the Viewport, next to the Play icon, click Simulate > Preview on Device. Then click Devices and select the device you want to preview on. If you need to connect an Apple Vision Pro, select Download Reality Composer Pro Preview for visionOS, then click Play.

Run simulations for Xcode linked projects

Once you have successfully linked an Xcode project, you can use Reality Composer Pro’s Simulator to preview your Xcode and Reality Composer Pro project as a compiled application on either a connected physical device or a simulated device.

Above the Viewport, click Running Destinations and then select a connected device or a simulated device.

Load scenes in your app’s view

You can load a Reality Composer Pro scene the same way you load a .usdz asset from your app bundle. Specify the Reality Composer Pro package bundle instead, in the make closure of a RealityView initializer.

Each Reality Composer Pro package defines a global constant that points to its bundle. The system creates the bundle name by appending “Bundle” to the end of the project’s name.

Xcode’s default visionOS template names the Reality Composer Pro project RealityKitContent and the global bundle variable realityKitContentBundle. The following code shows how to load the default bundle into a RealityView:

RealityView { content in
    if let scene = try? await Entity(named: "Biplane",
        in: realityKitContentBundle) {
        myDataModel.add(scene)
        content.add(scene)
    }
} update: { content in
    // ...
}

When RealityKit finishes loading the scene, the scene variable contains the root entity of the specified scene. RealityView adds this entity to content and displays it to the user.

See Also

Essentials