오디오 스페이셜라이저 SDK

Unity 오디오 스페이셜라이저 SDK 및 예제 구현

Unity 오디오 스페이셜라이저 초기화

definition.flags |= UnityAudioEffectDefinitionFlags_IsSpatializer;

UnityAudioEffectDefinitionFlags_IsSpatializer

UnityAudioEffectState

spatializerdata

UnityAudioSpatializerData

AudioSource.spatialize

definition.flags |= UnityAudioEffectDefinitionFlags_NeedsSpatializerData;

UnityAudioEffectDefinitionFlags_NeedsSpatializerData

UnityAudioSpatializerData

listenermatrix

definition.flags |= UnityAudioEffectDefinitionFlags_AppliesDistanceAttenuation;

UnityAudioEffectDefinitionFlags_AppliesDistanceAttenuation

스페이셜라이저 효과 메타데이터

UnityAudioSpatializerData

struct UnityAudioSpatializerData{    float listenermatrix[16];   // Matrix that transforms sourcepos into the local space of the listener    float sourcematrix[16];     // Transform matrix of the Audio Source    float spatialblend;         // Distance-controlled spatial blend    float reverbzonemix;        // Reverb zone mix level parameter (and curve) on                                 // the Audio Source    float spread;               // Spread parameter of the Audio Source (0..360 degrees)    float stereopan;            // Stereo panning parameter of the Audio Source (-1: fully left, 1: fully right)                                // The spatializer plugin may override the distance attenuation to                                // influence the voice prioritization (leave this callback as NULL                                 // to use the built-in Audio Source attenuation curve)    UnityAudioEffect_DistanceAttenuationCallback distanceattenuationcallback;    float minDistance;          // The minimum distance of the Audio Source.                                 // This value may be useful for determining when to apply near-field effects.     float maxDistance;          // The maximum distance of the Audio Source, or the                                 // distance where the audio becomes inaudible to the listener.     };

UnityAudioSpatializerData

매트릭스 규칙

sourcematrix

listenermatrix

listenermatrix

sourcematrix

float dir_x = L[0] * S[12] + L[4] * S[13] + L[ 8] * S[14] + L[12];float dir_y = L[1] * S[12] + L[5] * S[13] + L[ 9] * S[14] + L[13];float dir_z = L[2] * S[12] + L[6] * S[13] + L[10] * S[14] + L[14];

float listenerpos_x = -(L[0] * L[12] + L[ 1] * L[13] + L[ 2] * L[14]);float listenerpos_y = -(L[4] * L[12] + L[ 5] * L[13] + L[ 6] * L[14]);float listenerpos_z = -(L[8] * L[12] + L[ 9] * L[13] + L[10] * L[14]);

감쇠 곡선 및 가청도

UnityAudioEffectDefinitionFlags_AppliesDistanceAttenuation

UnityAudioSpatializerData

typedef UNITY_AUDIODSP_RESULT (UNITY_AUDIODSP_CALLBACK* UnityAudioEffect_DistanceAttenuationCallback)(    UnityAudioEffectState* state,    float distanceIn,    float attenuationIn,    float* attenuationOut);

UNITY_AUDIODSP_RESULT UNITY_AUDIODSP_CALLBACK SimpleLogAttenuation(    UnityAudioEffectState* state,    float distanceIn,    float attenuationIn,    float* attenuationOut){    const float rollOffScale = 1.0f; // Similar to the one in the Audio Project Settings	*attenuationOut = 1.0f / max(1.0f, rollOffScale * distanceIn);	return UNITY_AUDIODSP_OK;}

Unity API에서 C# 스크립트 사용

SetSpatializerFloat

GetSpatializerFloat

SetFloatParameter

GetFloatParameter

SetSpatializerFloat

GetSpatializerFloat

SetFloatParameter

GetFloatParameter

AudioSource.spatializer

플러그인 예제의 알려진 한계