<!--
{
  "availability" : [
    "iOS: 13.4.0 -",
    "iPadOS: 13.4.0 -",
    "macCatalyst: 14.0.0 -",
    "macOS: 27.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/SceneUnderstandingComponent",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation27SceneUnderstandingComponentV"
  },
  "title" : "SceneUnderstandingComponent"
}
-->

# SceneUnderstandingComponent

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

```
struct SceneUnderstandingComponent
```

## 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](/documentation/RealityKit/realitykit-scene-understanding).

## Topics

### Initializing a scene-understanding component

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

Creates a component that makes an entity aware of certain aspects of the
physical environment.

[`init(entityType: SceneUnderstandingComponent.EntityType?)`](/documentation/RealityKit/SceneUnderstandingComponent/init(entityType:))

Creates a component for the given entity type that makes an entity aware
of certain aspects of the physical environment.

### Managing the component

[`var entityType: SceneUnderstandingComponent.EntityType?`](/documentation/RealityKit/SceneUnderstandingComponent/entityType-swift.property)

The type of real-world objects that the component models.

[`enum EntityType`](/documentation/RealityKit/SceneUnderstandingComponent/EntityType-swift.enum)

Types of real-world objects that a scene-understanding component models.

### Instance Properties

[`var origin: SceneUnderstandingComponent.Origin`](/documentation/RealityKit/SceneUnderstandingComponent/origin-swift.property)

The origin that RealityKit creates the component from.

### Enumerations

[`enum Origin`](/documentation/RealityKit/SceneUnderstandingComponent/Origin-swift.enum)

Types of scene-understanding origins this component lives in.

## Relationships

### Conforms To

[`Component`](/documentation/RealityKit/Component)

---

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)