版本
menu

Wwise SDK 2025.1.0
AkSpeakerVolumeMatrixCallbackInfo结构体 参考

#include <AkCallbackTypes.h>

Public 属性

AkSpeakerVolumesMatrixPtr pVolumes
 Pointer to volume matrix describing the contribution of each source channel to destination channels. Use methods of AK::SpeakerVolumes::Matrix to interpret them. 更多...
 
struct AkChannelConfig inputConfig
 Channel configuration of the voice/bus. 更多...
 
struct AkChannelConfig outputConfig
 Channel configuration of the output bus. 更多...
 
AkReal32pfBaseVolume
 Base volume, common to all channels. 更多...
 
AkReal32pfEmitterListenerVolume
 Emitter-listener pair-specific gain. When there are multiple emitter-listener pairs, this volume is set to that of the loudest pair, and the relative gain of other pairs is applied directly on the channel volume matrix pVolumes. 更多...
 
AkGameObjectID mixConnectionGameObjId
 Game Object ID of the mix connection 更多...
 
AkMixerInputContextPtr pContext
 Context of the current voice/bus about to be mixed into the output bus with specified base volume and volume matrix. 更多...
 
AkMixerPluginContextPtr pMixerContext
 Output mixing bus context. Use it to access a few useful panning and mixing services, as well as the ID of the output bus. NULL if pContext is the Main Audio Bus. 更多...
 

详细描述

Callback information structure corresponding to AK_SpeakerVolumeMatrix, and passed to callbacks registered in RegisterBusVolumeCallback() or PostEvent() with AK_SpeakerVolumeMatrix. These callbacks are called at every audio frame for every connection from an input (voice or bus) to an output bus (standard or auxiliary), at the point when an input signal is about to be mixed into a mixing bus, but just before having been scaled in accordance to volumes authored in Wwise. The volumes are passed via this structure as pointers because they can be modified in the callbacks. They are factored into two linear values ([0..1]): a common base value (pfBaseVolume), that is channel-agnostic and represents the collapsed gain of all volume changes in Wwise (sliders, actions, RTPC, attenuations, ...), and a matrix of gains per input/output channel, which depends on spatialization. Use the methods of AK_SpeakerVolumes_Matrix, defined in AK/SoundEngine/Common/AkSpeakerVolumes.h, to perform operations on them. Access each input channel of the volumes matrix with AK_SpeakerVolumes_Matrix_GetChannel(), passing it the input and output channel configuration. Then, you may access each element of the output vector using the standard bracket [] operator. See AK/SoundEngine/Common/AkSpeakerVolumes.h for more details. It is crucial that the processing done in the callback be lightweight and non-blocking.

参见

在文件 AkCallbackTypes.h226 行定义.


此页面对您是否有帮助?

需要技术支持?

仍有疑问?或者问题?需要更多信息?欢迎联系我们,我们可以提供帮助!

查看我们的“技术支持”页面

介绍一下自己的项目。我们会竭力为您提供帮助。

来注册自己的项目,我们帮您快速入门,不带任何附加条件!

开始 Wwise 之旅