---
title: BodyTrackedEntity
framework: realitykit
role: symbol
role_heading: Class
path: realitykit/bodytrackedentity
---

# BodyTrackedEntity

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

## Declaration

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

## Mentioned in

Loading entities from a file

## Overview

Overview Like a ModelEntity, a BodyTrackedEntity has a 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 drives the positioning and arrangement of the entity based on tracking information from the AR session.

For an example of how to use a body-tracked entity, see Capturing Body Motion in 3D.

## Topics

### Loading a body-tracked entity

- [loadBodyTracked(named:in:)](realitykit/entity/loadbodytracked(named:in:).md)
- [loadBodyTracked(contentsOf:withName:)](realitykit/entity/loadbodytracked(contentsof:withname:).md)
- [loadBodyTrackedAsync(named:in:)](realitykit/entity/loadbodytrackedasync(named:in:).md)
- [loadBodyTrackedAsync(contentsOf:withName:)](realitykit/entity/loadbodytrackedasync(contentsof:withname:).md)

## Relationships

### Inherits From

- [Entity](realitykit/entity.md)

### Conforms To

- [CoordinateSpace3D](spatial/coordinatespace3d.md)
- [CoordinateSpace3DFloat](spatial/coordinatespace3dfloat.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [Equatable](swift/equatable.md)
- [EventSource](realitykit/eventsource.md)
- [HasBodyTracking](realitykit/hasbodytracking.md)
- [HasHierarchy](realitykit/hashierarchy.md)
- [HasModel](realitykit/hasmodel.md)
- [HasSynchronization](realitykit/hassynchronization.md)
- [HasTransform](realitykit/hastransform.md)
- [Hashable](swift/hashable.md)
- [Identifiable](swift/identifiable.md)
- [Observable](observation/observable.md)
- [RealityCoordinateSpace](realitykit/realitycoordinatespace.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

## See Also

### Body and face tracking

- [Creating an App for Face-Painting in AR](realitykit/creating-an-app-for-face-painting-in-ar.md)
- [Occluding virtual content with people](arkit/occluding-virtual-content-with-people.md)
- [Placing entities using head and device transform](visionos/placing-entities-using-head-and-device-transform.md)
- [BodyTrackingComponent](realitykit/bodytrackingcomponent.md)
- [HasBodyTracking](realitykit/hasbodytracking.md)