menu
版本
2024.1.5.8803
2024.1.5.8803
2023.1.13.8732
2022.1.19.8584
2021.1.14.8108
2019.2.15.7667
2019.1.11.7296
2018.1.11.6987
2017.2.10.6745
2017.1.9.6501
2016.2.6.6153
2015.1.9.5624
menu
|
Wwise SDK 2024.1.5
|
音频输入源插件
关于此插件
此插件可让声音设计师使用来自外部源（例如网络流媒体或连接到 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 整数）
AkAudioFormat audioFormat;
AkChannelConfig audioChConfig;
audioChConfig.SetStandard(0);
audioFormat.SetAll(
48000, // 采样率
audioChConfig, // \ref AkChannelConfig
16, // 位/样本
2, // 2 字节/样本
AK_INT, // 馈送整数（有符号）
);
- 然后游戏用 PostEvent 启动音频输入插件。
- 一旦开始播放，声音引擎将调用 AkAudioInputPluginGetFormatCallbackFunc ，然后在每个音频帧调用 AkAudioInputPluginExecuteCallbackFunc ，直至插件完成执行（通过停止操作或对 io_pBufferOut->eState 执行回调设置 AK_NoMoreData ）。
Microphone/AudioInput Demo 演示中演示了一个非常简单的集成操作，它使用话筒作为输入设备。在 Integration Demo Wwise 工程中，被命名为 Microphone 的 Sound Voice（语音）使用音频输入插件作为来源。
Definition: AkSpeakerConfig.h:444
AkForceInline void SetStandard(AkUInt32 in_uChannelMask)
Set channel config as a standard configuration specified with given channel mask.
Definition: AkSpeakerConfig.h:511
void SetAll(AkUInt32 in_uSampleRate, AkChannelConfig in_channelConfig, AkUInt32 in_uBitsPerSample, AkUInt32 in_uBlockAlign, AkUInt32 in_uTypeID, AkUInt32 in_uInterleaveID)
Definition: AkCommonDefs.h:123