Table of Contents

Audio File Importer

In the Audio File Importer, you can import Sound SFX and Sound Voice media files into your Wwise project, determine how you want the files to be integrated, and where in the project you want to import them. You can import a file at different times and for different reasons:

  • To bring new files into the project and to create new structures

  • To replace existing files

  • To localize for language versions

To accommodate how you intend to use the imported files in the Audio File Importer, you can specify corresponding import modes.

When a file is imported, it is validated to ensure that it will be supported in Wwise. If a problem occurs during the import process, you can view the errors and resolve if possible some of the errors in the Import Conflict manager.

What Files Are Supported?

The following audio file properties and formats are supported:

PCM Audio Formats

  • WAV and AMB

Channel Configurations

  • 0.1 to 13.1

Sample Rates

  • Up to 96 kHz

Bit Depth

  • 16 Bits

  • 24 Bits

[Note] Note
Wwise can also import 32-bit float PCM files; however, the maximum conversion format is only 24 bits. Additionally, when played in the Transport Control, files are converted to 16 bits.

DC Offsets

It is sometimes a good idea to remove the DC offset using a DC offset filter because DC offsets can affect volume and cause artifacts in Wwise. There are some cases where you should not remove the DC offset, for example for sample accurate containers. In other cases, for example, where sounds are normalized to 0 dB, you may or may not need to remove the DC offset. This setting can be enabled in the Conversion Settings dialog box.

[Caution] Caution

We recommend not removing the DC offset for looping sounds. The remove mechanism is a high-pass filter, so there is no guarantee that it will modify the first and last sample of the loop in the same way because it does not know they will play contiguously. This could create a discontinuity in the signal, which is audible as a click.

Interface Element

Description

Opens a search field where standard alphanumeric entries filter out unmatching elements from the view. Learn more in Using Tables.

Click the Close icon to the left of the search icon to close the search field and remove the filter.

[Note] Note

The searches do not include elements in collapsed nodes of the List View, Query Editor, MIDI Keymap Editor, and Reference View.

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.

Import Mode

  • Create new objects: Imports the files as new objects in the current Wwise project.

  • Replace audio files: Imports the files to replace media files in the current Wwise project.

  • Localize languages: Imports the files for localization of the current project.

Import as

  • Sound SFX: Imports the files as Sound SFX objects to the specified destination in the project hierarchy.

  • Sound Voice: Imports the files as Sound Voice objects to the specified destination in the project hierarchy.

Destination language

Defines the language associated with the imported Sound Voice files from a list of project languages that were determined in the Language Manager.

Audio file destination

Allows to select a subfolder for the files and folders to import in the Original folder.

Object destination

Allows to select the location within the current project hierarchy of the game structure where the media files will be imported, selected in the Project Explorer- Browser.

 

Opens the File Open dialog box where you can select files that you want to import.

Opens the Folder Open dialog box where you can select folders that you want to import.

[Tip] Tip

You can also drag files or folders from your system to the import list.

Import Tab Delimited...

Imports a tab delimited text file that defines the audio files to import, and the structures to create.

For more information, refer to Importing Media Files from Tab Delimited Text Files.

Remove the currently selected files and folders from the list to import.

 

Audio File/Folder

The name of each audio file or folder to be imported.

Template selector. Shows a shortcut menu allowing to browse for a template and to select the most recently used templates. When a template is selected, it will uses the current Template match mode to match audio file names with template object names.

[Tip] Tip

You can multi-select entries in the list and select a template to quickly apply the template to multiple entries simultaneously.

Template

Shows the associated template object for the file or folder to import. Refer to Using a Template to Import Media Files for more information.

Object Type/Action

Shows a drop down listing the possible object types to create for the WAV file or folder. Also list the following actions when they are possible:

  • No Object: Selecting this option will not create a Wwise object for the WAV file or folder. Note that when selecting this option for a WAV file, the WAV file will still be imported. You need to remove the entry from the list if you do not wish to have the WAV file imported. Use the DEL key to remove entries from the list.

  • Use existing object: Selecting this option will not create a new Wwise object for the WAV file or folder but instead will re-use the existing object found at the specified location in the project (with the same name) and will merge the existing content with the descendants of the imported entry. This option is only available when a matching object is found at the import destination.

  • Copy template: Selecting this option will copy the associated template object (including all it's settings) and will use the imported WAV file for the copied object. This option is only available when a template is associated.

[Tip] Tip

You can multi-select entries in the list and change the object type or action to quickly modify multiple entries simultaneously.

Object

Shows the object name and type resulting from the importation.

The object name color may be:

  • White, when a new object will be created.

  • Yellow, when a new object will be created from the associated template.

  • Gray, when an existing object will be used for creation of the descendants.

[Note] Note

In case of name conflict at the destination, the resulting object may have a different name. A sequence number will be appended if the target name already exists at the destination.

Message

Shows additional information about the current situation. You may review those messages to ensure the importation will done correctly.

File Size

The size in KB of the media files.

Date Modified

The date and time that the last changes were made on the media file.

Template match mode

Sets the match mode when using a template.

  • Match all: Tries to match each audio files and folders with a template object using the string distance and an assignment algorithm. Audio file names and template names do not needs to be equal. This method works well in most scenarios but may match unrelated elements if the audio file names are too different from the template names.

  • Perfect matches only: Matches only the audio file names and the template names that are the same.

Auto Add/Checkout on Source Control

Determines if Wwise will automatically perform an Add or Checkout operation on the imported files with the source control.

[Note] Note

This option is only visible when a Workgroup plug-in (source control) has been selected in the Project Settings' General Tab.

Custom Properties button

Shows the Custom Properties editor dialog allowing to set custom properties on the imported objects.

[Note] Note

This option is only available when custom properties are set in the Project Settings.

Opens the Importing dialog box where you can view the progress of the file import and stop the import if required.

Closes the Audio Importer dialog box.