UMovieSceneSequencePlayer

Abstract class that provides consistent player behaviour for various animation players

Windows
MacOS
Linux

Inheritance Hierarchy

References

Module

MovieScene

Header

/Engine/Source/Runtime/MovieScene/Public/MovieSceneSequencePlayer.h

Include

#include "MovieSceneSequencePlayer.h"

Syntax

class UMovieSceneSequencePlayer :
    public UObject,
    public IMovieScenePlayer

Remarks

Abstract class that provides consistent player behaviour for various animation players

Variables

Name Description

Protected variable

uint32: 1

 

bIsEvaluating

Set to true while evaluating to prevent reentrancy

Protected variable

uint32: 1

 

bPendingOnStartedPlaying

Set to true to invoke OnStartedPlaying on first update tick for started playing

Protected variable

uint32: 1

 

bReversePlayback

Whether we're currently playing in reverse.

Protected variable

int32

 

CurrentNumLoops

The number of times we have looped in the current playback

Protected variable

int32

 

DurationFrames

Time (in playback frames) at which to stop playing the sequence (defaults to the upper bound of the sequence's play range)

Protected variable

TArray< FLatent...

 

LatentActions

Set of latent actions that are to be performed when the sequence has finished evaluating this frame

Protected variable

FMovieSceneSequ...

 

NetSyncProps

Replicated playback status and current time that are replicated to clients

Public variable

FOnMovieSceneSe...

 

OnFinished

Event triggered when the level sequence player finishes naturally (without explicitly calling stop)

Public variable

FOnMovieSceneSe...

 

OnPause

Event triggered when the level sequence player is paused

Public variable

FOnMovieSceneSe...

 

OnPlay

Event triggered when the level sequence player is played

Public variable

FOnMovieSceneSe...

 

OnPlayReverse

Event triggered when the level sequence player is played in reverse

Public variable

FOnMovieSceneSe...

 

OnStop

Event triggered when the level sequence player is stopped

Protected variable

TScriptInterfac...

 

PlaybackClient

External client pointer in charge of playing back this sequence

Protected variable

FMovieSceneSequ...

 

PlaybackSettings

Specific playback settings for the animation.

Protected variable

FMovieScenePlay...

 

PlayPosition

Play position helper

Protected variable

FMovieSceneRoot...

 

RootTemplateInstance

The root template instance we're evaluating

Protected variable

UMovieSceneSequ...

 

Sequence

The sequence to play back

Protected variable

TSharedPtr< FMo...

 

SpawnRegister

Protected variable

FFrameNumber

 

StartTime

Time (in playback frames) at which to start playing the sequence (defaults to the lower bound of the sequence's play range)

Protected variable

TEnumAsByte< EM...

 

Status

Movie player status.

Protected variable

TSharedPtr< FMo...

 

TimeController

(Optional) Externally supplied time controller

Constructors

Name Description

Public function

UMovieSceneSequencePlayer

(
    const FObjectInitializer&
)

Destructors

Name Description

Public function Virtual

~UMovieSceneSequencePlayer()

Functions

Name Description

Protected function Virtual Const

bool

 

CanPlay()

Public function

void

 

ChangePlaybackDirection()

Changes the direction of playback (go in reverse if it was going forward, or vice versa)

Protected function Const

int32

 

FindMarkedFrameByLabel

(
    const FString& InLabel
)

Public function

TArray< UObj...

 

GetBoundObjects

(
    FMovieSceneObjectBindingID ObjectBi...
)

Retrieve all objects currently bound to the specified binding identifier

Public function Const

FQualifiedFr...

 

GetCurrentTime()

Get the current playback position

Public function

bool

 

GetDisableCameraCuts()

Set whether to disable camera cuts

Public function Const

FQualifiedFr...

 

GetDuration()

Get the total duration of the sequence

Public function Const

FQualifiedFr...

 

GetEndTime()

Get the offset within the level sequence to finish playing

Public function Const

int32

 

GetFrameDuration()

Get this sequence's duration in frames

Public function Const

FFrameRate

 

GetFrameRate()

Get this sequence's display rate.

Protected function Const

FFrameTime

 

GetLastValidTime()

Public function

TArray< FMov...

 

GetObjectBindings

(
    UObject* InObject
)

Get the object bindings for the requested object

Protected function Const

UWorld *

 

GetPlaybackWorld()

Public function Const

float

 

GetPlayRate()

Get the playback rate of this player.

Public function Const

UMovieSceneS...

 

GetSequence()

Access the sequence this player is playing

Public function Const

FQualifiedFr...

 

GetStartTime()

Get the offset within the level sequence to start playing

Public function

void

 

GoToEndAndStop()

Go to end and stop.

Public function

void

 

Initialize

(
    UMovieSceneSequence* InSequenc...,
    const FMovieSceneSequencePlaybackSe...
)

Initialize this player with a sequence and some settings

Public function Const

bool

 

IsPaused()

Check whether the sequence is paused.

Public function Const

bool

 

IsPlaying()

Check whether the sequence is actively playing.

Public function Const

bool

 

IsReversed()

Check whether playback is reversed.

Public function

void

 

JumpToFrame

(
    FFrameTime NewPosition
)

Low-level call to set the current time of the player by evaluating only the specified time, as if scrubbing the timeline.

Public function

bool

 

JumpToMarkedFrame

(
    const FString& InLabel
)

Low-level call to set the current time of the player to the marked frame by label by evaluating only the specified time, as if scrubbing the timeline.

Public function

void

 

JumpToSeconds

(
    float TimeInSeconds
)

Low-level call to set the current time of the player by evaluating only the specified time, as if scrubbing the timeline.

Protected function Virtual

void

 

OnLooped()

Protected function Virtual

void

 

OnPaused()

Public function Const

FOnMovieScen...

 

OnSequenceUpdated()

Protected function Virtual

void

 

OnStartedPlaying()

Protected function Virtual

void

 

OnStopped()

Public function

void

 

Pause()

Pause playback.

Public function

void

 

Play()

Start playback forwards from the current time cursor position, using the current play rate.

Protected function

void

 

PlayInternal()

Public function

void

 

PlayLooping

(
    int32 NumLoops
)

Start playback from the current time cursor position, looping the specified number of times.

Public function

void

 

PlayReverse()

Reverse playback.

Public function

void

 

PlayToFrame

(
    FFrameTime NewPosition
)

Low-level call to set the current time of the player by evaluating from the current time to the specified time, as if the sequence is playing.

Public function

bool

 

PlayToMarkedFrame

(
    const FString& InLabel
)

Low-level call to set the current time of the player to the marked frame by label by evaluating only the specified time.

Public function

void

 

PlayToSeconds

(
    float TimeInSeconds
)

Low-level call to set the current time of the player by evaluating only the specified time.

Public function

void

 

Scrub()

Scrub playback.

Public function

void

 

ScrubToFrame

(
    FFrameTime NewPosition
)

Low-level call to set the current time of the player by evaluating only the specified time.

Public function

bool

 

ScrubToMarkedFrame

(
    const FString& InLabel
)

Low-level call to set the current time of the player to the marked frame by label by evaluating only the specified time.

Public function

void

 

ScrubToSeconds

(
    float TimeInSeconds
)

Low-level call to set the current time of the player by evaluating only the specified time.

Public function

void

 

SetDisableCameraCuts

(
    bool bInDisableCameraCuts
)

Set whether to disable camera cuts

Public function

void

 

SetFrameRange

(
    int32 StartFrame,
    int32 Duration
)

Set the valid play range for this sequence, determined by a starting frame number (in this sequence player's plaback frame), and a number of frames duration

Public function

void

 

SetFrameRate

(
    FFrameRate FrameRate
)

Set the frame-rate that this player should play with, making all frame numbers in the specified time-space

Public function

void

 

SetPlaybackClient

Assign a playback client interface for this sequence player, defining instance data and binding overrides

Public function

void

 

SetPlayRate

(
    float PlayRate
)

Set the playback rate of this player. Negative values will play the animation in reverse.

Public function

void

 

SetTimeController

Assign a time controller for this sequence player allowing custom time management implementations.

Public function

void

 

SetTimeRange

(
    float StartTime,
    float Duration
)

Set the valid play range for this sequence, determined by a starting time and a duration (in seconds)

Protected function Const

bool

 

ShouldStopOrLoop

(
    FFrameTime NewPosition
)

Public function

void

 

Stop()

Stop playback and move the cursor to the end (or start, for reversed playback) of the sequence.

Public function

void

 

StopAtCurrentTime()

Stop playback without moving the cursor.

Protected function

void

 

StopInternal

(
    FFrameTime TimeToResetTo
)

Public function

void

 

Update

(
    const float DeltaSeconds
)

Update the sequence for the current time, if playing

Protected function Virtual

void

 

UpdateMovieSceneInstance

(
    FMovieSceneEvaluationRange InRange,
    EMovieScenePlayerStatus::Type Playe...,
    bool bHasJumped
)

Protected function

void

 

UpdateTimeCursorPosition

(
    FFrameTime NewPosition,
    EUpdatePositionMethod Method
)

Overridden from UObject

Name Description

Protected function Virtual

bool

 

CallRemoteFunction

(
    UFunction* Function,
    void* Parms,
    FOutParmRec* OutParms,
    FFrame* Stack
)

Call the actor's function remotely

Protected function Virtual

int32

 

GetFunctionCallspace

(
    UFunction* Function,
    FFrame* Stack
)

Return the space this function should be called.

Protected function Virtual Const

bool

 

IsDestructionThreadSafe()

Called during garbage collection to determine if an object can have its destructor called on a worker thread.

Protected function Virtual Const

bool

 

IsSupportedForNetworking()

IsSupportedForNetworking means an object can be referenced over the network

Protected function Virtual

void

 

PostNetReceive()

Called right after receiving a bunch

Overridden from IMovieScenePlayer

Name Description

Protected function Virtual

UObject *...

 

AsUObject()

Cast this player instance as a UObject if possible

Protected function Virtual Const

bool

 

CanUpdateCameraCut()

Whether this player can update the camera cut

Protected function Virtual

FMovieSceneR...

 

GetEvaluationTemplate()

Access the evaluation template that we are playing back

Protected function Virtual

IMovieSceneP...

 

GetPlaybackClient()

Access the client in charge of playback

Protected function Virtual Const

EMovieSceneP...

 

GetPlaybackStatus()

Protected function Virtual

FMovieSceneS...

 

GetSpawnRegister()

Obtain an object responsible for managing movie scene spawnables

Protected function Virtual Const

void

 

GetViewportSettings

(
    TMap< FViewportClient*, EMovie...
)

Get the current perspective viewport settings

Protected function Virtual Const

void

 

ResolveBoundObjects

(
    const FGuid& InBindingId,
    FMovieSceneSequenceID SequenceID,
    UMovieSceneSequence& Sequence,
    UObject* ResolutionContext,
    TArray< UObject*, TInlineAlloc...
)

Resolve objects bound to the specified binding ID

Protected function Virtual

void

 

SetPlaybackStatus

(
    EMovieScenePlayerStatus::Type InPla...
)

Protected function Virtual

void

 

SetViewportSettings

(
    const TMap< FViewportClient*, ...
)

Set the perspective viewport settings

Protected function Virtual

void

 

UpdateCameraCut

(
    UObject* CameraObject,
    const EMovieSceneCameraCutParams& ...
)

Updates the perspective viewports with the actor to view through

Classes

Name

Description

Protected struct

FLatentAction

Public class

FOnMovieSceneSequencePlayerUpdated

An event that is broadcast each time this level sequence player is updated

Deprecated Functions

Name Description

Public function Const

float

 

GetLength()

Please use GetDuration instead

Public function Const

float

 

GetPlaybackEnd()

Please use GetEndTime instead

Public function Const

float

 

GetPlaybackPosition()

Please use GetCurrentTime instead

Public function Const

float

 

GetPlaybackStart()

Please use GetStartTime instead

Public function

void

 

JumpToPosition

(
    float NewPlaybackPosition
)

Please use ScrubToTime instead

Public function

void

 

SetPlaybackPosition

(
    float NewPlaybackPosition
)

Please use PlayToFrame instead

Public function

void

 

SetPlaybackRange

(
    const float NewStartTime,
    const float NewEndTime
)

Please use SetFrameRange or SetTimeRange instead

Help shape the future of Unreal Engine documentation! Tell us how we're doing so we can serve you better.
Take our survey
Dismiss