---
title: "loadBodyTracked(contentsOf:withName:)"
framework: realitykit
role: symbol
role_heading: Type Method
path: "realitykit/entity/loadbodytracked(contentsof:withname:)"
---

# loadBodyTracked(contentsOf:withName:)

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

## Declaration

```swift
@MainActor @preconcurrency static func loadBodyTracked(contentsOf url: URL, withName resourceName: String? = nil) throws -> BodyTrackedEntity
```

## Parameters

- `url`: A file URL representing the file to load.
- `resourceName`: A unique name the method assigns to the resource it loads, for use in network synchronization.

## Return Value

Return Value The root entity in the loaded file, cast as a BodyTrackedEntity.

## Discussion

Discussion Loading an Entity with this method blocks the main actor because it’s synchronous, so only call it from a command-line application. The method can stall a regular app, which makes it visibly hitch, and the system terminates an app if its UI becomes unresponsive. See init(named:in:) for an example that demonstrates how to safely load content.

## See Also

### Loading a flattened body-tracked entity

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