<p>FMOD For Unreal adds a number of configuration options to the <strong>Project Settings</strong> editor.</p>
<p>Access the settings by opening the <strong>Project Settings</strong> editor from the <strong>Edit</strong> menu, then navigate to the FMOD Studio plugin settings:<br/>
<p>All of the settings are stored in the default engine configuration file and can be manually edited there if desired.</p>
</div>
<h2id="basic"><ahref="#basic">3.1 Basic</a></h2>
<h3id="load-all-banks"><ahref="#load-all-banks">3.1.1 Load All Banks</a></h3>
<p>When enabled the metadata from all FMOD bank files is loaded at startup.</p>
<pre><code>Default: Enabled
</code></pre>
<h3id="load-all-sample-data"><ahref="#load-all-sample-data">3.1.2 Load All Sample Data</a></h3>
<p>When enabled the sample data from all FMOD bank files is loaded at startup. Only effective when <aclass="apilink"href="#load-all-banks">Load All Banks</a> is also enabled.</p>
<pre><code>Default: Disabled
</code></pre>
<h3id="enable-live-update"><ahref="#enable-live-update">3.1.3 Enable Live Update</a></h3>
<p>When enabled FMOD Studio Live Update can connect to non-final builds of the game while running.</p>
<pre><code>Default: Enabled
</code></pre>
<h3id="enable-editor-live-update"><ahref="#enable-editor-live-update">3.1.4 Enable Editor Live Update</a></h3>
<p>When enabled FMOD Studio Live Update can connect to the editor.</p>
<pre><code>Default: Disabled
</code></pre>
<h3id="bank-output-directory"><ahref="#bank-output-directory">3.1.5 Bank Output Directory</a></h3>
<p>Path to the FMOD Studio built banks output directory, relative to the project's Content directory. See <ahref="user-guide.html#studio-bank-output-directory">Studio Bank Output Directory</a> in the user guide for more information.</p>
<p>List of project locales. This should match the locales configured for the FMOD Studio project. See <ahref="user-guide.html#localization">Localization</a> in the user guide for more information.</p>
<p>Each entry in the list has three members:</p>
<ol>
<li>Locale Name: This is the name of the locale displayed in the UI (e.g. in Blueprints).</li>
<li>Locale Code: This must match the locale code used for the corresponding locale in the FMOD Studio project.</li>
<li>Default: Make this locale active at startup. Only one locale should be marked as default.</li>
</ol>
<p>When loading banks, banks which correspond to the active locale are loaded while banks which correspond to any other recognized locale are skipped.</p>
<p>Sets the signal level at which <ahref="https://fmod.com/docs/2.02/api/core-api-channel.html">Channel</a>s are virtualized. This corresponds directly to the <code>vol0virtual</code> member of <ahref="https://fmod.com/docs/2.02/api/core-api-system.html#fmod_advancedsettings"><code>FMOD_ADVANCED_SETTINGS</code></a> in the Core API.</p>
<p>The sample rate for the FMOD mixer. This corresponds to the <code>samplerate</code> parameter of <ahref="https://fmod.com/docs/2.02/api/core-api-system.html#system_setsoftwareformat"><code>FMOD::System::setSoftwareFormat</code></a> in the Core API.</p>
<pre><code>Default: 0 (uses the default sample rate for the platform)
<p>The maximum number of active <ahref="https://fmod.com/docs/2.02/api/core-api-channel.html">Channel</a>s. This corresponds to the <code>numsoftwarechannels</code> parameter of <ahref="https://fmod.com/docs/2.02/api/core-api-system.html#system_setsoftwarechannels"><code>FMOD::System::setSoftwareChannels</code></a> in the Core API.</p>
<p>The maximum number of <ahref="https://fmod.com/docs/2.02/api/core-api-channel.html">Channel</a>s to be used in FMOD. This corresponds to the <code>maxchannels</code> parameter of <ahref="https://fmod.com/docs/2.02/api/studio-api-system.html#studio_system_initialize"><code>FMOD::Studio::System::initialize</code></a> in the Studio API.</p>
<p>The mixer block length for the FMOD mixer. This corresponds to the <code>bufferlength</code> parameter of <ahref="https://fmod.com/docs/2.02/api/core-api-system.html#system_setdspbuffersize"><code>FMOD::System::setDSPBufferSize</code></a> in the Core API.</p>
<pre><code>Units: samples
Default: 0 (uses the default DSP buffer length for the platform)
<p>The number of mixer blocks for the FMOD mixer to use. This corresponds to the <code>numbuffers</code> parameter of <ahref="https://fmod.com/docs/2.02/api/core-api-system.html#system_setdspbuffersize"><code>FMOD::System::setDSPBufferSize</code></a> in the Core API.</p>
<pre><code>Default: 0 (uses the default DSP buffer count for the platform)
<p>File buffering chunk size. This corresponds to the <code>blockalign</code> parameter of <ahref="https://fmod.com/docs/2.02/api/core-api-system.html#system_setfilesystem"><code>FMOD::System::setFileSystem</code></a> in the Core API.</p>
<p>Update period of FMOD Studio. This corresponds to the <code>studioupdateperiod</code> member of <ahref="https://fmod.com/docs/2.02/api/studio-api-system.html#fmod_studio_advancedsettings"><code>FMOD_STUDIO_ADVANCEDSETTINGS</code></a> in the Studio API.</p>
<pre><code>Units: milliseconds
Default: 0 (uses the default update period for FMOD Studio)
<p>Name of output driver to choose at start up. If this is not empty the available output drivers are enumerated at start up and if a driver with a matching name is found then that driver is selected for output.</p>
<pre><code>Default: Empty (uses the default output driver)
<p>When enabled all buses in the global mixer are locked when the master bank is loaded. This ensures that all buses in the global mixer are created.</p>
<p>Size of memory pool to use on each platform. When this is set to a value other than zero a memory pool of the requested size is allocated using the Unreal memory system and all FMOD memory allocations are made from the pool. Otherwise FMOD memory allocations directly use the Unreal memory system.</p>
<p>Delay before automatically reloading modified banks from disk. This can be extended if building banks takes a long time and Unreal tries to reload banks before building is completed. Set to 0 to disable automatic bank reloading.</p>
<pre><code>Units: seconds
Default: 5
</code></pre>
<h3id="enable-api-error-logging"><ahref="#enable-api-error-logging">3.4.4 Enable API Error Logging</a></h3>
<p>Enables FMOD's detailed memory tracking for non-final builds. This corresponds to setting the <ahref="https://fmod.com/docs/2.02/api/studio-api-system.html#fmod_studio_initflags"><code>FMOD_STUDIO_INIT_MEMORY_TRACKING</code></a> flag into the <code>studioflags</code> when initializing the Studio API.</p>
<h3id="master-bank-name"><ahref="#master-bank-name">3.4.9 Master Bank Name</a></h3>
<p>Name of master bank (without extension). Must match the FMOD Studio project.</p>
<pre><code>Default: Master
</code></pre>
<h3id="skip-load-bank-name"><ahref="#skip-load-bank-name">3.4.10 Skip Load Bank Name</a></h3>
<p>String to filter banks loaded when <aclass="apilink"href="#load-all-banks">Load All Banks</a> is enabled. If Skip Load Bank Name is not empty then any bank with a name containing the specified string will be skipped by automatic bank loading.</p>
<p>Key for loading encrypted banks. This corresponds to the <code>encryptionkey</code> member of <ahref="https://fmod.com/docs/2.02/api/studio-api-system.html#fmod_studio_advancedsettings"><code>FMOD_STUDIO_ADVANCEDSETTINGS</code></a> in the Studio API.</p>
<p>File name that the wav writer will output to. If this is not empty then the runtime FMOD Studio system will use <ahref="https://fmod.com/docs/2.02/api/core-api-system.html#fmod_outputtype"><code>FMOD_OUTPUTTYPE_WAVWRITER</code></a> and the mixed audio produced by FMOD will be sent to the specified file. There will be no audible output when using this setting.</p>
<p>Logging level for non-final builds. The logging levels correspond to the similarly named <ahref="https://fmod.com/docs/2.02/api/core-api-common.html#fmod_debug_flags"><code>FMOD_DEBUG_LEVEL_XXX</code></a> flags used by the <ahref="https://fmod.com/docs/2.02/api/core-api-common.html#debug_initialize"><code>FMOD::Debug_Initialize</code></a> function in the Core API.</p>
<p>Name of event parameter to automate using Unreal occlusion ray casts. See <ahref="user-guide.html#occlusion">Occlusion Settings</a> for more information.</p>
<p>Name of event parameter to automate using Unreal ambient zone volume settings. See <ahref="user-guide.html#ambient-zone-settings">Ambient Zone Settings</a> for more information.</p>
<p>Name of event parameter to automate using Unreal ambient zone LPF settings. See <ahref="user-guide.html#ambient-zone-settings">Ambient Zone Settings</a> for more information.</p>
<p>The maximum number of active channels. This corresponds to the <code>numsoftwarechannels</code> parameter of <ahref="https://fmod.com/docs/2.02/api/core-api-system.html#system_setsoftwarechannels"><code>FMOD::System::setSoftwareChannels</code></a> in the Core API.</p>
<p>The sample rate for the FMOD mixer. This corresponds to the <code>samplerate</code> parameter of <ahref="https://fmod.com/docs/2.02/api/core-api-system.html#system_setsoftwareformat"><code>FMOD::System::setSoftwareFormat</code></a> in the Core API.</p>
<pre><code>Default: 0 (uses the default sample rate for the platform)
<p>Built-in output types that can be used to run the mixer.</p>
<pre><code>Default: TYPE_AUTODETECT
</code></pre>
<h4id="custom-pool-size"><ahref="#custom-pool-size">Custom Pool Size</a></h4>
<p>Size of memory pool to use. When this is set to a value other than zero a memory pool of the requested size is allocated using the Unreal memory system and all FMOD memory allocations are made from the pool. Otherwise FMOD memory allocations directly use the Unreal memory system.</p>
<pre><code>Units: bytes
Default: 0
</code></pre>
<h4id="codecs"><ahref="#codecs">Codecs</a></h4>
<p>Specifying one or more of the codec maximums will help determine the maximum CPU usage of playing FMOD_CREATECOMPRESSEDSAMPLE Sounds of that type as well as the memory requirements.</p>
<p>As well as settings exposed by FMOD For Unreal you will need to add the directory containing the FMOD bank files to the Additional Non-asset Directory To Copy setting in Unreal's Project - Packaging settings. The FMOD Studio settings UI will prompt you to update this setting if it is not correctly configured. See <ahref="user-guide.html#packaging-banks">Packaging banks</a> in the user guide for more information.</p></div>
