---
title: SceneUnderstandingComponent
framework: realitykit
role: symbol
role_heading: Structure
path: realitykit/sceneunderstandingcomponent
---

# SceneUnderstandingComponent

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

## Declaration

```swift
struct SceneUnderstandingComponent
```

## Mentioned in

Implementing scene understanding and reconstruction in your RealityKit app

## Overview

Overview Scene understanding refers to RealityKit features like physics collision, shadows, and occlusion with real-world geometry. In iOS, SceneUnderstandingComponent is a read-only component. Manually adding it doesn’t have any effect. In visionOS and macOS, SceneUnderstandingComponent is a write-only component. Add SceneUnderstandingComponent to your custom entities to let it behave as a virtual scene-understanding mesh. For more information about scene-understanding features, see Implementing scene understanding and reconstruction in your RealityKit app.

## Topics

### Initializing a scene-understanding component

- [init()](realitykit/sceneunderstandingcomponent/init().md)
- [init(entityType:)](realitykit/sceneunderstandingcomponent/init(entitytype:).md)

### Managing the component

- [entityType](realitykit/sceneunderstandingcomponent/entitytype-swift.property.md)
- [SceneUnderstandingComponent.EntityType](realitykit/sceneunderstandingcomponent/entitytype-swift.enum.md)

### Instance Properties

- [origin](realitykit/sceneunderstandingcomponent/origin-swift.property.md)

### Enumerations

- [SceneUnderstandingComponent.Origin](realitykit/sceneunderstandingcomponent/origin-swift.enum.md)

## Relationships

### Conforms To

- [Component](realitykit/component.md)

## See Also

### Scene reconstructions and analysis

- [Creating a game with scene understanding](realitykit/creating-a-game-with-scene-understanding.md)
- [Implementing scene understanding and reconstruction in your RealityKit app](realitykit/realitykit-scene-understanding.md)
- [Visualizing and interacting with a reconstructed scene](arkit/visualizing-and-interacting-with-a-reconstructed-scene.md)
- [sceneReconstruction](arkit/arworldtrackingconfiguration/scenereconstruction.md)
- [supportsSceneReconstruction(_:)](arkit/arworldtrackingconfiguration/supportsscenereconstruction(_:).md)
- [ARView.Environment.SceneUnderstanding](realitykit/arview/environment-swift.struct/sceneunderstanding-swift.struct.md)
- [ARView.Environment.SceneUnderstanding.Options](realitykit/arview/environment-swift.struct/sceneunderstanding-swift.struct/options-swift.struct.md)
- [HasSceneUnderstanding](realitykit/hassceneunderstanding.md)
- [SceneReconstructionProvider](arkit/scenereconstructionprovider.md)
- [ARSession](arkit/arsession.md)