Wwise SDK 2024.1.4

2024.1에 새로운 기능이 추가됨에 따라 ( 새로운 기능 개요 2024.1 참고 ), Wwise 2024.1로 마이그레이션할 때 다음 사항에 주의하시기 바랍니다.

XMA 코덱 삭제

Wwise에서 더 이상 XMA 코덱을 지원하지 않습니다. Conversion Settings에서 XMA 형식을 사용하는 기존 Wwise 프로젝트는 자동으로 Vorbis를 사용하도록 변경됩니다. 이전 미디어 애셋은 호환되는 소프트웨어 코덱으로 재변환되어야 합니다.

2021.1 이전의 레거시 Authoring 플러그인 API

2023.1에서 더 이상 사용되지 않는 기존 Authoring 플러그인 API가 삭제되었습니다. 2021.1에 새로 도입된 API로 플러그인을 가져오려면 Migrating a pre-2021.1 Authoring Plug-in 을 참조하세요.

WAAPI 프로파일러 데이터 타입 변경

WAAPI에서 ak.wwise.core.profiler.enableProfilerData 함수가 더 이상 preparedEvents를 유효한 데이터 타입으로 허용하지 않습니다. 해당 이름이 preparedObjects로 변경되었습니다. 이 새로운 데이터 타입은 AK::SoundEngine::PrepareEvent를 사용하여 준비된 Event와 AK::SoundEngine:PrepareBus를 사용하여 준비된 Bus를 지원합니다.

WAAPI 반사(Reflection) 변경

WAAPI에서 ak.wwise.waapi.getFunctions 및 ak.wwise.waapi.getTopics 함수는 이제 콘솔에서 호출되는지 아니면 UI 모드에서 호출되는지에 따라 지원되는 함수나 주제만 반환합니다.

IAkLowLevelIOHook::BatchCancel 삭제

IAkLowLevelIOHook::BatchCancel 함수가 하위-레벨 I/O 인터페이스에서 삭제되었습니다. 프로젝트에서 IAkLowLevelIOHook의 사용자 정의 구현을 사용하는 경우 BatchCancel 함수 오버라이드를 삭제하세요. Wwise SDK에서 제공하는 샘플 구현을 사용하면 별도의 조정이 필요하지 않습니다.

WAAPI 화면 캡처 변경 사항

WAAPI에서 ak.wwise.ui.captureScreen 함수가 이전에는 표시명(제목)을 인수로 사용하여 뷰를 식별했었습니다. 이제는 고유한 ID 이름을 사용합니다. 사용 가능한 모든 뷰 이름 목록은 Wwise Authoring View Identifiers 을(를) 참조하세요.

Memory Manager 통합 변경 사항

AkMemoryArena가 새로운 기본 메모리 할당자이기 때문에 메모리 시스템의 일부 초기화 설정과 콜백이 변경되었습니다.

AkMemSettings::uMemAllocationSizeLimit가 제거되었습니다. 이제 각 아레나에 대해 AkMemoryArenaSettings::uMemReservedLimit의 값이 별도로 있습니다.
AkMemSettings::pfAllocVM, AkMemSettings::pfFreeVM, AkMemSettings::pfAllocDevice 및 AkMemSettings::pfFreeDevice가 제거되었습니다. 대신 AkMemoryArenaSettings::fnMemAllocSpan과 AkMemoryArenaSettings::fnMemFreeSpan을 사용하여 각 AkMemoryArena 에 대한 메모리 블록을 예약합니다.
AkMemSettings::bEnableSeparateDeviceHeap이 제거되었습니다. Device AkMemoryArena를 비활성화하려면 AkMemoryArenaSettings::fnMemAllocSpan을 nullptr로 설정하세요.
AkMemSettings::uVMPageSize, AkMemSettings::uDevicePageSize, AkMemSettings::uMaxThreadLocalHeapAllocSize, AkMemSettings::uVMSpanCount, AkMemSettings::uDeviceSpanCount는 rpmalloc의 아키텍처에만 해당되기 때문에 제거되었습니다.

AkMemSettings 구조체에서 AkMemoryArenas를 구성하는 방법에 대한 자세한 내용은 AkMemoryArenas의 환경 설정 및 튜닝 을(를) 참조하세요.

AKPLATFORM::AllocVM, AKPLATFORM:FreeVM AKPLATFORM::AllocDeviceVM , AKPLATFORM:FreeDeviceVM 함수도 이에 따라 업데이트되었고, AKPLATFORM:AllocSpan, AKPLATFORM::FreeSpan, AKPLATFORM:AllocDeviceSpan, AKPLATFORM::FreeDeviceSpan으로 이름이 변경되었습니다.

AK::SoundEngine::SetSpeakerAngles API 개선 사항

높이 레이어의 각도를 정의하는 in_fHeightAngle 매개 변수의 기본값이 30도로 변경되었습니다. 이제는 현재 스피커 구성에 높이 채널이 없더라도 이 값을 0으로 전달하는 것이 불가능합니다.

탭으로 구분된 가져오기의 속성 이름 변경

다음 속성의 이름이 변경되었습니다. 탭으로 구분된 가져오기 파일에서 이러한 항목을 사용하는 경우 해당 항목도 적절히 변경해야 합니다.

기존 이름	새로운 이름
Enable Diffraction	Diffraction and Transmission
Enable Envelope	Enable Envelope Tracking
Global Or Per Object	Scope
Grid Frequency Preset	Grid Frequency
Grid Offset Preset	Grid Offset
Is Looping Enabled	Loop
Is Looping Infinite	Loop Infinite
Is Streaming Enabled	Stream
MIDI tracking root note	MIDI Note Tracking Root
Output Bus High-pass Filter	Output Bus HPF
Output Bus Low-pass Filter	Output Bus LPF
Override Parent MIDI Target	Override MIDI Target
Random or Sequence	Play Type
Step or Continuous	Play Mode
Switch/State	Default Switch/State
Use Priority Distance Factor	Use Offset Priority
User Auxiliary Send 0	User-Defined Auxiliary Send 0
User Auxiliary Send 1	User-Defined Auxiliary Send 1
User Auxiliary Send 2	User-Defined Auxiliary Send 2
User Auxiliary Send 3	User-Defined Auxiliary Send 3
Virtual voice behavior	When Limit is Reached
Voice High-pass Filter	Voice HPF
Voice Low-pass Filter	Voice LPF

속성 이름 When Limit is Reached는 속성 ID OverLimitBehavior에만 적용됩니다. BelowThresholdBehavior 속성 ID에는 적용되지 않습니다.

이 페이지가 도움이 되었나요?

지원이 필요하신가요?

질문이 있으신가요? 문제를 겪고 계신가요? 더 많은 정보가 필요하신가요? 저희에게 문의해주시면 도와드리겠습니다!

지원 페이지를 방문해 주세요

작업하는 프로젝트에 대해 알려주세요. 언제든지 도와드릴 준비가 되어 있습니다.

프로젝트를 등록하세요. 아무런 조건이나 의무 사항 없이 빠른 시작을 도와드리겠습니다.

Wwise를 시작해 보세요

Wwise SDK

중요한 마이그레이션 참고 사항 2024.1