<!--
{
  "documentType" : "article",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/ecs-scenes",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Scenes"
}
-->

# Scenes

The context that holds all RealityKit entities.

## Overview

The system adds an [`Entity`](/documentation/RealityKit/Entity) to a [`Scene`](/documentation/RealityKit/Scene) when you add it to a [`RealityView`](/documentation/RealityKit/RealityView) with
a [`RealityViewCameraContent`](/documentation/RealityKit/RealityViewCameraContent) or [`RealityViewContent`](/documentation/RealityKit/RealityViewContent) instance.
These scenes contain anchors and a hierarchy of entities that
make up your RealityKit content.

The [`Scene`](/documentation/RealityKit/Scene) instance has helpful methods to
perform ray casts to help you better understand your scene,
and methods that find entities either by name or by components they own.

## Topics

### Scene management

[`class Scene`](/documentation/RealityKit/Scene)

A container that holds the collection of entities that an AR view renders.

[`struct AnchorCollection`](/documentation/RealityKit/Scene/AnchorCollection)

A collection of anchor entities.

### Entity searches

[`struct QueryPredicate`](/documentation/RealityKit/QueryPredicate)

An object that defines the criteria for an entity query.

[`struct PixelCastHit`](/documentation/RealityKit/PixelCastHit)

### Event publishers and subscription

[`enum SceneEvents`](/documentation/RealityKit/SceneEvents)

Events the scene invokes.

[`struct Publisher`](/documentation/RealityKit/Scene/Publisher)

A publisher for the given event type in the scene.

### Scene reconstructions and analysis

[Creating a game with scene understanding](/documentation/RealityKit/creating-a-game-with-scene-understanding)

Create AR games and experiences that interact with real-world objects on LiDAR-equipped iOS devices.

[Implementing scene understanding and reconstruction in your RealityKit app](/documentation/RealityKit/realitykit-scene-understanding)

Detect real-world objects and surfaces to create precise AR interactions.

  <doc://com.apple.documentation/documentation/ARKit/visualizing-and-interacting-with-a-reconstructed-scene>

  <doc://com.apple.documentation/documentation/ARKit/ARWorldTrackingConfiguration/sceneReconstruction>

  <doc://com.apple.documentation/documentation/ARKit/ARWorldTrackingConfiguration/supportsSceneReconstruction(_:)>

[`struct SceneUnderstandingComponent`](/documentation/RealityKit/SceneUnderstandingComponent)

A component that specifies an entity is participating in the system’s scene-understanding features.

[`struct SceneUnderstanding`](/documentation/RealityKit/ARView/Environment-swift.struct/SceneUnderstanding-swift.struct)

An object that holds scene-understanding options for the view.

[`struct Options`](/documentation/RealityKit/ARView/Environment-swift.struct/SceneUnderstanding-swift.struct/Options-swift.struct)

Available scene-understanding options.

[`protocol HasSceneUnderstanding`](/documentation/RealityKit/HasSceneUnderstanding)

A specification that detects and reacts to features of the physical
environment.

  <doc://com.apple.documentation/documentation/ARKit/SceneReconstructionProvider>

  <doc://com.apple.documentation/documentation/ARKit/ARSession>


---

Copyright &copy; 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)