Changelog

이 문서는 FMOD Plus의 주요 변경 사항을 기록합니다.

[1.7.2] - 2026-08-11

Changed

About 창을 FMOD 설치 여부와 무관하게 사용할 수 있도록 Bootstrap Editor 어셈블리로 이동
About 창의 UXML, USS, 로고 및 package.json을 고정 경로/직렬화 참조 대신 GUID와 AssetDatabase.GUIDToAssetPath로 해석하도록 변경
About UI 구조와 스타일을 정리하고 패키지 버전 로드 실패 시 진단 가능한 대체 문구를 표시하도록 개선

Fixed

직렬화된 UXML 또는 package.json 참조가 연결되지 않은 경우 About 창 내용이 그려지지 않던 문제 수정

[1.7.1] - 2026-08-11

Changed

KeyReference의 필드, 프로퍼티, public 메서드 및 private helper 순서를 역할별로 정리
KeyReference의 Key, Guid, Path, ToString()과 Key 조회 API의 XML 문서를 보완
FMODEventTrigger의 필드, override, private helper 및 내부 enum 순서를 역할별로 정리

[1.7.0] - 2026-08-11

Added

KeyReference에 Global/Local Key List의 Event와 초기 파라미터를 안전하게 조회하는 API 추가
AudioPathByString의 기본 Key 생성, 중복 방지, 변경 직후 조회, null 데이터 처리를 검증하는 EditMode 테스트 추가
Unity 버전에 맞는 static 필드 초기화 정책이 적용되었는지 검증하는 EditMode 테스트 추가

Changed

FMODAudioSource, CommandSender, FMODEventTrigger의 재생·명령·이벤트 처리 책임을 분리하고 public API 문서를 정리
LocalKeyList를 직렬화 필드 캡슐화와 값 중심 조회 API(Count, TryGetEvent, TryGetParameters, TryGetEventAndParameters)로 변경
Local Key List를 참조하는 Command Sender와 Editor UI가 목록 직렬화 배열을 직접 순회하지 않고 LocalKeyList 조회 API를 사용하도록 변경
KeyReference에서 복제된 FMOD EventReference.Find 코드를 제거하고 Key List 참조 모델의 책임과 null 처리를 명확하게 정리
FMODPlusUtility.cs에 혼재된 AudioType, EventRefCallback, KeyAndPath, EventReferenceByKey, AudioPathByString을 역할별 파일로 분리
FMODPlusUtility.Length가 빈 Event, 유효하지 않은 Event Description 및 조회 실패를 안전하게 처리하도록 변경
AudioPathByString, EventRefAtKey, KeyAndPath의 public API XML 문서를 보완
Unity 6.5 이상에서 mutable static 필드를 [AutoStaticsCleanup]으로 정리하고, Unity 6.4 이하에서는 Enter Play Mode 초기화 콜백을 사용하도록 변경
SimpleBaseField의 구형 UXML factory/traits 구현을 Unity 6의 [UxmlElement] 및 [UxmlAttribute] API로 변경
Key List ScriptableObject와 Local Key List의 public API XML 문서를 보완하고 null 안전성을 강화

Fixed

Local Key List의 null 목록·항목·파라미터 배열과 빈 Key 조회 시 예외 또는 불필요한 오류 로그가 발생할 수 있던 문제 수정
AudioPathByString의 공개 목록을 수정한 뒤 내부 Dictionary 캐시가 오래된 Event 또는 파라미터를 반환하던 문제 수정
기본 Key의 중간 번호가 비어 있어도 사용하지 못하거나 부분 문자열이 같은 Key를 중복으로 판단하던 문제 수정
잘못된 ClipStyle을 가진 EventRefCallback.TryGetClip이 예외를 발생시키던 문제 수정
Domain Reload를 비활성화한 상태로 Play Mode에 재진입할 때 Global Key List 싱글턴과 Editor UI 캐시가 이전 상태를 유지하던 문제 수정
Custom UI field가 패널에 재부착될 때 정렬 콜백이 중복 등록될 수 있던 문제 수정

Removed

FMODAudioSource의 레거시 Event, AllowNonRigidbodyDoppler, UpdateActiveAudioSource(), 쓰기 가능한 EventInstance API 제거
LocalKeyList의 레거시 ClipList 공개 필드, 최상위 EventRefList, 변환 ContextMenu 및 기존 TryFind*/TryGetValue API 제거

[1.7.0-beta.1] - 2026-08-11

Added

FMOD/FMOD Plus/Setup UI Toolkit 설정 창 추가
시스템 언어에 따른 Setup 창 한국어/영어 자동 전환 추가
Assets 내부 FMOD Integration 감지 및 Embedded UPM 마이그레이션 기능 추가
FMOD Integration 버전의 UPM SemVer 변환과 FMOD.meta GUID 자동 복구 추가
마이그레이션 사전 검사, 파일 이동 롤백, Settings/Cache 보존 처리 추가
AMB, BGM, SFX를 통합하는 Global Key List Editor Window 추가
Global 및 Local Key List의 Key 이름 검색 기능 추가
선택 항목의 Event와 초기 파라미터를 편집하는 상세 패널 추가
FMOD Studio Listener 아이콘 자동 적용 기능 추가

Changed

FMOD Plus를 com.nkstudio.fmodplus Embedded UPM 패키지 구조로 변경
FMOD 패키지 com.firelight.fmod-for-unity의 [2.2.0,3.0.0) 버전을 asmdef Version Define으로 감지하도록 변경
FMOD가 설치된 경우에만 Runtime/Editor 어셈블리를 컴파일하도록 변경
Global 및 Local Key List 편집 UI를 UXML/USS 기반 UI Toolkit으로 변경
LocalKeyList는 MonoBehaviour, AMB/BGM/SFX 목록은 ScriptableObject를 직접 상속하도록 정리
FMODAudioSource가 FMOD 소스 Hook 없이 거리 기반 재생 상태를 직접 갱신하도록 변경
Setup 창에 최소/최대 크기와 좁은 너비 대응 레이아웃 적용

Fixed

검색 또는 Undo/Redo 후 Key List 선택 인덱스가 달라질 수 있던 문제 수정
Local Key List 인스펙터 폭이 좁을 때 필드와 버튼이 옆으로 밀리던 문제 수정
Event 변경 후 초기 파라미터 목록이 올바르게 갱신되지 않을 수 있던 문제 수정
삭제된 패키지 경로를 AssetDatabase가 기억해 FMOD 마이그레이션 버튼이 비활성화되던 문제 수정
FMOD Settings와 Cache가 Packages에 포함되어 발생하는 경로 오류 방지
마이그레이션 중 파일 쓰기 실패 시 원본 meta 또는 package.json이 남을 수 있던 롤백 순서 보강

Removed

AMB, BGM, SFX별 Global Key List 메뉴 제거
Global Key List ScriptableObject의 장식용 전용 인스펙터 UI 제거
레거시 USE_FMOD, FMODPlus Scripting Define 자동 등록 제거
FMOD RuntimeManager 및 StudioListener Editor 소스를 직접 수정하던 Hook 제거

[1.6.4]-Beta - 2023-11-13

Added

FMOD Audio Source에 PlayThisOneShot 함수 추가

[1.6.3]-Beta - 2023-10-24

Fixed

KeyList 라벨 글자가 밀려서 Show Info 안보이던 이슈 수정

[1.6.2]-Beta - 2023-10-24

Added

KeyList

Fixed

오딘과 같은 인스펙터 에셋을 사용하는 개발자를 위해 KeyListSO,와 KeyListMono를 제공

[1.6.1]-Beta - 2023-10-24

Added

FMOD Plus를 위한 UI Toolkit 인스펙터 컨버터 지원

Fixed

오디오 스타일을 사용하지 않는 녀석이라고 하는 경고 메세지 차단

[1.6.0]-Beta - 2023-10-24

Added

오디오 소스에서 키 리스트 사용 가능

Fixed

커맨드 센더의 컨셉 재 정의

[1.5.0]-Beta - 2023-10-17

Added

FMOD Key List를 Mono 또는 SO에 그려낼 수 있도록 EventRefAtKey를 제공

Fixed

Key List는 전부 EventRefAtKey방식으로 그려내도록 변경
Key List가 열리지 않고 헤더만 보였던 이슈 수정

[1.4.2]-Beta - 2023-10-16

Fixed

FMOD Audio Source의 playOnAwake가 Start가 아닌 Enable에서 동작되도록 설계 변경
OnDisable() 되었을 때 Stop 함수가 실행되도록 설계 변경

[1.4.1]-Beta - 2023-10-16

Fixed

NKEditorUtility 제거

[1.4.0]-Beta - 2023-10-16

Fixed

Key List를 전부 UI Toolkit으로 변경

[1.3.0]-Beta - 2023-09-29

Fixed

Doozy 플러그인 서드파티 지원

[1.2.7]-Beta - 2023-09-29

Fixed

FMOD Audio Source에서 IsPlaying() -> isPlaying으로 소문자로 변경
FMOD Audio Source에서 PlayOnAwake() -> playOnAwake 소문자로 변경

[1.2.6]-Beta - 2023-09-29

Fixed

FMOD Audio Source에서 Mute -> mute으로 소문자로 변경

[1.2.5]-Beta - 2023-09-29

Fixed

FMOD Audio Source에서 Clip -> clip으로 소문자로 변경

[1.2.4]-Beta - 2023-09-03

Fixed

KeyList에서 제공되는 함수 중 TryGetClip()이 추가됨
TryFind -> TryGet으로 함수 시작부분이 변경됨

[1.2.3]-Beta - 2023-09-03

Fixed

PlayOneShot에서 파라미터 전달 방법 중 ParamRef[] 방식도 추가

[1.2.2]-Beta - 2023-09-03

Fixed

Add(key, path) 함수에서 동일한 이름이 포함된 경우 경고문을 띄우는 알고리즘을 수정함
커맨드 센더에서 on API 방식에 대하여 브릿지 템플릿 코드 제공

[1.2.1]-Beta - 2023-09-03

Fixed

파라미터 센더를 삭제하고 커맨드 센더에 병합 됨
트리거 이벤트에 커맨드 센더도 되도록 변경
FMOD 업데이트 시 내부 코드를 업데이트 하도록 FMOD/FMOD Plus/Force Update를 추가함

[1.2.0]-Beta - 2023-09-03

Fixed

파라미터 센더를 삭제하고 커맨드 센더에 병합 됨
트리거 이벤트에 커맨드 센더도 되도록 변경
FMOD 업데이트 시 내부 코드를 업데이트 하도록 FMOD/FMOD Plus/Force Update를 추가함

[1.1.1]-Beta - 2023-09-01

Fixed

Audio Listener를 FMOD Studio Listener로 변경하는 메뉴 아이템 추가

[1.1.0]-Beta - 2023-08-26

Fixed

FMOD 2.0.17을 기준으로 업그레이드
트리거 이벤트가 파라미터 센더도 되도록 변경

[1.0.19]-Beta - 2023-08-26

Fixed

FMOD Audio Source가 Destroy될 때 오디오가 정지되지 않는 이슈 수정, Audio Source는 객체가 소멸되면 자동으로 오디오가 정지됨
FMOD 플러그인 2.02.15의 Studio Emitter방식으로 변화됨
FMODPlus 디파인 추가

[1.0.18]-Beta - 2023-08-25

Fixed

커맨드 Sender에서 KeyList를 사용할 때 Inital parameter Value에 대한 모호성이 있던 컨셉을 수정

[1.0.17]-Beta - 2023-08-24

Fixed

API Style에서 Key방식을 개편하였습니다.

[1.0.16]-Beta - 2023-08-24

Fixed

커맨드 Sender에서 Initial Parameter가 재대로 처리안되던 문제 해결

[1.0.15]-Beta - 2023-08-23

Fixed

FMOD Studio Listener 아이콘을 변경하는 로직 변경

[1.0.14]-Beta - 2023-07-25

Fixed

커맨드 센더 GUI 수정

[1.0.13]-Beta - 2023-07-25

Fixed

유니티 2021.3 LTS에서도 동작되도록 처리

[1.0.12]-Beta - 2023-07-25

Fixed

MouseDownEvent -> ClickEvent로 변경

[1.0.11]-Beta - 2023-07-25

Fixed

커멘드 센더 리팩터링 완료 경량화 작업 진행함

[1.0.10]-Beta - 2023-07-22

Fixed

About 추가

[1.0.9]-Beta - 2023-07-22

Fixed

파라미터 센더 리팩터링 완료 경량화 작업 진행함

[1.0.8]-Beta - 2023-07-22

Fixed

경로 수정

[1.0.7]-Beta - 2023-07-22

Fixed

Git UPM 지원 중단
글로벌 키 리스트 생성 시 해당 폴더가 없으면 에러나는 이슈 수정

[1.0.6]-Beta - 2023-07-22

Fixed

글로벌/로컬 키 리스트에서 새로운 요소를 만들 때 다른 요소들도 초기화되지 않아있떤 문제 수정

[1.0.4]-Beta - 2023-07-22

Fixed

글로벌/로컬 키 리스트에서 새로운 요소를 만들 때 Path가 비어있는 값으로 생성되지 않던 문제 수정