Wwise SDK 2022.1.18

Introduction

The Spatial Audio module exposes a number of services related to spatial audio, notably to do the following:

compute image sources for Reflect for a given geometry
model sound propagation from Rooms and Portals by controlling 3D busses
model sound propagation across geometry
access the raw API of Reflect

Internally, Spatial Audio does the following:

controls 3D busses by managing game objects and their properties (positions, auxiliary sends, obstruction, and occlusion)
controls (multi-) positions and aux sends of Spatial Audio game objects
runs geometric sound reflection, diffraction and transmission algorithms
packages data for Reflect

It is an SDK component that works with the Wwise sound engine, as shown in the following flowchart.

Spatial Audio 서비스

Spatial Audio exposes three categories of service, described in separate sections:

Rooms and Portals are a simple, high-level geometry abstraction used to model propagation of sound emitters located in other rooms. 지오메트리 uses triangles to compute image sources to simulate dynamic early reflections with Reflect, or to compute geometric diffraction. Spatial Audio also exposes helper functions to access the raw Reflect API directly (Using Raw Image Sources).

API Setup

Spatial Audio의 함수와 정의는 SDK/include/AK/SpatialAudio/Common/에서 확인하실 수 있습니다. Its main functions are exposed in the AK::SpatialAudio namespace.

초기화

Initialize Spatial Audio with AK::SpatialAudio::Init().

When using Spatial Audio, a single game object must be explicitly assigned as the Spatial Audio Listener. To do so, call AK::SpatialAudio::RegisterListener(), and pass the ID of the desired listener. 해당 게임 오브젝트는 사운드 엔진 내에서 리스너로 등록되거나 할당돼야 합니다. 사운드 엔진 내 Listener에 대한 더 자세한 정보는 리스너 통합하기 를 참고하세요.

dangerous

주의: Spatial Audio only supports one top-level listener.

Spatial Audio Emitter

A game object becomes a Spatial Audio Emitter when it plays a sound that has one or more settings related to Spatial Audio enabled in Wwise Authoring:

To enable room reverberation, enable game-defined auxiliary sends on the sound's General Settings tab.
To enable reflection processing, assign an early reflection bus to the sound in one of the following ways:
- On the sound's General Settings tab, assign the appropriate Auxiliary Bus.
- Use AK::SpatialAudio::SetEarlyReflectionsAuxSend to assign the bus to the Game Object.
To enable diffraction and transmission processing, select Enable Diffraction and Transmission on the sound's Positioning tab.

The position of a game object, either an emitter or a listener, is passed to the sound engine with AK::SoundEngine::SetPosition. Spatial Audio retrieves the position information directly from the sound engine to determine the source position for reflection and diffraction processing.

종료 처리

Spatial Audio는, Wwise 사운드 엔진이 종료될 때 자동으로 종료됩니다.

참고

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

지원이 필요하신가요?

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

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

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

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

Wwise를 시작해 보세요

Wwise SDK

Spatial Audio (공간 음향)