<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 13.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/BodyTrackedEntity",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation17BodyTrackedEntityC"
  },
  "title" : "BodyTrackedEntity"
}
-->

# BodyTrackedEntity

An entity used to animate a virtual character in an AR scene by tracking a
real person.

```
@MainActor @preconcurrency class BodyTrackedEntity
```

## Overview

Like a [`ModelEntity`](/documentation/RealityKit/ModelEntity), a [`BodyTrackedEntity`](/documentation/RealityKit/BodyTrackedEntity) has a [`ModelComponent`](/documentation/RealityKit/ModelComponent)
that defines its physical appearance. Unlike a model entity, a body-tracked
entity lacks the components required to participate in collisions or physics
simulations. Instead, a [`BodyTrackingComponent`](/documentation/RealityKit/BodyTrackingComponent) drives the positioning and
arrangement of the entity based on tracking information from the AR session.

![Diagram showing the components present in the body-tracked](images/com.apple.RealityKit/BodyTrackedEntity-1@2x.png)

For an example of how to use a body-tracked entity, see
<doc://com.apple.documentation/documentation/ARKit/capturing-body-motion-in-3d>.

## Topics

### Loading a body-tracked entity

[`loadBodyTracked(named:in:)`](/documentation/RealityKit/Entity/loadBodyTracked(named:in:))

Synchronously loads a body-tracked entity from a bundle.

[`loadBodyTracked(contentsOf:withName:)`](/documentation/RealityKit/Entity/loadBodyTracked(contentsOf:withName:))

Synchronously loads a body-tracked entity from a file URL.

[`loadBodyTrackedAsync(named:in:)`](/documentation/RealityKit/Entity/loadBodyTrackedAsync(named:in:))

Asynchronously loads a body-tracked entity from a bundle.

[`loadBodyTrackedAsync(contentsOf:withName:)`](/documentation/RealityKit/Entity/loadBodyTrackedAsync(contentsOf:withName:))

Asynchronously loads a body-tracked entity from a file URL.


---

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)