Version

menu_open

SoundBanks Settings - SoundBanks Tab

The SoundBanks tab of the SoundBanks Settings dialog box is where you define custom settings for your own personal SoundBanks. For example, you can specify whether to generate content and header files with your SoundBanks, whether SoundBank names can be used, and the location where your SoundBanks will be saved. Within this dialog box, you can also specify pre-defined or custom steps that will be performed before and/or after the SoundBanks are generated. These user settings override the SoundBank project settings which are defined in the Project Settings dialog box.

Interface Element

Description

 

Override Project SoundBank Settings

Overrides the project SoundBank settings, which allows you to create your own custom settings for your SoundBanks.

Allow SoundBanks to exceed maximum size

Determines whether SoundBanks that exceed the maximum size will be generated or not.

Generate SoundBank content files

Creates files that list the contents of each SoundBank. The content files include information on events, busses, states, and Switches, as well as a complete list of streamed and in memory media files.

SoundBank content file format

Specifies the text file type for SoundBank content files.

[Tip] Tip

If you have file paths or object names or notes that contain non-ANSI characters, you should use the Unicode format.

Generate header file

Creates a header file that maps names to IDs. The header file maps events, states, Switches, and Game Parameters.

The header file is saved in the header file path under the name “Wwise_IDs.h”.

If your programmers prefer to work with IDs in the code, you must generate the header file.

Event info: Max attenuation

Determines whether maximum attenuation information is included in the SoundBanksInfo.xml file for each event.

Event info: Estimated duration

Attempts to determine the expected duration of each Event in a SoundBank. For each event, a DurationType, MinDuration, and MaxDurations attribute will be included in the soundbanksinfo.xml file. The DurationType may be one of: "OneShot", "Infinite", "Mixed" or "Unknown". "OneShot" indicates a non-looping sound; "Infinite", a looping sound; "Mixed", a sound which may or may not loop infinitely (possibly based on random chance or a Switch), and "Unknown" indicates that Wwise was not able to determine the duration. The MinDuration and MaxDuration attributes attempt to place a lower and upper bound on the duration of an event. Note that these bounds are only an estimate and may or may not be accurate depending on runtime conditions.

Use SoundBank names

Determines whether SoundBank names or IDs are used to:

Name the generated SoundBank files (for example "Init.bnk" or "1355168291.bnk")

Identify the target when one SoundBank refers to media in another SoundBank.

Depending on the Low-Level I/O implementation used in your game, this option may affect how AK::SoundBank::LoadBank() can be called. For more information, please refer to Using SoundBank Names in the Wwise SDK documentation (under Sound Engine Integration Walkthrough > Integrate Wwise Elements into Your Game > Integrating Banks > Integration Details - Banks > General Information).

Header file path:

The path or location where the SoundBank header file will be saved.

The path or location may be different depending on whether you are using the project location or a custom location for the current user.

Opens the Browse For Folder dialog box which allows you to change the default location where the SoundBank header file will be saved.

 

Override Project SoundBank Paths

Overrides the project settings for the SoundBank paths, which allows you to create custom paths where your SoundBanks will be saved.

Click the Configure Columns... shortcut (right-click) option from the column header band.

The Configure Columns Dialog opens. Specify which columns to display and their order.

Platform

The name of the platform associated with a specific path or location, such as Windows, Xbox One, Mac, iOS, Switch, and PlayStation 4.

SoundBank Folder

The path or specific folder where the SoundBanks will be saved.

The path or location may be different depending on whether you are using the project location or a custom location for the current user.

Opens the Browse For Folder dialog box which allows you to specify a new folder where the SoundBanks for each platform will be saved.

 

Override Project Pre-Generation Step

Overrides the project settings for the pre-generation step. You can create a custom pre-generation step, such as checking out specific SoundBank files from your source control system.

Click the Configure Columns... shortcut (right-click) option from the column header band.

The Configure Columns Dialog opens. Specify which columns to display and their order.

Platform

The name of the platform on which the custom step will be performed, such as Windows, Xbox One, Mac, iOS, Switch, and PlayStation 4.

The Global opening step is a non-platform specific step that is performed before any of the other steps.

Description

Specific information that describes the command line.

Click the description and then Press F2 to edit the description directly in the table.

Command Line

A form of command line shell that allows you to write commands that will perform custom jobs pre SoundBank generation. For example, you could write a command line that checks out specific SoundBank files from your source control system.

Click the command and then Press F2 to edit the command line directly in the table. If you have multiple lines in your command, you will have to open the Pre-Generation Step Editor to edit the additional command lines.

(Edit)

Opens the Pre-Generation Step Editor where you can build and edit a command line that will perform custom jobs. For example, you could write a command line that checks out specific SoundBank files from your source control system.

As an alternative to clicking the Edit button, you can simply double-click a row in the table to open command line in the Pre-Generation Step Editor.

 

Override Project Post-Generation Step

Overrides the project settings for the post-generation step. You can use one of the factory command lines that ships with Wwise or you can create your own.

Click the Configure Columns... shortcut (right-click) option from the column header band.

The Configure Columns Dialog opens. Specify which columns to display and their order.

Platform

The name of the platform on which the custom step will be performed, such as Windows, Xbox One, Mac, iOS, Switch, and PlayStation 4.

The Global closing step is a non-platform specific step that is performed after all other steps.

Description

Specific information that describes the command line.

Click the description and then Press F2 to edit the description directly in the table.

Command Line

A form of command line shell that allows you to write commands that will perform custom jobs post SoundBank generation. The default command line copies the streamed files to the location where the SoundBanks are saved.

Click the command and then press F2 to edit the command line directly in the table. If you have multiple lines in your command, you will have to open the Post-Generation Step Editor to edit the additional command lines.

(Edit)

Opens the Post-Generation Step Editor where you can build and edit a command line that will perform custom jobs. For example, you can use a command line to group your SoundBanks into a package using the File Packager.

As an alternative to clicking the Edit button, you can simply double-click a row in the table to open the command line in the Post-Generation Step Editor.

 

Saves the SoundBank settings and closes the dialog box.

Closes the SoundBanks Settings dialog box without saving the settings.


Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

Tell us about your project. We're here to help.

Register your project and we'll help you get started with no strings attached!

Get started with Wwise