버전

menu_open
알림: 고객님의 주요 출시 버전( 2023.1.8.8601 )에 해당하는 최신 설명서로 이동했습니다. 특정 버전의 설명서를 보시려면 Audiokinetic 런처에서 오프라인 설명서를 다운로드하고 Wwise Authoring의 Offline Documentation을 확인하세요.
Wwise SDK 2023.1.8
AkSpatialAudio.h 파일 참조

이 파일의 소스 코드 페이지로 가기

클래스

struct  AkSpatialAudioInitSettings
 Initialization settings of the spatial audio module. 더 자세히 ...
 
struct  AkImageSourceSettings
 Settings for individual image sources. 더 자세히 ...
 
struct  AkVertex
 Vertex for a spatial audio mesh. 더 자세히 ...
 
struct  AkExtent
 
struct  AkTriangle
 Triangle for a spatial audio mesh. 더 자세히 ...
 
struct  AkAcousticSurface
 
struct  AkReflectionPathInfo
 Structure for retrieving information about the indirect paths of a sound that have been calculated via the geometric reflections API. Useful for debug draw applications. 더 자세히 ...
 
struct  AkDiffractionPathInfo
 
struct  AkPortalParams
 Parameters passed to SetPortal 더 자세히 ...
 
struct  AkRoomParams
 Parameters passed to SetRoom 더 자세히 ...
 
struct  AkGeometryParams
 Parameters passed to SetGeometry 더 자세히 ...
 
struct  AkGeometryInstanceParams
 Parameters passed to SetGeometryInstance 더 자세히 ...
 

네임스페이스

namespace  AK
 Audiokinetic namespace
 
 AK::SpatialAudio
 Audiokinetic spatial audio namespace
 

매크로

#define AK_DEFAULT_GEOMETRY_POSITION_X   (0.0)
 
#define AK_DEFAULT_GEOMETRY_POSITION_Y   (0.0)
 
#define AK_DEFAULT_GEOMETRY_POSITION_Z   (0.0)
 
#define AK_DEFAULT_GEOMETRY_FRONT_X   (0.0)
 
#define AK_DEFAULT_GEOMETRY_FRONT_Y   (0.0)
 
#define AK_DEFAULT_GEOMETRY_FRONT_Z   (1.0)
 
#define AK_DEFAULT_GEOMETRY_TOP_X   (0.0)
 
#define AK_DEFAULT_GEOMETRY_TOP_Y   (1.0)
 
#define AK_DEFAULT_GEOMETRY_TOP_Z   (0.0)
 

함수

Basic functions.

In order to use SpatialAudio, you need to initalize it using Init, and register the listeners that you plan on using with any of the services offered by SpatialAudio, using RegisterListener respectively, after having registered their corresponding game object to the sound engine.

주의: At the moment, there can be only one Spatial Audio listener registered at any given time.
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::Init (const AkSpatialAudioInitSettings &in_initSettings)
 Initialize the SpatialAudio API.
더 자세히 ...
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::RegisterListener (AkGameObjectID in_gameObjectID)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::UnregisterListener (AkGameObjectID in_gameObjectID)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::SetGameObjectRadius (AkGameObjectID in_gameObjectID, AkReal32 in_outerRadius, AkReal32 in_innerRadius)
 
Helper functions for passing game data to the Reflect plug-in.

Use this API for detailed placement of reflection image sources.

참고: These functions are low-level and useful when your game engine already implements a geometrical approach to sound propagation such as an image-source or a ray tracing algorithm. Functions of Geometry are preferred and easier to use with the Reflect plug-in.
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::SetImageSource (AkImageSourceID in_srcID, const AkImageSourceSettings &in_info, const char *in_name, AkUniqueID in_AuxBusID=AK_INVALID_AUX_ID, AkGameObjectID in_gameObjectID=AK_INVALID_GAME_OBJECT)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::RemoveImageSource (AkImageSourceID in_srcID, AkUniqueID in_AuxBusID=AK_INVALID_AUX_ID, AkGameObjectID in_gameObjectID=AK_INVALID_GAME_OBJECT)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::ClearImageSources (AkUniqueID in_AuxBusID=AK_INVALID_AUX_ID, AkGameObjectID in_gameObjectID=AK_INVALID_GAME_OBJECT)
 
Geometry

Geometry API for early reflection processing using Reflect.

AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::SetGeometry (AkGeometrySetID in_GeomSetID, const AkGeometryParams &in_params)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::RemoveGeometry (AkGeometrySetID in_SetID)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::SetGeometryInstance (AkGeometryInstanceID in_GeometryInstanceID, const AkGeometryInstanceParams &in_params)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::RemoveGeometryInstance (AkGeometryInstanceID in_GeometryInstanceID)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::QueryReflectionPaths (AkGameObjectID in_gameObjectID, AkUInt32 in_positionIndex, AkVector64 &out_listenerPos, AkVector64 &out_emitterPos, AkReflectionPathInfo *out_aPaths, AkUInt32 &io_uArraySize)
 
Rooms and Portals

Sound Propagation API using rooms and portals.

AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::SetRoom (AkRoomID in_RoomID, const AkRoomParams &in_Params, const char *in_RoomName=nullptr)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::RemoveRoom (AkRoomID in_RoomID)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::SetPortal (AkPortalID in_PortalID, const AkPortalParams &in_Params, const char *in_PortalName=nullptr)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::RemovePortal (AkPortalID in_PortalID)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::SetReverbZone (AkRoomID in_ReverbZone, AkRoomID in_ParentRoom, AkReal32 in_transitionRegionWidth)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::RemoveReverbZone (AkRoomID in_ReverbZone)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::SetGameObjectInRoom (AkGameObjectID in_gameObjectID, AkRoomID in_CurrentRoomID)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::UnsetGameObjectInRoom (AkGameObjectID in_gameObjectID)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::SetReflectionsOrder (AkUInt32 in_uReflectionsOrder, bool in_bUpdatePaths)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::SetDiffractionOrder (AkUInt32 in_uDiffractionOrder, bool in_bUpdatePaths)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::SetMaxEmitterRoomAuxSends (AkUInt32 in_uMaxEmitterRoomAuxSends)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::SetNumberOfPrimaryRays (AkUInt32 in_uNbPrimaryRays)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::SetLoadBalancingSpread (AkUInt32 in_uNbFrames)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::SetEarlyReflectionsAuxSend (AkGameObjectID in_gameObjectID, AkAuxBusID in_auxBusID)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::SetEarlyReflectionsVolume (AkGameObjectID in_gameObjectID, AkReal32 in_fSendVolume)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::SetPortalObstructionAndOcclusion (AkPortalID in_PortalID, AkReal32 in_fObstruction, AkReal32 in_fOcclusion)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::SetGameObjectToPortalObstruction (AkGameObjectID in_gameObjectID, AkPortalID in_PortalID, AkReal32 in_fObstruction)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::SetPortalToPortalObstruction (AkPortalID in_PortalID0, AkPortalID in_PortalID1, AkReal32 in_fObstruction)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::QueryWetDiffraction (AkPortalID in_portal, AkReal32 &out_wetDiffraction)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::QueryDiffractionPaths (AkGameObjectID in_gameObjectID, AkUInt32 in_positionIndex, AkVector64 &out_listenerPos, AkVector64 &out_emitterPos, AkDiffractionPathInfo *out_aPaths, AkUInt32 &io_uArraySize)
 
AKSOUNDENGINE_API AKRESULT AK::SpatialAudio::ResetStochasticEngine ()
 

상세한 설명

Spatial Audio interface.

AkSpatialAudio.h 파일에서 정의되었습니다.


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

지원이 필요하신가요?

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

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

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

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

Wwise를 시작해 보세요