Wwise SDK 2024.1.4

RTPC는 AK::SoundEngine::SetRTPCValue() 함수를 사용해서 갱신할 수 있는 실시간 매개 변수입니다. Event Action은 매개 변수를 수정할 수 없기 때문에 RTPC 값을 설정하는 것은 본인의 책임입니다.

RTPC 값

RTPC 값은 항상 32-비트 실수 값으로 나타나는 AkRtpcValue로 전달됩니다. 이 값은 사운드 디자이너가 Wwise에서 미리 정의한 RTPC 곡선을 직접 보간하는데 사용됩니다.

매개 변수가 Wwise에 정의된 곡선 너머에 있으면, 곡선에 있는 극단값이 사용됩니다. 매개 변수가 최대 값을 초과하면 곡선의 가장 오른쪽 값이 사용되며, 매개 변수가 최소값 이하가 되면 곡선의 가장 왼쪽 값이 사용됩니다. RTPC를 Boolean 값으로 나타나면, 1은 True를 0은 False를 나타냅니다.

RTPC 값의 설정

RTCP 값은 다음과 같이 설정됩니다.

AKRESULT AK::SoundEngine::SetRTPCValue( 
    AkRtpcID        in_rtpcID,                                      // RTPC의 ID
    AkRtpcValue     in_value,                                       // 설정할 값
    AkGameObjectID  in_gameObjectID = AK_INVALID_GAME_OBJECT        // 연관된 게임 오브젝트 ID
);

또는

AKRESULT AK::SoundEngine::SetRTPCValue( 
    const char *    in_pszRtpcName,                                 // RTPC의 이름
    AkRtpcValue     in_value,                                       // 설정할 값
    AkGameObjectID  in_gameObjectID = AK_INVALID_GAME_OBJECT        // 연관된 게임 오브젝트 ID
);

또는

AKRESULT AK::SoundEngine::SetRTPCValue( 
    const wchar_t * in_pszRtpcName,                                 // RTPC의 이름
    AkRtpcValue     in_value,                                       // 설정할 값
    AkGameObjectID  in_gameObjectID = AK_INVALID_GAME_OBJECT        // 연관된 게임 오브젝트 ID
);

RTPC 값은 게임 오브젝트 및 버스(bus) 매개 변수, 소스 플러그인, 효과 플러그인으로 사운드 재생에 영향을 줄 수 있습니다. 이러한 가능성에 대해서 전부 다 고려하게 됩니다.

ID 사용 활성화

ID로 동작하려면 뱅크는 반드시 Wwise의 Generate SoundBanks 대화상자에서 "Generate header file" 옵션으로 생성되어야 합니다. Wwise_IDs.h라는 이름의 정의 파일은 필요한 모든 ID를 포함합니다. 이 파일은 각각의 뱅크가 생성될 때마다 갱신됩니다.

RTPC와 게임 오브젝트

RTPC는 Sound SFX나 Sound Voice 또는 컨테이너, 액터-믹서 오브젝트에 영향을 줘서 게임 오브젝트의 행동을 수정할 때 사용할 수 있습니다. 스위치도 RTPC를 사용해 수정할 수 있습니다. ( 스위치 다루기 를 참고)

할당되지 않은 게임 오브젝트 전부에 대해 한 번의 함수 호출로 전역 RTPC 값을 설정할 수 있습니다. 이를 처리하려면 게임 오브젝트 ID로 AK_INVALID_GAME_OBJECT를 사용하거나 AkGameObjectID 매개 변수의 지정 없이 AK::SoundEngine::SetRTPCValue() 메소드를 호출합니다. 그러나 사운드 오브젝트가 유효한 AkRtpcID와 AkGameObjectID 입력을 사용해 해당 메소드를 호출하면, 게임 오브젝트가 할당되어 더는 전역 RTPC 값에 영향을 받지 않게 됩니다.

RTPC와 버스

Wwise에서 일부 버스 매개 변수는 RTPC에 의해 수정될 수 있습니다. 일반적으로 버스 매개변수에서 RTPC를 사용하는 대부분 경우에는 RTPC와 게임 오브젝트 에서 설명한 것과 같이 AK_INVALID_GAME_OBJECT 매개변수를 사용하여 AK::SoundEngine::SetRTPCValue() 메서드를 호출해야 합니다. 이렇게 하면 모든 버스에 해당 RTPC 값이 부여됩니다.

하지만 프로젝트에서 버스에 3D 위치 지정하기를 사용하는 경우 각 버스에 특정 값을 지정하려는 경우가 있습니다. 이 경우, AK::SoundEngine::SetRTPCValue() 함수에 버스에 연결된 Game Object/Listener를 제공합니다.

RTPC와 플러그인

Wwise에서 RTPC는 리버브 레벨이나 피치(pitch) 또는 로우 패스 컷-오프 주파수(low pass cut-off frequencies)처럼 사운드 효과와 소스 플러그인의 속성에 영향을 줄 수 있습니다. 플러그인을 사용해 버스의 이러한 속성에 RTPC 값이 올바르게 적용되도록 하려면 위의 RTPC와 버스 에서 설명한 것과 동일한 경우가 적용됩니다.

플러그인이 Actor-Mixer 또는 Interactive-Music 오브젝트나 프로젝트에서 사용되는 경우 항상 Game Object에서 재생됩니다. 대부분의 경우 AK::SoundEngine::SetRTPCValue() 메서드는 유효한 AkGameObjectID 값으로 작성되어야 합니다. AK_INVALID_GAME_OBJECT를 사용해 직접 지정된 기본값이 없는 모든 Game Object에 대해 전역 기본값만 설정하는 것은 여전히 가능합니다.

info

참고: 전역 RTPC 값의 설정과 게임 오브젝트 마다 RTPC 값의 설정에 대한 차이점에 대해서 아는 것이 중요합니다. 스위치 컨테이너처럼 Wwise 오브젝트의 사운드 재생이 RTPC에 의해 영향을 받으면, 유효한 AkGameObjectID 값과 함께 AK::SoundEngine::SetRTPCValue() 메소드를 호출하는 것이 중요합니다. 재생 중에 게임 오브젝트에 특화된 값이 설정된 게 없다면, 사운드 엔진은 AK_INVALID_GAME_OBJECT 매개 변수 또는 특정 게임 오브젝트의 설정 없이 AK::SoundEngine::SetRTPCValue() 호출에 의해 설정된 전역 RTPC 값을 찾게 됩니다. 만약 전역 값이 존재하지 않으면, 사운드 엔진은 Wwise 저작 애플리케이션에서 지정한 게임 매개 변수의 기본 값을 사용하게 됩니다.

warning

경고: 여러 사운드나 버스, 효과에 같은 RTPC를 사용하는 것이 가능하다는 점에 유의하세요. 이는 예상치 못한 결과를 가져올 수 있기 때문에 게임 오브젝트나 버스, 효과에 대해 서로 다른 RTPC를 사용하는 걸 추천합니다. 예를 들어, 자동차 경주 게임에서 10개의 자동차에 대한 엔진의 기본 RPM 값을 설정할 것입니다. 동시에 자동차의 엔진 사운드를 재생하는 버스에 로우 패스 필터가 적용될 수 있습니다. 이와 같은 권장 사항을 따르면 로우 패스 필터 효과의 원음을 식별하기가 쉬워집니다.

RTPC 통합에 대한 예제는 RTPC 예제 를 참고하세요.

AK::SoundEngine::SetRTPCValue

AKSOUNDENGINE_API AKRESULT SetRTPCValue(AkRtpcID in_rtpcID, AkRtpcValue in_value, AkGameObjectID in_gameObjectID=AK_INVALID_GAME_OBJECT, AkTimeMs in_uValueChangeDuration=0, AkCurveInterpolation in_eFadeCurve=AkCurveInterpolation_Linear, bool in_bBypassInternalValueInterpolation=false)

AkRtpcID

AkUInt32 AkRtpcID

Real time parameter control ID

Definition: AkTypes.h:73

AkGameObjectID

AkUInt64 AkGameObjectID

Game object ID

Definition: AkTypes.h:60

AKRESULT

Standard function call result.

Definition: AkTypes.h:134

AK_INVALID_GAME_OBJECT