애니메이션 이벤트 마커를 타임라인 전반에 걸쳐 정의하고, GetMarkerReachedSignal() 를 사용하여 애니메이션이 실행되는 동안 이러한 마커를 감지할 수 있습니다.
기본적으로 이벤트 트랙은 표시되지 않습니다. 이벤트 트랙을 표시하려면:
타임라인의 오른쪽으로 이동한 다음 설정 아이콘을 클릭합니다. 팝업 메뉴가 표시됩니다.
애니메이션 이벤트 표시를 선택합니다. 그러면 미디어 및 재생 제어 아래에 애니메이션 이벤트 바가 열립니다.
이벤트 생성
이벤트 마커는 애니메이션 이벤트가 시작되는 위치를 시각적으로 나타냅니다. 이벤트 마커를 생성한 후에는 타임라인의 어떤 프레임 위치로도 이동할 수 있습니다.
새로운 이벤트 마커를 생성하려면:
타임라인으로 이동한 다음 스크러버를 클릭한 상태로 드래그하여 이벤트가 발생해야 하는 프레임 위치로 이동합니다.
이벤트 트랙으로 이동한 다음 애니메이션 이벤트 편집 버튼을 클릭합니다.
대화 상자에서 + 이벤트 추가를 클릭한 다음 이벤트 이름을 입력합니다.
- 선택 사항매개변수 필드에 이벤트에 대한 매개변수 문자열을 입력합니다.
저장 버튼을 클릭합니다. 타임라인의 이벤트 바에 새 마커 기호가 프레임 위치에 표시됩니다.
이벤트 감지
LocalScript에서 애니메이션 이벤트를 감지하려면 GetMarkerReachedSignal() 함수에 함수를 연결합니다. 예를 들어:
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local character = player.Character or player.CharacterAdded:Wait()
local humanoid = character:WaitForChild("Humanoid")
local animator = humanoid:WaitForChild("Animator")
-- 새 "애니메이션" 인스턴스 생성
local walkAnim = Instance.new("Animation")
-- 해당 애니메이션 자산 ID로 "AnimationId" 설정
walkAnim.AnimationId = "rbxassetid://5432167890"
-- 애니메이션을 애니메이터에 로드
local walkAnimTrack = animator:LoadAnimation(walkAnim)
-- "GetMarkerReachedSignal" 이벤트를 특정 명명된 키프레임에 연결
walkAnimTrack:GetMarkerReachedSignal("FootStep"):Connect(function(paramString)
print(paramString)
end)
애니메이션 편집기 내의 모든 이벤트 마커에 대해 매개변수 값을 지정할 수 있습니다. 이를 통해 GetMarkerReachedSignal() 메서드에 커스텀 문자열(단일 값, 콤마로 구분된 문자열 등)을 전달할 수 있으며, 이는 위의 코드 예시에서 paramString 인수로 나타납니다. 이 문자열은 필요에 따라 분석되거나 변환되어 이벤트에서 수행하고자 하는 어떤 작업에서도 사용할 수 있습니다.
이벤트 복제
이벤트를 생성하면 전체 애니메이션에서 사용할 수 있으며, 원래 생성한 프레임 위치에서만 사용 가능한 것은 아닙니다. 예를 들어, 캐릭터의 왼쪽 발이 착지하는 지점에 FootStep 이벤트 마커를 만들고, 캐릭터의 오른쪽 발이 착지할 때 동일한 이벤트를 사용할 수 있습니다.
이벤트를 복제하려면:
이벤트 바의 이벤트 마커를 마우스 오른쪽 버튼으로 클릭한 다음 컨텍스트 메뉴에서 선택 항목 복사를 선택합니다.
타임라인의 다른 시점에서 마우스 오른쪽 버튼을 클릭하고 이벤트 붙여넣기를 선택합니다. 복사한 이벤트가 클릭한 위치에 가장 가까운 시점에 삽입됩니다.
- 선택 사항원본 이벤트가 매개변수를 사용하지만 복제한 이벤트가 수정된 매개변수를 사용해야 하는 경우, 다음 단계를 수행합니다:
- 복제한 이벤트 마커를 마우스 오른쪽 버튼으로 클릭하고 컨텍스트 메뉴에서 애니메이션 이벤트 편집을 선택합니다. 애니메이션 이벤트 편집 대화 상자가 표시됩니다.
- 변경 사항을 적용하고 저장 버튼을 클릭합니다.