<!--
{
  "availability" : [
    "iOS: -",
    "iPadOS: -",
    "visionOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/ManipulationEvents",
  "metadataVersion" : "0.1.0",
  "role" : "Enumeration",
  "symbol" : {
    "kind" : "Enumeration",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation18ManipulationEventsO"
  },
  "title" : "ManipulationEvents"
}
-->

# ManipulationEvents

Events that occur while a person manipulates an entity.

```
enum ManipulationEvents
```

## Overview

You can subscribe to these events using [`subscribe(to:on:_:)`](/documentation/RealityKit/RealityViewContentProtocol/subscribe(to:on:_:)).
For example, you can change the color of an entity’s material when the manipulation gesture begins and ends.

```swift
_ = content.subscribe(to: ManipulationEvents.WillBegin.self) { event in
    event.entity.components[ModelComponent.self]?.materials[0] = SimpleMaterial(color: .blue, isMetallic: false)
}
_ = content.subscribe(to: ManipulationEvents.WillEnd.self)  { event in
    event.entity.components[ModelComponent.self]?.materials[0] = SimpleMaterial(color: .red, isMetallic: false)
}
```

## Topics

### Detecting manipulation gesture events

[`WillBegin`](/documentation/RealityKit/ManipulationEvents/WillBegin)

The event that occurs when someone is about to start an entity manipulation gesture.

[`DidUpdateTransform`](/documentation/RealityKit/ManipulationEvents/DidUpdateTransform)

The event that occurs repeatedly when the entity’s transform updates during a manipulation gesture.

[`DidHandOff`](/documentation/RealityKit/ManipulationEvents/DidHandOff)

The event that occurs during a manipulation gesture when someone passes an entity
from one hand to the other.

[`WillRelease`](/documentation/RealityKit/ManipulationEvents/WillRelease)

The event that occurs just as someone releases an entity during a manipulation gesture.

[`WillEnd`](/documentation/RealityKit/ManipulationEvents/WillEnd)

The event that occurs at the end of a manipulation gesture, when the entity has reached
its resting position, destination and the system no longer updates it.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)