A representation of a physical object that RealityKit renders and optionally simulates.
SDKs
- iOS 13.0+
- macOS 10.15+
- Mac Catalyst 13.0+
- Xcode 11.0+
Framework
- Reality
Kit
Declaration
class ModelEntity : Entity
Overview
Use one or more model entities to place physical objects in a scene. In addition to the components they inherit from the Entity
class, model entities have geometry, described by their Model
. Model entities acquire the model component by conforming to the Has
protocol. You specify meshes and materials to control how a model entity appears.

Models respond to physics simulations because they conform to the Has
protocol. You give them mass and other physical properties with a Physics
instance, and then apply forces or impulses. The simulator uses a Physics
to manage the linear and angular velocity of the object. Alternatively, you can selectively circumvent the simulation to control position and velocity yourself. Do this for a given model by setting its physics body mode
to Physics
.
Models can also collide with one another, and with other entities that conform to the Has
protocol. The Collision
provides parameters that let you manage which models collide with each other. It also lets you control the collision shape, which for performance reasons, is typically simpler than the visual geometry.