|
Wwise SDK 2024.1.1
|
关于此插件
此插件可让声音设计师使用来自外部源（例如网络流媒体或连接到 PC 或游戏机的话筒）的音频。
集成插件
除正常的插件初始化（请参见 集成详情——插件 ），集成音频输入插件需要游戏提供 Wwise 工程中各种插件所使用的输入音频数据。这通过 AkAudioInputSourceFactory.h 中暴露的回调机制来执行：
- 首先，游戏调用 SetAudioInputCallbacks() 来设置必需的 AkAudioInputPluginExecuteCallbackFunc ，每当音频输入端需要更多音频数据时都会调用此函数。
若音频数据不是 32 位浮点值的单声道播放流，则须设置 AkAudioInputPluginGetFormatCallbackFunc 。此回调仅接受以下格式的音频数据（16 帧缓冲区按如下所示存储左右声道）：
- 交错式 16 位整数（也叫 2D 整数）
- 非交错式 32 位浮点数
AkAudioInputPluginGetFormatCallbackFunc uses AkAudioFormat which can be populated as shown in the example below. AkAudioFormat consists of audio data format specifications and channel configuration AkChannelConfig.
AkChannelConfig 可通过以下所述调用进行设置： AkChannelConfig.SetAnonymous(...)、AkChannelConfig.SetStandard(...) 或 AkChannelConfig.SetAmbisonic(...)
ChannelMask：对 channelmask 没有限制。支持标准和自定义 channelmask。
Interleaved format (
AK_INTERLEAVED) only supportsAK_INT, and non-interleaved format (AK_NONINTERLEAVED) only supportsAK_FLOAT.- 交错式 16 位整数（也叫 2D 整数）
- 然后游戏用 PostEvent 启动音频输入插件。
- 一旦开始播放，声音引擎将调用 AkAudioInputPluginGetFormatCallbackFunc ，然后在每个音频帧调用 AkAudioInputPluginExecuteCallbackFunc ，直至插件完成执行（通过停止操作或对 io_pBufferOut->eState 执行回调设置 AK_NoMoreData ）。
Microphone/AudioInput Demo 演示中演示了一个非常简单的集成操作，它使用话筒作为输入设备。在 Integration Demo Wwise 工程中，被命名为 Microphone 的 Sound Voice（语音）使用音频输入插件作为来源。
 | 备注: 在 Wwise 中，音频输入插件收到来自 PC 话筒输入的音频。如果没有连接话筒，则不会出声。 |