버전
menu_open
Wwise SDK 2023.1.2
오디오 입력 음원 플러그인

플러그인 설명

이 플러그인을 이용해 사운드 디자이너가 네트워크 스트림, 또는 PC나 콘솔에 연결된 마이크 같은 외부 음원 오디오를 사용할 수 있습니다.

플러그인 통합하기

일반적인 플러그인의 초기화와는 별개로 ( 통합 세부사항 - 플러그인 참조) Audio Input 플러그인을 통합할 때는, Wwise 프로젝트 플러그인의 다양한 인스턴스가 사용하는 입력 오디오 데이터를 게임에서 제공해줘야 합니다. 콜백 기능을 통해 이뤄지며, AkAudioInputSourceFactory.h 로 나타냅니다.

  • At first, the game calls SetAudioInputCallbacks() to set the mandatory AkAudioInputPluginExecuteCallbackFunc which will be called whenever an instance of audio input requires more audio data.
    • If the audio data is not a mono stream of 32-bit floating point values, the AkAudioInputPluginGetFormatCallbackFunc must be set. This callback only accepts audio data in the following formats, where the left and right channels are stored as shown for a 16-frame buffer:

      • interleaved 16-bit integer (also known as planar)
      • non-interleaved 32-bit floating point

      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 can be set with the help of one of the calls mentioned below: AkChannelConfig.SetAnonymous(...), AkChannelConfig.SetStandard(...) or AkChannelConfig.SetAmbisonic(...)

      ChannelMask: There are no restrictions on channelmask. Standard and custom channelmasks are supported.

      Interleaved format (AK_INTERLEAVED) only supports AK_INT, and non-interleaved format (AK_NONINTERLEAVED) only supports AK_FLOAT.

AkAudioFormat audioFormat;
AkChannelConfig audioChConfig;
audioChConfig.SetStandard(0);
audioFormat.SetAll(
48000, // Sample rate
audioChConfig, // \ref AkChannelConfig
16, // Bits per samples
2, // 2 bytes per samples
AK_INT, // feeding integers(signed)
);
  • Next, the game calls PostEvent to start the audio input plug-in.
  • The Sound Engine will call AkAudioInputPluginGetFormatCallbackFunc once at the beginning of playback and then AkAudioInputPluginExecuteCallbackFunc at each audio frame until the plug-in finishes execution (either through a stop action or the execute callback setting AK_NoMoreData on io_pBufferOut->eState).

    Microphone/AudioInput Demo 을 보시면 오디오 입력으로 마이크를 사용한 간단한 통합 예제가에 있습니다. Integration Demo Wwise Project에 Microphone 이라는 이름의 Sound Voice는 음원으로 Audio Input 플러그인을 사용합니다.

참고: Wwise에서 오디오 입력 플러그인은 PC 마이크 입력에서 오는 음원을 사용합니다. 마이크가 연결돼있지 않은 경우, 무음이 됩니다.
AkForceInline void SetStandard(AkUInt32 in_uChannelMask)
Set channel config as a standard configuration specified with given channel mask.
const AkDataTypeID AK_INT
Integer data type (uchar, short, and so on)
Definition: AkCommonDefs.h:50
Defines the parameters of an audio buffer format.
Definition: AkCommonDefs.h:63
const AkDataInterleaveID AK_INTERLEAVED
Interleaved data
Definition: AkCommonDefs.h:53
void SetAll(AkUInt32 in_uSampleRate, AkChannelConfig in_channelConfig, AkUInt32 in_uBitsPerSample, AkUInt32 in_uBlockAlign, AkUInt32 in_uTypeID, AkUInt32 in_uInterleaveID)
Definition: AkCommonDefs.h:126

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

지원이 필요하신가요?

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

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

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

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

Wwise를 시작해 보세요