アニメーションの使用

アニメーションを作成したら、ゲームにそれらを含めるためにスクリプトを使用する必要があります。スクリプトからアニメーションを手動で再生することも、プレイヤーキャラクターのデフォルトアニメーションを置き換えることもできます。

スクリプトからアニメーションを再生する

ユーザーが特定のキーを押すときや特別なアイテムを取得したときなど、スクリプトの内部から直接アニメーションを再生する必要がある場合があります。

ヒューマノイド

Humanoidオブジェクトを含むリグ（典型的なプレイ可能キャラクターなど）でアニメーションを再生するには、次の基本的なパターンに従います。

1. ローカルプレイヤーのHumanoidがAnimatorオブジェクトを含んでいることを確認します。
2. 正しいAnimationIdを使用して新しいAnimationインスタンスを作成します。
3. Animator:LoadAnimation()を介してアニメーションをロードしてAnimationTrackを作成します。
4. AnimationTrack:Play()でトラックを再生します。

例えば、次のLocalScriptはStarterPlayerScriptsに配置され、プレイヤーのキャラクターに"キック"アニメーションをロードして再生します。このスクリプトはまた、特定のアニメーションイベントが発生したときに検出するためにGetMarkerReachedSignal()メソッドを使用します。

LocalScript - プレイヤーキャラクターのカスタムアニメーションを再生する
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local character = player.Character or player.CharacterAdded:Wait()

-- キャラクターのヒューマノイドが"Animator"オブジェクトを含んでいることを確認
local humanoid = character:WaitForChild("Humanoid")
local animator = humanoid:WaitForChild("Animator")

-- 新しい"Animation"インスタンスを作成し、アニメーションアセットIDを設定
local kickAnimation = Instance.new("Animation")
kickAnimation.AnimationId = "rbxassetid://2515090838"

-- アニメーターにアニメーションをロードする
local kickAnimationTrack = animator:LoadAnimation(kickAnimation)

-- アニメーションのために名前付きイベントが定義されている場合、"GetMarkerReachedSignal()"に接続する
kickAnimationTrack:GetMarkerReachedSignal("KickEnd"):Connect(function(paramString)
	print(paramString)
end)

task.wait(4)

-- アニメーショントラックを再生する
kickAnimationTrack:Play()

非ヒューマノイド

Humanoidを含まないリグでアニメーションを再生するには、Animatorを持つAnimationControllerを作成する必要があります。例えば、次のScript（リグの直接の子であることを前提とする）は、"キック"アニメーションをロードして再生します。

Script - キャラクターリグのカスタムアニメーションを再生する
local rig = script.Parent

-- 新しい"Animation"インスタンスを作成し、アニメーションアセットIDを設定
local kickAnimation = Instance.new("Animation")
kickAnimation.AnimationId = "rbxassetid://2515090838"

-- 新しい"AnimationController"と"Animator"を作成
local animationController = Instance.new("AnimationController")
animationController.Parent = rig

local animator = Instance.new("Animator")
animator.Parent = animationController

-- アニメーターにアニメーションをロードする
local kickAnimationTrack = animator:LoadAnimation(kickAnimation)

-- アニメーションのために名前付きイベントが定義されている場合、"GetMarkerReachedSignal()"に接続する
kickAnimationTrack:GetMarkerReachedSignal("KickEnd"):Connect(function(paramString)
	print(paramString)
end)

task.wait(4)

-- アニメーショントラックを再生する
kickAnimationTrack:Play()

デフォルトアニメーションを置き換える

デフォルトでは、Robloxプレイヤーキャラクターには走る、登る、泳ぐ、ジャンプするなどの一般的なアニメーションが含まれています。これらのデフォルトアニメーションをカタログのアニメーションや独自のカスタムアニメーションと置き換えることができます。

1. 新しいアニメーションのアセットIDを次の方法で取得します。

   • Animation Editorで作成したカスタムアニメーションの場合、エクスポート手順に従います。
   • 以下のカタログアニメーション参照から適切なIDをコピーします。例えば、デフォルトの走るアニメーションをNinja Runバリアントで置き換えるには、656118852を使用します。

2. Explorerウィンドウで、ServerScriptServiceに新しいScriptを追加します。

   1. ServerScriptServiceにカーソルを合わせ、⊕ボタンをクリックします。
   2. コンテキストメニューからScriptを挿入します。

3. 新しいスクリプトに次のコードを貼り付けます：

   Script - デフォルトのキャラクターアニメーションを置き換える
   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- ヒューマノイドのアニメーターを取得
   	local humanoid = character:WaitForChild("Humanoid")
   	local animator = humanoid:WaitForChild("Animator")
   
   	-- すべてのアニメーショントラックを停止
   	for _, playingTrack in animator:GetPlayingAnimationTracks() do
   		playingTrack:Stop(0)
   	end
   
   	local animateScript = character:WaitForChild("Animate")
   	--animateScript.run.RunAnim.AnimationId = "rbxassetid://"
   	--animateScript.walk.WalkAnim.AnimationId = "rbxassetid://"
   	--animateScript.jump.JumpAnim.AnimationId = "rbxassetid://"
   	--animateScript.idle.Animation1.AnimationId = "rbxassetid://"
   	--animateScript.idle.Animation2.AnimationId = "rbxassetid://"
   	--animateScript.fall.FallAnim.AnimationId = "rbxassetid://"
   	--animateScript.swim.Swim.AnimationId = "rbxassetid://"
   	--animateScript.swimidle.SwimIdle.AnimationId = "rbxassetid://"
   	--animateScript.climb.ClimbAnim.AnimationId = "rbxassetid://"
   end
   
   local function onPlayerAdded(player)
   	player.CharacterAppearanceLoaded:Connect(onCharacterAdded)
   end
   
   Players.PlayerAdded:Connect(onPlayerAdded)

4. デフォルトキャラクターアニメーションを参照している各行のコメントを外し、rbxassetid://の後に置き換えIDを貼り付けます。例えば、デフォルトの走るアニメーションをNinja Runバリアントに変更するには：

   Script - デフォルトのキャラクターアニメーションを置き換える
   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- ヒューマノイドのアニメーターを取得
   	local humanoid = character:WaitForChild("Humanoid")
   	local animator = humanoid:WaitForChild("Animator")
   
   	-- すべてのアニメーショントラックを停止
   	for _, playingTrack in animator:GetPlayingAnimationTracks() do
   		playingTrack:Stop(0)
   	end
   
   	local animateScript = character:WaitForChild("Animate")
   	animateScript.run.RunAnim.AnimationId = "rbxassetid://656118852"
   	--animateScript.walk.WalkAnim.AnimationId = "rbxassetid://"
   	--animateScript.jump.JumpAnim.AnimationId = "rbxassetid://"
   	--animateScript.idle.Animation1.AnimationId = "rbxassetid://"
   	--animateScript.idle.Animation2.AnimationId = "rbxassetid://"
   	--animateScript.fall.FallAnim.AnimationId = "rbxassetid://"
   	--animateScript.swim.Swim.AnimationId = "rbxassetid://"
   	--animateScript.swimidle.SwimIdle.AnimationId = "rbxassetid://"
   	--animateScript.climb.ClimbAnim.AnimationId = "rbxassetid://"
   end
   
   local function onPlayerAdded(player)
   	player.CharacterAppearanceLoaded:Connect(onCharacterAdded)
   end
   
   Players.PlayerAdded:Connect(onPlayerAdded)

アニメーションの重みを設定する

同じアクションに対して複数のアニメーションを使用することができます。例えば、デフォルトアニメーションを置き換えるためのコードサンプルには、2つのidleバリエーションがあります。

複数のアニメーションがキャラクターの状態に存在するとき、Animateスクリプトはどちらを再生するかランダムに選択しますが、アニメーションのWeight値を設定することで結果に影響を与えることができます。以下の式に従います：

• アニメーションの重み / 状態アニメーションのすべての重みの合計

以下の例では、idle.Animation1はキャラクターがアイドル状態のときに⅓の確率で再生され、idle.Animation2は⅔の確率で再生されます。

Script - デフォルトのキャラクターアニメーションを置き換える
animateScript.idle.Animation1.AnimationId = "rbxassetid://656117400"
	animateScript.idle.Animation2.AnimationId = "rbxassetid://656118341"
	animateScript.idle.Animation1.Weight.Value = 5
	animateScript.idle.Animation2.Weight.Value = 10

アニメーション参照

デフォルトキャラクターアニメーション

以下の表には、置き換え可能なすべてのデフォルトキャラクターアニメーションが含まれています。カタログアニメーションや独自のカスタムアニメーションと置き換えることができます。Idleにはプレイ頻度を設定できる2つのバリエーションがあることに注意してください。

カタログアニメーション

アバターアニメーションバンドルを使用してデフォルトアニメーションを置き換えるときは、それぞれのアセットIDのために次の参照を使用します。例えば、Ninja Jumpアニメーションを適用したい場合は、656117878を使用します。Idleには複数のバリエーションがあることに注意してください。