2022.1 버전 새로운 기능이 추가됨에 따라, Wwise 2022.1로 마이그레이션할 때 다음 사항에 주의하시기 바랍니다.

WAAPI 이전 버전과의 호환성에 영향을 주는 변경 사항

Capture Log는 이제 Music Object 간의 전환 외에도 Music Playlist 목록 콜백을 보고합니다. 이 두 항목은 이제 프로파일러 설정의 Interactive Music 이름으로 그룹화됩니다. 변경 사항 반영 내용:

• ak.wwise.core.profiler.enableProfilerData : "musicTransitions"가 "interactiveMusic"으로 이름이 변경되었습니다.
• ak.wwise.core.profiler.captureLog.itemAdded : "MusicTransitions"가 "InteractiveMusic"으로 이름이 변경되었습니다.
• ak.wwise.core.profiler.enableProfilerData : "inactiveGameSyncs"가 "gameSyncs"로 이름이 변경되었습니다.
• Wwise Object MusicTrack 및 Sound의 "IsZeroLantency" 속성: "IsZeroLantency"가 "IsZeroLatency"로 오타가 수정되어 이름이 변경되었습니다.
• 함수 ak.wwise.ui.captureScreen 인자 "viewSyncGroup"이 "viewSelectionChannel"로 이름이 변경되었습니다.
• Wwise Object Sound의 접근자 originalWavFilePath가 "originalFilePath"로 이름 변경되었습니다.
• Wwise Object Sound의 접근자 convertWemFilePath가 "convertedFilePath"로 이름이 변경되었습니다.
• ak.wwise.core.remote.getAvailableConsoles : "notificationPort"가 삭제되었습니다.
• ak.wwise.ui.commands.execute 와 관련하여 다음 명령의 이름이 변경되거나 제거되었습니다.
  • "ShowUserProjectSettings"의 이름이 "ShowDefaultObjectValues"로 변경되었습니다.
  • "ShowPropertyHelp"의 이름이 "ShowContextualHelp"로 변경되었습니다.
  • "FindInProjectExplorerSyncGroup1"의 이름이 "FindInProjectExplorerSelectionChannel1"로 변경되었습니다.
  • "FindInProjectExplorerSyncGroup2"의 이름이 "FindInProjectExplorerSelectionChannel2"로 변경되었습니다.
  • "FindInProjectExplorerSyncGroup3"의 이름이 "FindInProjectExplorerSelectionChannel3"로 변경되었습니다.
  • "FindInProjectExplorerSyncGroup4"의 이름이 "FindInProjectExplorerSelectionChannel4"로 변경되었습니다.
  • "FindInProjectExplorerNoSyncGroup"의 이름이 "FindInProjectExplorerNewPinnedView"로 변경되었습니다.
  • "ProfilerFilterSetKeyboardFocusToCurrent"가 삭제되었습니다.

Mixer Plug-ins 지원 종료 발표

Wwise 2022.1이 Mixer 플러그인을 지원하는 마지막 메이저 버전이 될 것임을 발표합니다. 2022.1의 마이너 버전에서 지원하지만 향후 메이저 버전에서는 지원하지 않습니다. Mixer Plug-ins을 비활성화 하는 파이프라인에 대해서는 오브젝트 기반 오디오 이해하기를 참고하세요.

SoundFrame 삭제

SoundFrame은 더 이상 Wwise에 포함되지 않습니다. Wwise 2021.1은 SoundFrame을 지원하는 마지막 메이저 버전이었습니다. SoundFrame을 대체하는 Wwise Authoring API(WAAPI)에 대한 자세한 내용은 Wwise Authoring API (WAAPI, Wwise 저작 API) 사용하기 를 참고하세요.

Spatial Audio Initialization Settings 삭제

2022.1에서 두 개의 Spatial Audio Initialization Settings (bUseObstruction 및 bUseOcclusion)이 제거되었습니다. Wwise의 이전 버전에서는 이러한 매개 변수가 기본적으로 true로 설정되었습니다. 회절 및 전달(transmission) 손실 값은 각각 프로젝트 방해(obstruction) 및 폐색 곡선과 함께 사용되었습니다. bUseObstruction 및/또는 bUseOcclusion을 false로 설정하여 이러한 곡선의 사용을 비활성화할 수 있습니다. 대신 RPTC와 함께 내장 매개 변수를 단독으로 사용합니다.

Wwise 2022.1에서는 이제 회절 및 전달(transmission) 손실에 의해 구동되는 사운드당 곡선을 생성할 수 있습니다. 이 곡선은 이전과 같이 프로젝트 방해(obstruction) 및 폐색 곡선을 사용하거나 개별적으로 사용자 정의하거나 비활성화할 수 있습니다. 이러한 변경으로 인해 bUseObstruction 및 bUseOcclusion 매개 변수가 더 이상 사용되지 않습니다. 따라서 삭제됩니다.

이 매개 변수 중 하나 또는 둘 모두를 false로 설정한 경우 회절 및/또는 전달에 의해 이전에 영향을 받은 각 사운드에 대해 회절 및/또는 전달(transmission)에 의해 구동되는 곡선을 수동으로 비활성화할 수 있습니다. Curve를 None으로 설정하여 사운드에 적용된 감쇠 ShareSet에서 이러한 곡선을 비활성화할 수 있습니다.

Spatial Audio Geometry Instance

2022.1 버전에서는 Spatial Audio가 Geometry Instance를 지원합니다. 사용자는 Geometry Instance를 이용해 여러 개의 Geometry Set 복사본을 각각의 고유한 위치, 비율, 방향으로 만들 수 있습니다. AK::SpatialAudio::SetGeometry 호출하면 지오메트리 데이터를 Wwise Aptial Audio로 전송하지만, Geometry Instance를 생성하지 않고는 씬에 추가되지 않습니다. 각각의 Geometry Set에 대해 AK::SpatialAudio::SetGeometryInstance 를 호출해 Geometry Instance를 생성하여 음향 시뮬레이션을 위해 씬에 추가시켜야 합니다.

레거시 Wwise Command Line Interface (WwiseCLI) 삭제

Wwise 2022.1은 다음과 같은 레거시 Wwise 명령줄 인터페이스를 제공하지 않습니다. WwiseCLI.exe. 레거시 Wwise 명령줄 인터페이스를 대체한 Wwise 콘솔에 대한 자세한 내용은 명령줄 사용하기 을(를) 참조하세요.

Reflect 플러그인 곡선 삭제

Reflect 플러그인 거리 감쇠(이미터 및 리스너) 곡선이 삭제되었습니다. 이전에는 이 곡선을 사용하여 리스너와 이미터 게임 오브젝트 사이의 거리에 따라 Reflect 플러그인의 출력 볼륨 감쇠를 정의할 수 있었습니다. 지금도 Reflect Auxiliary Bus에 배치된 Attenuation ShareSet의 거리 기반 볼륨 감쇠 곡선을 사용하여 동일한 동작을 얻을 수 있습니다. 이러한 이유로 프로젝트를 Wwise 2022.1로 마이그레이션할 때 Reflect Effect의 비평탄 거리 감쇠(이미터 대 리스너) 곡선에 대해 새로운 감쇠 ShareSet이 자동으로 생성됩니다.

마이그레이션 전에 다른 감쇠가 설정되지 않은 경우 새로 생성된 각각의 감쇠 ShareSet이 해당하는 Reflect Auxiliary Bus에 추가됩니다. 이렇게 하면 Reflect Effect가 이전과 동일한 방식으로 작동합니다. Reflect Auxiliary Bus에 이러한 곡선이 있는 하나 이상의 Reflect Effect가 있는 경우 새 Attenuation ShareSet 중 하나만 추가됩니다.

이 새로운 디자인에서는 이미터의 위치에 의해 구동되는 감쇠 곡선과 이미지 소스의 위치에 의해 구동되는 Reflect Effect 곡선이 명확하게 구분됩니다.

CopyStreamedFiles.exe 삭제

이전에 Samples 디렉터리에 제공된 도구인 CopyStreamedFiles.exe가 삭제되었습니다. 이 도구는 루즈(loose)/스트리밍된 미디어 파일을 출력 폴더로 복사하기 위한 Post-SoundBank 생성 단계로 사용되었습니다. 미디어 파일 복사는 SoundBank 생성 프로세스에 통합되었으며 SoundBanks 프로젝트 설정 Copy Loose/Streamed Media를 통해 구성됩니다. Wwise는 CopyStreamedFiles.exe 사용을 새로 통합된 복사 시스템으로 마이그레이션합니다.

참고: CopyStreamedFiles.exe를 사용하려면 SoundBank 생성 프로세스에서 SoundBank 메타데이터 파일인 SoundBanksInfo.xml도 생성해야 했습니다. 이 파일은 더 이상 필요하지 않습니다.

AK::Wwise::ISourceControl 변경 사항

Wwise는 이제 생성된 파일에 대한 소스 컨트롤 업데이트를 제공합니다. 이를 달성하기 위해 소스 컨트롤 인터페이스에 다음 변경 사항이 도입되었습니다.

새로운 No-UI Commands

새로운 ui-free 명령이 AK::Wwise::ISourceControl::PluginInfo 에 추가되었습니다:

• m_dwAddNoUICommandID
• m_dwRevertNoUICommandID
• m_dwCheckOutNoUICommandID

생성된 파일에 대해 AK::Wwise::ISourceControl::OperationMenuType에 새로운 작업 유형이 추가되었습니다:

• OperationMenuType_Generated

샘플 소스 컨트롤 플러그인이 이러한 명령을 구현하도록 업데이트되었습니다.

새로운 인터페이스 메소드

새로운 메소드가 인터페이스에 추가되었습니다:

• AK::Wwise::ISourceControl::CheckFilesForOperation
• AK::Wwise::ISourceControl::FilesUnderSourceControl

샘플 소스 컨트롤 플러그인이 이러한 명령을 구현하도록 업데이트되었습니다.

성능 개선 사항

File Manager의 파일 목록이 확대됨에 따라 사용자 환경이 개선되었습니다. 빠른 열 업데이트를 위해 새로운 함수가 추가되어 한 번의 호출로 해당 파일의 아이콘과 상태를 한꺼번에 가져옵니다.

• AK::Wwise::ISourceControl::GetFileStatusAndIcons

또한, GetFileStatus 와 GetFileStatusIcons 호출 대부분이 비동기화되어 소스 컨트롤이 정보를 가져오는 동안 사용자가 자유롭게 인터페이스를 사용할 수 있게 되었습니다.

소스 컨트롤 컨테이너 변경 사항

소스 컨트롤 컨테이너의 일부 함수가 내부 반복자를 무효화합니다 (추가, 삽입, 삭제 값 및 GetHeadPosition과 GetTailPosition). 한 번에 컨테이너당 하나의 AkPos만 유효할 수 있습니다.

컨테이너 구현이 MFC가 아닌 표준으로 변경되었습니다.

새 미디어 파일 레이아웃

출력 디렉터리당 증가하는 파일 수를 해결하기 위해 Wwise는 미디어 파일을 Media라는 새 하위 폴더로 이동했습니다. 이 폴더에는 루트 폴더와 동일한 폴더 계층 구조가 있습니다. 즉, 현지화되지 않은(non-localized) 미디어는 루트에 배치되고 현지화(localized) 미디어는 하위 폴더로 분리됩니다. Wwise와 함께 제공되는 Sample File Resolver는 이 새로운 파일 레이아웃에 대응합니다. SoundBanks 프로젝트 설정 Copy Loose/Streamed Media가 활성화된 경우 SoundBank 생성 프로세스는 미디어 파일을 올바른 위치에 복사합니다.

폴더당 미디어 파일 수를 더 줄이기 위해 Wwise는 위에서 설명한 각 폴더를 나누는 옵션을 제공합니다. 미디어 파일은 파일 이름의 첫 두 글자를 사용하여 하위 폴더에 배치됩니다. 예를 들어, 미디어 파일 1234.wem은 하위 폴더 /12에 배치됩니다. 이 새 하위 폴더는 SoundBanks 프로젝트 설정 Sub-Folders for Generated Files를 통해 활성화됩니다. Wwise와 함께 제공되는 Sample File Resolver를 사용하는 동안 하위 폴더를 사용하려면 CAkMultipleFileLocation::SetUseSubfoldering() 메소드를 사용하세요.

자세한 내용은 SoundBank 출력 폴더 레이아웃을 참고하세요.

Bank Load/Unload 함수를 위한 새 매개 변수 AkBankType

Wwise는 이제 자동 정의 SoundBank를 제공합니다. 이러한 새 SoundBank에는 사용자 정의 SoundBank와 충돌하는 이름/ID가 있을 수 있습니다. AkBankID의 범위를 지정하기 위해 모든 Bank Load/Unload 함수에 AkBankType 새 매개 변수가 도입되었습니다. 새 매개 변수는 사용자 정의 SoundBank에 대한 AkBankType_User의 기본값으로 설정됩니다. (자동 정의 SoundBank를 지정하는 데 다른 값이 사용됩니다.) 대부분의 Bank Load/Unload 함수 호출은 사용자가 변경할 필요가 없습니다.

SoundBank Metadata Files 변경 사항

SoundBank 메타데이터 파일의 내용과 형식이 재작업되었습니다. 이는 모든 SoundBank 파일, SoundBankInfo.(json,xml), SoundBank별 파일 및 WAAPI 함수 ak.wwise.core.soundbank.generated 의 콘텐츠에 영향을 줍니다. 이러한 정보를 사용하는 모든 사용자 지정 도구가 올바르게 조정되어야 합니다.

이러한 변경은 자동 정의 SoundBank의 도입과 함께 이루어졌습니다. 자세한 내용은 SoundBank 자동 정의하기를 참고하세요.

iOS 중단 처리 재설계

Apple Human Interface Guidelines에 따라 iOS 중단 처리가 재설계되었습니다. 자세한 내용은 플랫폼별 섹션을 참고해 주세요.

Game Object의 대규모 월드 좌표

Wwise 사운드 엔진이 이제 이중 정밀 값을 통해 위치를 조정하여 Game Object에 대한 대규모 월드 좌표를 지원합니다. 이로 인해 수십억 단위의 대규모 월드에서도 사운드 위치 지정이 예상한 대로 동작하게 됩니다. Game Object 위치를 다루는 API가 업데이트되어 추가 데이터를 제공하는 두 개의 새로운 타입, 즉 AkWorldTransform과 AkVector64를 사용합니다. 여기에는 AkSoundPosition 과 AkListenerPosition 의 typedefs 가 AkTransform 에서 AkWorldTransform 로 변경된 내용도 포함돼있습니다.

암묵적 변환 함수가 제공되어 AkTransform 에서 AkWorldTransform 로의 변경 및 AkVector 에서 AkVector64 로의 변경이 기존 코드와 안정적으로 호환되도록 돕습니다. 그러나 새로운 타입의 정확도를 최대한 유지하기 위해 AkWorldTransform 에서 AkTransform 으로, 그리고 AkVector64 에서 AkVector 로의 암묵적 변환 함수는 제공되지 않습니다. 따라서 이러한 타입을 사용하는 일부 코드에서는 지원하지 않는 변환으로 인해 컴파일 오류나 경고가 발생할 수 있으며, 적절한 조정이 필요할 수 있습니다. AK::ConvertAkVector64ToAkVector 나 AK::ConvertAkWorldTransformToAkTransform 같은 명시적 변환 함수를 사용할 수 있습니다.

Crankcase REV 2 런타임 업데이트

Crankcase REV 2 플러그인이 v2.68 런타임으로 업데이트되었습니다. 출력 신호는 ADPCM Decoder의 개선으로 인해 이전 버전과 약간 다릅니다.

SoundSeed Impact 삭제

Wwise SoundSeed Impact Effect 플러그인이 삭제되었습니다. Impacter 음원 플러그인으로 대체를 고려해볼 것을 권장합니다.

AAC Codec 삭제

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

AkArray 이동 정책

TMovePolicy::IsTrivial() 가 true일 때 AkArray::Insert 와 AkArray::Erase 가 이제 memmove를 사용합니다. 즉, 이 두 함수는 이제 일반적인 이동 정책(trivial move policy)이 아이템들을 단순하게 이동시킬 수 있다는 것으로 간주합니다. 이러한 가정은 이미 AkArray::GrowArray 경우에 이와 같이 간주되고 있습니다.

Plug-in API 변경 사항

AK::Wwise::Plugin::DataWriter::WriteString 함수가 더 이상 문자열 끝에 4 바이트를 추가하지 않습니다.

라우드니스 변경 사항

다음의 오디오 처리 알고리즘 변경 사항은 기존 프로젝트의 믹싱에 영향을 줄 수 있는 레벨 차이가 발생합니다.

Meter, Compressor 및 Expander

다채널 환경 설정의 Peak 및 RMS 계산(Ambisonic과 Audio Object 포함)이 변경되었습니다. 이에 따라 채널 환경 설정에서 특정 음원 신호에 대한 결과물의 일관성이 향상됐으며, Loudness Meter의 계산에 더 근접하게 되었습니다.

Balance-Fade Speaker Panning

Balance-Fade Speaker Panning 라우드니스가 Direct Assigment의 라우드니스와 일치하게 되었습니다. 즉, 두 개 이상의 채널이 있는 사운드의 음량이 더 커졌습니다. 이로 인해 Meter, Compressor 및 Expande에서 Speaker Panning이 있는 Audio Object의 평가된 라우드니스가 올바르게 수정됩니다.

AK Convolution

AK Convolution Effect 플러그인의 입력 신호를 다운믹싱할 때 실행되는 게인 조정이 변경되었습니다.