loadAsync(contentsOf:withName:)
Returns a load request that creates an entity by asynchronously loading it from a file URL and preserving the entity’s hierarchy.
Declaration
@MainActor @preconcurrency static func loadAsync(contentsOf url: URL, withName resourceName: String? = nil) -> LoadRequest<Entity>Parameters
- url:
A file URL representing the file to load. For Reality files, append a URL fragment to specify a scene name — for example,
my.reality#MyScene. - resourceName:
A unique name the method assigns to the resource it loads, for use in network synchronization.
Discussion
RealityKit supports loading entities from USD (.usd, .usda, .usdc, .usdz) and Reality (.reality) files. For Reality files that contain multiple scenes, specify which scene to load by appending a URL fragment with the scene name — for example, my.reality#MyScene.
For more information on loading entities, see Loading entities from a file.