<!--
{
  "availability" : [
    "iOS: 18.0.0 -",
    "iPadOS: 18.0.0 -",
    "macCatalyst: 18.0.0 -",
    "macOS: 15.0.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/EmphasizeAction",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation15EmphasizeActionV"
  },
  "title" : "EmphasizeAction"
}
-->

# EmphasizeAction

An action that performs an animation to call attention to an entity.

```
struct EmphasizeAction
```

## Overview

This action plays a preexisting animation, dependent on the [`style`](/documentation/RealityKit/EmphasizeAction/style)
and [`motionType`](/documentation/RealityKit/EmphasizeAction/motionType) options.

The example below creates an animation that causes the entity to bounce in a
playful style.

```swift
// An action that performs a bounce motion in a playful style.
let emphasizeAction = EmphasizeAction(motionType: .bounce,
                                      style: .playful,
                                      isAdditive: false)

// A five second animation that plays the preexisting animation.
//
// This animation causes the entity to raise up, and then drop,
// appearing to bounce on the ground in a playful style,
// before returning to its original position.
let playfulBounceAnimation = try AnimationResource
    .makeActionAnimation(for: emphasizeAction,
                         duration: 5.0,
                         bindTarget: .transform)

// Play the five second emphasize animation that causes the entity to
// bounce in a playful style.
entity.playAnimation(playfulBounceAnimation)
```

![A screen recording of a red cube in a living room scene. At the start, the cube begins to raise up in a whimsical motion, and then drops, appearing to bounce. This motion is repeated twice more, before returning to its original position.](videos/com.apple.RealityKit/emphasizeaction-bounce~dark.mp4)

> Important: This action directly animates the ``doc://com.apple.RealityKit/documentation/RealityKit/BindTarget/transform`` on the bound entity.
> Ensure a correct bind target is supplied when creating the animation.

## Topics

### Initializers

[`init(motionType: EmphasizeAction.EmphasisMotionType, style: EmphasizeAction.EmphasisAnimationStyle, isAdditive: Bool)`](/documentation/RealityKit/EmphasizeAction/init(motionType:style:isAdditive:))

Creates a new emphasize action.

### Instance Properties

[`var animatedValueType: (any AnimatableData.Type)?`](/documentation/RealityKit/EmphasizeAction/animatedValueType)

The type for the value that the action modifies over time.

[`var isAdditive: Bool`](/documentation/RealityKit/EmphasizeAction/isAdditive)

A Boolean value that indicates whether the animation system additively blends the action’s output with the base value.

[`var motionType: EmphasizeAction.EmphasisMotionType`](/documentation/RealityKit/EmphasizeAction/motionType)

An option that implements animation effects.

[`var style: EmphasizeAction.EmphasisAnimationStyle`](/documentation/RealityKit/EmphasizeAction/style)

An option that implements different kinds of animation timing.

### Enumerations

[`enum EmphasisAnimationStyle`](/documentation/RealityKit/EmphasizeAction/EmphasisAnimationStyle)

Options available to determine the kinds of animation timing.

[`enum EmphasisMotionType`](/documentation/RealityKit/EmphasizeAction/EmphasisMotionType)

Options available to determine the kinds of animation effects.

## Relationships

### Conforms To

[`Decodable`](/documentation/Swift/Decodable)

[`EntityAction`](/documentation/RealityKit/EntityAction)

[`Encodable`](/documentation/Swift/Encodable)

---

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)