다음 섹션들은 Wwise 버전 2019.2.8에서 2021.1 사이에 변경 및 개선된 내용을 다루고 있습니다.
플랫폼 전용 정보는 여기에서 확인할 수 있습니다:
이전 버전을 보시려면 이전 버전 릴리즈 노트 를 참고하세요.
새로운 기능
- WG-32040 새로운 쿼리 구문(query syntax)인 Wwise Authoring Query Language (WAQL) 추가로 프로젝트 검색 기능 향상.
- WG-37429 전 뷰에 걸쳐 Property Editor의 윗부분 표준화 및 간결화.
- WG-40303 글꼴 및 크기 선택시 사용자 환경 설정 추가로 접근성 및 가독성 향상.
- WG-42535 Remote Connection 옵션에 Profile Only 모드 추가. 이 새로운 옵션을 사용해 프로파일링할 때 원격 PC나 게임 콘솔에 빠르게 연결할 수 있으며 예기치 않은 동기화로 인한 사운드 엔진 변경을 방지할 수 있습니다.
- WG-43127 중요 Plug-in API 변경 사항! 믹싱 버스에 Object-Based Configuration 사용이 가능해짐.
- WG-43531 (새로운 Wwise Authoring Plug-in API) PropertySet 인터페이스에 State 및 Linked 상태 속성 접근자 추가.
- WG-44017 AkMemoryMgr 에 스톰프 할당자 (stomp allocator) 추가.
AkMemSettings::uMemoryDebugLevel
= 2로 활성화. 유효하지 않은 작성 대부분을 잡아내기 위해 "할당별 페이지" 할당 방식을 사용하는 디버그 전용 할당자입니다. 이 할당자는 속도가 매우 느리며 많은 양의 가상 메모리를 사용한다는 점에 유의하세요. 즉, 개발 기본 설정으로 하기보다 특정한 문제를 확인할 때 사용할 것을 권장합니다.
- WG-46032 (WAAPI) WAAPI의 프로파일링 데이터를 활성화하기 위해
ak.wwise.core.profiler.enableProfilerData
추가.
- WG-46426 WAQL 쿼리 실행을 위해 Query Editor에 새로운 입력란 추가.
- WG-46885 Segment Editor에 메뉴를 추가해 Multi Editor에서 Music Segment Custom Cue 시간 및 색상을 편집할 수 있게 됨.
- WG-46920
AK::MemoryMgr::DumpToFile
추가로 파일에 현재 할당 덤프가 가능해짐.
- WG-46966 AkMemoryMgr 에 런타임 메모리 디버깅 추가.
AkMemSettings::uMemoryDebugLevel
로 접근 가능. 이를 통해 누수 추적 및 기본적인 무결성 확인이 가능해짐.
- WG-47071 Wwise 밖에서 변경한 Work Unit 에 대해 Wwise가 전체 프로젝트를 재로드하는 대신 변경된 Work Unit만 재로드를 시도함.
- WG-47308 성능 탐색 작동 방식을 갖춘 새로운 WEM Opus 코덱이 실험적으로 추가됨.
- WG-47415 Effect가 모니터링 정보를 보여줄 때의 Effect Editor 사용성 개선.
- WG-47487 Conversion Settings에 두 개의 옵션이 새로 추가되어 불러온 사운드를 5.1이나 7.1 포맷으로 강제 변환할 수 있게 됨.
- WG-47492 Wwise Reflect Effect의 상위 버스 환경 설정이 Object-Based인 경우 Audio Objects를 출력할 수 있게 됨.
- WG-47542 API에 두 개의 Spatial Audio 함수를 새로 추가하여, 경로에 회절과 지오메트리를 사용하지 않고 방해(obstruction)를 추가할 수 있게 됨. 새로 추가된 함수:
AKRESULT SetGameObjectToPortalObstruction(AkGameObjectID in_gameObjectID, AkPortalID in_portalObjectID, AkReal32 in_fObstruction)
AKRESULT SetPortalToPortalObstruction(AkPortalID in_portalObjectID0, AkPortalID in_portalObjectID1, AkReal32 in_fObstruction)
- WG-47794
AK::MemoryMgr
에 대한 디버그 C 런타임 할당자 연결 추가.
- WG-47948 Color Picker 버튼에 페인트 팔레트 추가로 외관이 새로워짐.
- WG-48049 Bus Property Editor에서 더 자세한 버스 처리 상태 정보를 볼 수 있게 됨.
- WG-48356 Opus 인코더 Frame Size 매개 변수 삭제. 이로 인해 인코딩 품질에는 영향을 끼치지 않으며 디코딩 성능을 향상시킵니다.
- WG-48591 음악 전환에서 상위 및 하위 오브젝트 필터링 추가.
- WG-48609 기본 assert 핸들러가 스택 추적을 출력함.
- WG-48612 Memory Manager 할당 추적 시스템 추가.
- WG-48811 Music Segment Editor에 사용자 지정 큐 시간을 보여주는 툴팁 추가.
- WG-49192 Remote Connections 대화 상자에 Ping 열 추가.
- WG-49210 (Mac Authoring) 3D 뷰 사용 가능.
- WG-49453 버스가 믹싱(처리) 중인지 여부를 알 수 있는 정보 추가. 믹싱(처리) 중일 경우 버스 아이콘이 나타납니다. 미터 캡션 또한 믹싱중인지 여부를 나타내며, 툴팁은 믹싱(처리) 원인을 알려줍니다.
- WG-49658 (WAAPI)
ak.wwise.core.profiler.getAudioObjects
가 추가돼 프로파일링 세션으로부터 Audio Object를 가져올 수 있음. 또한 ak.wwise.core.profiler.getVoices
및 ak.wwise.core.profiler.getBusses
를 통해 파이프라인 ID를 사용하는 버스나 단일 보이스를 가져오는 기능이 추가됨.
- WG-49689 System Audio Device에서 프로파일링 정보를 볼 수 있게 됨.
- WG-49906 레거시 Opus 코덱이 Audiokinetic의 WEM Opus 인코더로 대체됨.
- WG-49923 System Audio Device에 3D Audio 지원 추가.
- WG-50144 Game Object 3D Viewer에서 활성화된 Emitter 확산 원뿔(spread cone)을 볼 수 있음. 방사 이미터(radial emitter), 공간(room) 및 포털(portal)의 경우, 사운드의 감쇠 ShareSet가 정의한 대로 표시되거나, Spatial Audio가 계산한 대로 표시됩니다.
- WG-50198 Game Object 3D Viewer의 문자 크기를 변경할 수 있는 설정 추가.
- WG-50261 Music Switch Container 아래 Work Unit을 생성하는 기능 추가.
- WG-50456 Value 목록의 Performance Monitor에 접을 수 있는 화면 분할기 추가.
- WG-50503 (새로운 Wwise Authoring Plug-in API) DataWriter에 쓰기 함수를 추가하여 PropertySet 인터페이스와 통일성 개선.
- WG-50632 Transition Matrix의 Transition 이름을 변경할 수 있는 키보드 단축키 F2 추가.
- WG-50699 (Mac Authoring) 프로젝트와 Work Unit 변경 사항을 검색할 수 있는 메뉴 옵션 추가.
- WG-50780 Shift 키를 눌러 WAQL 쿼리를 생성하고 클립보드로 복사하도록 새로운 콘텍스트 메뉴 추가.
- WG-50972 Mastering Suite에서 Object-Based 미터링 지원.
- WG-51105 Spatial Audio:
AK::SoundEngine::SetMultiplePositions
가 Spatial Audio 이미터에서 완전히 지원됨. Spatial Audio가 각각의 사운드 위치에 대해 회절, 전달 및 반사 경로를 계산하도록 개선되었습니다.
- WG-51107 Spatial Audio: Game Object 3D Viewer에 전달 경로가 연관된 전달 손실과 함께 퍼센트로 나타남.
- WG-51236 Music Switch Containers 아래에 Music Transition Filtering 추가 및 Work Units 추가.
- WG-51261 Spatial Audio: 변조 경로의 각 연결에 대해 계산된 전달 손실 값이 업스트림과 다운스트림 공간의 최대값으로 됨. 이전에는 이 값이 연결의 공간 업스트림과 리스너의 공간 업스트림의 최대값으로 사용되었습니다.
- WG-51277 List View에 "Plug-in Name" 열 추가.
- WG-51315 (WAAPI) "pluginName" 접근자 추가.
- WG-51347 Spatial Audio: 하나 이상의 포털을 통과하는 모든 사운드 경로에 대해 열린 구멍(aperture) 값이 계산됨. 이 구멍은 경로를 따라 열려있는 가장 작은 포털을 나타내며, 리스너의 입체 중심 내각 근사치로 측정됩니다. 열린 구멍은 사운드의 최대 확산 값을 제한하며, Advanced Profiler의 Obs/Occ 탭에서 확인할 수 있습니다.
- WG-51421 Spatial Audio: 포털 확산 계산 알고리즘 개선. 새로운 알고리즘은 더욱더 효율적이며, 리스너가 포털에서 90도로 축을 벗어난 경우 0으로 떨어져 내려가는 걸 방지합니다.
- WG-51465 Spatial Audio: 방사상 음원 지원을 위해 새로운 API
AK::SpatialAudio::SetGameObjectRadius
추가.
- WG-51541 Spatial Audio: Transmission Loss에 새로운 내장 Game Parameter 추가.
- WG-51581 플러그인이 연결 해제 모드에서 Object-Based 오디오를 처리할 때마다 Mastering Suite에서 경고 아이콘이 발행됨.
- WG-51650 Spatial Audio: 측면에서 포털로 들어왔을 때 연속성을 높이기 위해 Portal 전환 영역이 포털의 열린 부분의 중심으로부터 방사상으로 확장됨.
- WG-51677 캡처하고있지 않을 때에도 실시간 플러그인 모니터링 데이터를 보여줌.
- WG-51772 그동안 캡처된 프로파일링 세션 내역이 Meter에 나타남.
- WG-51879 Spatial Audio: 비활성화된 포털로만 연결된 공간들 간 전달 경로를 통해 잔향(reverb)과 공간 톤(room tone)이 전달됨. 비활성화된 포털은, 공간 간 회절 경로가 필요 없을 때에 한해 잔향 전달의 목적으로 공간끼리 연결할 때 사용할 수 있습니다.
API 개선 사항
- WG-44180 (WAAPI) 루트 경로 "\"를 쿼리하여 Project 오브젝트에 접근할 수 있게 됨. 프로젝트의 경로를 쿼리하면 '\'를 반환합니다.
- WG-47068 (WAAPI) ":" 문자가 포함된 접근자가 세미콜론 없이 별칭으로 존재하게 됨.
ak.wwise.core.object.get
참고.
- WG-47378
AK::IAkMixerPluginContext::Compute3DPositioning
이 Spread와 Focus 값을 0에서 1 사이에서 취함.
- WG-47493 (WAAPI)
ShowListView
, ShowSchematicView
, Search
명령에서 문자 값(예: 문자열)을 취해 프로젝트에서 문자를 검색할 수 있게 됨.
- WG-47651 다음 내용이 변경되었습니다.
- WG-48177 Memory Manager 인터페이스에 정렬된 realloc 추가.
- WG-48344 rpmalloc 1.4 병합. 미디어 할당에 대해 캐시 오버헤드를 줄이도록 rpmalloc 최상의 힢(heap)을 사용.
- WG-48570
AK_ALIGN_DMA, AK_ALIGN_FASTDMA
및 AK_ALIGN_SIZE_FOR_DMA
매크로 삭제. 오랜 기간 동안 이 두 매크로에 아무런 정의가 없었기 때문에 해당 매크로의 사용이 제거됩니다.
- WG-48746 게인 패닝을 계산하기 위해 새로운 플러그인 서비스
AK::IAkMixerPluginContext::ComputePositioning
추가.
- WG-49885 SpatialAudio API 업데이트: AkPortalParams Extent 타입이AkExtent의 AkVector에서 변경되어, halfWidth, halfHeight 및 halfDepth 멤버 사용. 이 내용은 해당 좌표 시스템에 따라 게임에서 설정돼야 합니다.
- WG-50061 버스 또한 게임 오브젝트에 연결돼있으므로
AK::IAkVoicePluginInfo
가 AK::IAkGameObjectPluginInfo
로부터 상속되지 않음. 기본 클래스 IAkPluginContextBase
에 IAkPluginContextBase::GetAudioNodeID()
가 추가되고, GetBusID와 같은 중복 접근자가 삭제되었습니다.
- WG-50236 Wwise Authoring Plug-in API가 주제 분류 방식 및 호환성을 개선하기 위해 재작성되었습니다.
- WG-50501 레거시 플러그인 API에서 지원되지 않는
WritePascalString
과 WriteUtf16String
함수 삭제.
- WG-50872 (WAAPI) "skin"을 "theme"으로 명칭 변경.
ReloadCurrentSkin
명령 이름이 ReloadCurrentTheme
으로 변경되었습니다.
- WG-51017 믹싱(
MixChannel
, Mix1inNChannels
, MixNinNChannels
, ApplyGain
, ApplyGainAndInterleave
)의 AK::IAkGlobalPluginContext
내 일부 함수를 새로운 인터페이스인 AK::IAkPluginServiceMixer
로 이동. AK::IAkGlobalPluginContext::GetPluginService()
를 호출하거나 AK_GET_PLUGIN_SERVICE_MIXER
매크로를 이용해 해당 인터페이스를 가져올 수 있습니다. 향후, 다른 신호 처리 함수가 이 인터페이스에 추가될 예정이며, 다른 "서비스" 인터페이스에도 추가되어 플러그인 개발자들이 특정 프로세스에 대한 향상과 같은 Wwise 내 기존 Effect 기능을 잘 활용할 수 있도록 할 예정입니다.
- WG-51251 중요 변경 사항! "디버그" 버전 함수를 삭제해 플러그인 할당 인터페이스
IAkPluginMemAlloc
을 간소화. 메모리 디버그 기능은 플러그인 호스트에 숨겨져있습니다.
- WG-51622 플러그인 API의
NotifyMonitorData
에 타임스탬프 추가.
- WG-51809 (새로운 Wwise Authoring Plug-in API) 모니터링 함수에서 바이트 교체 플래그 삭제 (리틀 엔디안으로 가정).
- WG-52710 - QueryDiffractionPaths API를 사용할 때, 회절 경로에 사용되는 이미터의 위치 반환을 위해 AkDiffractionPathInfo 에 emitterPos 영역 추가.
- QueryDiffractionPaths API를 사용할 때, 이미터의 현재 전달 손실 정보를 반환을 위해 AkDiffractionPathInfo 에 transmissionLoss 영역 추가.
- WG-53241 PlatformID 네임스페이스에서 더 이상 사용하지 않는 플랫폼 삭제.
작동 방식 변경 사항
- WG-48027 Spatial Audio에서, 포털을 통과하는 변조 경로(wet path)의 확산 계산이 개선됨.
- WG-48038 출력 버스의 채널 환경 설정이 완전히 3D이거나 (즉, 높이 채널이 있음), 앰비소닉이거나, 또는 Object-Based인 경우, 확산(spread)과 집중(focus)을 계산하는 데 사용되는 거리가 이미터와 리스너 간 실제 거리와 동일함.
- WG-48178 AkArray가 정렬된 realloc을 사용.
- WG-48575 메모리 부족 알림에 메모리 타입 관련 정보를 추가적으로 보여줌.
- WG-50447 모든 Wwise 잔향 Effect에서, 재생 전 선지연 초기화를 하도록 선지연(predelay) 매개 변수로 Exclusive RTPC 지원을 추가.
- WG-50776 비활성화된 포털만 연결돼있는 Room들ㄴ간 사운드가 전달됨.
- WG-52087 매 프레임에서 성능 지표 보고.
- WG-53299 AkGlobalCallbackLocation_PostMessagesProcessed 전역적 콜백 위치의 작동 방식이 렌더링된 버퍼당 한 번만 콜백이 시행되도록 변경됨. 현재 버퍼와 이전 버퍼 사이에서, 이전에는 렌더링된 버퍼당 해당 콜백이 여러 번 실행됐었지만 이제는 메시지가 처리됐을 때 실행됩니다. 콜백 위치는 바뀌지 않았습니다.
성능 개선 사항
- WG-47172 AVX2를 사용하는 오디오 리샘플링 알고리즘의 성능 개선. 특히, 대부분의 Vorbis 오디오 음원을 재생할 때 처리량 성능을 10% 향상시킵니다.
- WG-47544 AVX2가 활성화된 플랫폼에서 Fast Fourier Transform (FFT) 알고리즘을 사용하는 Effect 성능이 개선됨. 이로 인해 다음과 같은 내용이 개선되었습니다.
- Convolution Reverb와 Filter Effect의 처리량이 1.3 ~ 1.7배 가량 개선됨.
- Harmonizer와 Time Stretch Effect의 처리량이 1.5 ~ 1.75배 가량 개선됨.
- WG-51121 Mastering Suite의 Limiter 모듈의 고급 모드가 최적화됨. 이 모듈은 이제 37% 더 효율적입니다.
- WG-51334 Spatial Audio 모니터링 데이터 메모리 사용 개선.
- WG-51775 성능 개선을 위해 미터 출력이 최적화됨.
기타 수정 사항
- WG-41575 Profiler Settings에서 Obstruction/Occlusion Data 및 SoundBank Data가 기본 설정으로 활성화돼있음.
- WG-45796 Make-Up Gain 속성의 위치가 Source Settings에서 General Settings로 변경.
- WG-47656 IntegrationDemo에 새로운 3D Audio Objects 데모 페이지 추가.
- WG-48720 2013.1 이전 버전의 Wwise Project에 대한 마이그레이션 지원 삭제. 이들 예전 프로젝트를 2019.2로 먼저 마이그레이션한 다음 2021.1로 마이그레이션하는 것은 가능합니다.
- WG-50376 Reflect로부터 음향 질감(acoustic texture) 팩토리 에셋 분리.
- WG-50769 192 kHz 오디오 파일 가져오기가 가능해짐.
- WG-51039 AkSpatialAudioVolume의 Unreal Editor 내 Details 패널 업데이트. 여러 Spatial Audio Volumes의 여러 표면에 대해 표면 리플렉터를 변경할 수 있게 되었습니다.
- WG-51169 Mastering Suite Effect가 Master Audio Bus 대신 Audio Device에 삽입되었습니다.
- WG-51546 Room Extent Opacity 슬라이더 위치가 Game Object 3D Viewer Settings 내 Spatial Audio Debug 섹션으로 변경됨.
버그 수정
- WG-41982 수정됨: (Windows Authoring) 크래시 덤프가 잘못된 OS 버전 번호를 표시하는 문제.
- WG-43214 수정됨: Windows에서 저작할 때 드라이브의 루트에서 SoundBank가 생성되지 않는 문제.
- WG-44531 수정됨: Wwise Wave Viewer가 파일 잠금을 풀지 못하는 오류.
- WG-45632 수정됨: Source Editor에서 2차 재생헤드가 중지돼있을 때 위치를 변경할 수 있는 문제.
- WG-46046 수정됨: Game Sync Monitor와 Voices Monitor에서 스크롤할 때 눈금자에 나타나는 시각적 오류.
- WG-46286 수정됨: WwiseConsole.exe에서 move-media-ids-to-single-file이나 move-media-ids-to-work-units를 실행할 때 피드백이 없는 문제.
- WG-46388 수정됨: 프로파일링 도중 Commcentral.lib을 사용하지 않을 경우에도 Commcentral.lib와 강제로 연결해야 하는 불필요한 종속성.
- WG-46564 수정됨: 여러개의 미디어 구성요소가 있는 플러그인에서, 미디어 알림이 즉각적인 효과가 없는 문제.
- WG-47257 수정됨: 유효하지 않은 이름으로 새로운 프로젝트를 생성할 때 OK와 Cancel 버튼에 발생하는 시각적 오류.
- WG-47312 수정됨: 활성화된 단축 ID (short ID)가 없는 경우에도 Copy Short ID(s) to Clipboard 메뉴가 나타나는 문제.
- WG-48209 수정됨: 일부 영역에서 Project Explorer 창이 클릭되지 않는 현상.
- WG-48719 수정됨: 리스너가 다른 폐쇄된 공간에 있을 경우 Room Tone 변조 경로 차단(wet path occlusion)이 두 번 중복하여 적용되는 현상.
- WG-48757 수정됨: 키보드 포커스가 목록 내 체크 상자에 있을 경우 스페이스 바를 눌러도 재생되지 않는 현상.
- WG-48798 수정됨: Property Editor의 타이틀 바가 현재 선택된 오브젝트를 반영하지 않는 문제.
- WG-49197 수정됨: File Manager 대화창에서 폴더 경로가 가끔 보이지 않거나 위치가 어긋나는 현상.
- WG-49720 수정됨: 탭 전환을 위한 Property Editor 단축키(Ctrl+1, Ctrl+2, 등)가 작동하지 않는 문제.
- WG-49807 수정됨: 재생 도중 Mastering Suite에서 ShareSet를 변경하면 들리는 결함음.
- WG-50027 수정됨: (WAAPI) The commands OpenContainingFolderWorkUnit, OpenContainingFolderWAV, OpenContainingFolderSoundbank 명령을 WAAPI에서 실행하면 실패하는 현상.
- WG-50155 수정됨: Plug-in API 1.0과 2.0에서 GetDialog를 오버라이드할 때 아무런 출력 매개 변수를 설정하지 않은 경우 발생하는 크래시.
- WG-50227 수정됨: High DPI로 여러 화면을 사용할 때 슬라이더가 예기치 않게 움직이는 현상.
- WG-50337 수정됨: Master-Mixer Hierarchy에서 버스의 Meter 표시가 캡처 세션 동안만 작동하는 문제.
- WG-50432 수정됨: Game Sync Monitor에서 게임 오브젝트를 음소거할 경우 Mute와 Solo 필터링이 작동하지 않는 문제.
- WG-50668 수정됨: Vorbis 변환에서 일부 임시 파일이 제대로 삭제되지 않는 문제.
- WG-50702 수정됨: High DPI 디스플레이에서 Wave Viewer가 올바르게 나타나지 않는 문제.
- WG-50906 수정됨: 게임 오브젝트가 이미터이자 동시에 리스너이기도 할 경우, 해당 게임 오브젝트 환산 계수가 두 번 중복해서 적용되는 현상.
- WG-51726 수정됨: 색상 선택 장치가 화면의 끝에 가까워지면 사라지는 문제.
- WG-52515 수정됨: Wwise 오브젝트의 네스팅된 폴더를 이동시키면 발생하는 WAAPI 에셋 동기화 문제.
- WG-52517 수정됨: 플랫폼이 변경됐을 때 All Properties 탭이 올바르게 업데이트되지 않는 문제.
- WG-52754 수정됨: Sound Engine에서 AkTransitionManager::ProcessTransitionList에 발생할 수 있는 크래시.
- WG-52896 수정됨: 초기 반사 버스로 사용된 Auxiliary Bus의 출력에 방해(obstruction)가 적용되는 현상. 이 현상이 올바르지 않은 이유는, 각 반사(허음원, image source)가 Spatial Audio에서 개별적으로 평가되어 그에 따라 각각 방해를 받을 수도, 아닐 수도 있기 때문입니다.
- WG-53142 수정됨: AkMemSettings::uMemAllocationSizeLimit가 장치 메모리를 초과할 수 있는 문제.
- WG-53325 수정됨: 커스텀 첨부 믹서 플러그인 GUI의 크기가 올바르지 않은 문제.
커뮤니티에 보고된 버그 수정
- WG-47156 수정됨: 준비(prepare) 요청에서 발생하는 교착 상태.
- WG-48504 수정됨: 시작할 때 일부 Wwise 스레드가
AK::MemoryMgr::InitForThread
를 호출하지 않는 문제.
- WG-49195 수정됨: SoundBank를 생성할 때 생성 전후 과정에서 발생할 수 있는 크래시.
- WG-51912 수정됨: Audio File Conversion 오류의 심각도(severity)를 변경할 수 없는 문제.
- WG-52764 수정됨: 메인 메뉴를 사용할 때 발생할 수 있는 크래시.
- WG-53081 수정됨: 닫힌 Portal이 있는 Unreal 게임을 종료할 때 Unknown Game Object ID가 보고됨.
- 참고
-