# AnimationTrack（ロブロックス クラス）

> Controls the playback of an animation on an Animator.

- URL：https://roblox.minecraft-okinawa.com/reference/classes/AnimationTrack/
- 公式：https://create.roblox.com/docs/reference/engine/classes/AnimationTrack
- 受け継いでいるクラス：Instance

## プロパティ

- `AnimationTrack.Animation: Animation`：The Animation object that was used to create this AnimationTrack.
- `AnimationTrack.IsPlaying: boolean`：A read-only property that returns true when the AnimationTrack is playing.
- `AnimationTrack.Length: float`：A read-only property that returns the length (in seconds) of an AnimationTrack. This will return 0 until the animation has fully loaded and thus may not be immediately available.
- `AnimationTrack.Looped: boolean`：Sets whether the animation will repeat after finishing. If it is changed while playing the result will take effect after the animation finishes.
- `AnimationTrack.Priority: AnimationPriority`：Sets the priority of an AnimationTrack. Depending on what this is set to, playing multiple animations at once will look to this property to figure out which Keyframe Class.Pose|Poses should be played over one another.
- `AnimationTrack.Speed: float`：Read-only property that gives the current playback speed of the AnimationTrack.
- `AnimationTrack.TimePosition: float`：Returns the position in time in seconds that an AnimationTrack is through playing its source animation. Can be set to make the track jump to a specific moment in the animation.
- `AnimationTrack.WeightCurrent: float`：Read-only property that gives the current weight of the AnimationTrack.
- `AnimationTrack.WeightTarget: float`：Read-only property that gives the current weight of the AnimationTrack.

## メソッド

- `AnimationTrack:AdjustSpeed(speed: float): ()`：Changes the AnimationTrack.Speed of an animation. A positive value for speed plays the animation forward, a negative one plays it backwards, and 0 pauses it.
- `AnimationTrack:AdjustWeight(weight: float, fadeTime: float): ()`：Changes the weight of an animation, with the optional fadeTime parameter determining how long it takes for AnimationTrack.WeightCurrent to reach AnimationTrack.WeightTarget.
- `AnimationTrack:GetMarkerReachedSignal(name: string): RBXScriptSignal`：Returns an RBXScriptSignal (event) that fires when a specified KeyframeMarker has been hit in an Class.Animation|animation.
- `AnimationTrack:GetParameter(key: string): Variant`：Returns the value of a parameter on the animation graph by key. Returns nil if the parameter has not been set.
- `AnimationTrack:GetParameterDefaults(): Dictionary`：Returns a dictionary of parameter values initially set as instance attributes on the AnimationGraphDefinition instance used to build the animation graph inside this track.
- `AnimationTrack:GetTimeOfKeyframe(keyframeName: string): double`：Returns the time position of the first Keyframe of the given name in an AnimationTrack.
- `AnimationTrack:Play(fadeTime: float, weight: float, speed: float): ()`：Plays the AnimationTrack. Once called an AnimationTrack will play with the specified fadeTime, weight and speed.
- `AnimationTrack:SetParameter(key: string, value: Variant): ()`：Sets a parameter value on the animation graph, driving animation graph node inputs.
- `AnimationTrack:Stop(fadeTime: float): ()`：Stops the AnimationTrack.

## イベント

- `AnimationTrack.DidLoop()`：Fires when an AnimationTrack loops on the next update following the end of the previous animation loop.
- `AnimationTrack.Ended()`：Fires when the AnimationTrack is completely done moving anything in the world.
- `AnimationTrack.Stopped()`：Fires when the AnimationTrack finishes playing. The AnimationTrack might still animate the subject while the animation "fades out". To catch when the AnimationTrack is completely done moving anything in the world, use the AnimationTrack.Ended event.

英語の説明とメンバー一覧：Roblox Creator Documentation（CC BY 4.0）。日本語の解説はこのサイト独自のものです。

執筆：鈴木孝昌（現役プロジェクトマネージャー／プログラミング講師）／運営：沖縄マイクラ部 プログラミングスクール「クロスウェーブ」（https://minecraft-okinawa.com/）