Version

Using a Template to Import Media Files

When importing media files from a folder, you can select an object in your project that will be used by the Audio File Importer as a template to create new Wwise objects for the folders and media files you are importing. This can be useful when creating several similar structures where only the media files differ from structure to structure.

A typical example is when you want to create multiple car structures; they are all similar but have different media files and are associated with a specific car brand or model. Here is the workflow:

  1. Create the first car structure in your project that will become your template to import the next structures. This structure can be a combination of any containers and sound objects.

    If you are satisfied with it, then this car structure can be the template for your next one.

  2. On your computer, create a folder structure that parallels the car structure you just created in Wwise to hold your media files.

    Now you have a structure that you will easily be able to import.

  3. Click Import Audio Files... from the Project or the shortcut menu. Default shortcut: Shift+I.

    The Audio File Importer opens.

  4. Click Add Folders....

    An Explorer dialog opens.

  5. Navigate to and click the folder you want to import (the parent folder of the car structure you just created).

    The selected folder's name appears in the Folder field.

  6. Click Select Folder.

    Focus returns to the Audio File Importer where the local folder hierarchy now appears in the Audio File/Folder panel, along with any media files that were found in the structure.

  7. To the left of the Template column, click the selector [>>] and browse for the structure you created in the first step. This will set the template. The selector [>>] also lists the objects most recently used as templates.

    At this point, Wwise will try to automatically match the media files and folders you are importing with the objects in the template. The matching folders will be designated as the same container type as their template counterpart, while ones without a match will by default be Random Containers.

    [Note] Note

    You can change how strictly Wwise matches these imports by selecting from the Template match mode list in the lower left of the Audio File Importer. Match all mode uses special algorithms to find the best matches between the imported files and the template objects, while Perfect match only mode will only match imported files and folders with template objects when their names are exact matches. If Wwise finds no match between an imported item and the template, "No matching template found" appears in the Message column.

    [Tip] Tip

    The template matching algorithm is based on name comparison. Therefore, best practice would be to have names in the folder hierarchy similar to the names in the template hierarchy.

    [Note] Note

    If the template did not match the structure being imported, you can completely remove the template by clicking the selector [>>] and selecting None. You can also disassociate a template by selecting a new object type in the Object Type/Action column.

  8. Click Import.

    [Note] Note

    If there is a conflict with existing files, the Import Conflict Manager opens to allow you to resolve the conflict before finalizing the import.

    The Audio File Importer closes and the new structure appears in the Project Explorer hierarchy.