loadModel(contentsOf:withName:)
Synchronously loads a model entity from a file URL.
Declaration
@MainActor @preconcurrency static func loadModel(contentsOf url: URL, withName resourceName: String? = nil) throws -> ModelEntityParameters
- 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
The root entity in the loaded file, which Reality Kit casts as a ModelEntity.
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.