애니메이션 사용

애니메이션을 생성한 후, 스크립트를 사용하여 게임에 포함시켜야 합니다. 스크립트에서 애니메이션을 수동으로 재생하거나 플레이어 캐릭터의 기본 애니메이션을 교체 할 수 있습니다.

스크립트에서 애니메이션 재생

경우에 따라 사용자가 특정 키를 누르거나 특수 아이템을 주울 때와 같이 스크립트 내에서 직접 애니메이션을 재생해야 할 수 있습니다.

휴머노이드

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를 다음과 같이 얻습니다:

   • 애니메이션 편집기로 만든 사용자 정의 애니메이션의 경우 내보내기 지침을 따릅니다.
   • 아래의 카탈로그 애니메이션 참조에서 적절한 ID를 복사합니다. 예를 들어, 기본 달리기 애니메이션을 닌자 달리기 변형으로 교체하려면 656118852를 사용합니다.

2. 탐색기 창에서 ServerScriptService에 새 Script를 추가합니다.

   1. ServerScriptService 위로 마우스를 올리고 ⊕ 버튼을 클릭합니다.
   2. 상황에 맞는 메뉴에서 스크립트를 삽입합니다.

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를 붙여넣습니다. 예를 들어, 기본 달리기 애니메이션을 닌자 달리기 변형으로 변경하려면:

   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)

애니메이션 가중치 설정

같은 행동에 대해 여러 애니메이션을 사용할 수 있습니다. 예를 들어, 기본 애니메이션 교체 코드 샘플에는 두 개의 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

애니메이션 참조

기본 캐릭터 애니메이션

다음 표는 기본 애니메이션 교체와 카탈로그 애니메이션 또는 사용자 정의(custom) 애니메이션으로 교체할 수 있는 기본 캐릭터 애니메이션을 포함합니다. Idle에는 빈도가 높거나 낮게 재생될 수 있도록 가중치를 조절할 수 있는 두 가지 변형이 있습니다.

카탈로그 애니메이션

기본 애니메이션을 교체하기 위해 아바타 애니메이션 번들을 사용할 때, 각각의 자산 ID에 대한 다음 참조를 사용하십시오. 예를 들어, 닌자 점프 애니메이션을 적용하려면 656117878를 사용합니다. Idle에는 여러 변형이 있다는 점에 유의하십시오.