Importing Voice Assets from a Text File

It is not uncommon to have thousands of voice assets in your game, so it is important to have an efficient way to create these voice assets in Wwise. Since these assets are generally managed in an external program, such as Microsoft Excel, Wwise allows you to recreate them in your Wwise project by importing specific information from a tab-delimited text file. This not only speeds up the creation process but also reduces the potential for error.

	Note
	A tab-delimited text file is a special kind of plain text file where the information is arranged into columns separated by tabs. Most spreadsheet programs, including Microsoft Excel, allow you to export the information in a worksheet to a tab-delimited text file.

The following illustration demonstrates the workflow for getting your voice asset list from a spreadsheet program into Wwise.

Although your text file may contain many different pieces of information about your assets, only the following four types of information are used by Wwise when importing the file:

Filenames - This information is used to create the Sound Voice object and its corresponding audio source. Initially, the audio source will be empty, but it does contain a reference to an audio file with the same name. This means you can replace it in the same way you would any other audio file in Wwise. For more information on replacing media files for Sound Voice objects, refer to Replacing Sound Voice Media Files.
Random Container names - This information, if included in the text file, is used to create a parent Random Container for the corresponding Sound Voice object.
Sound Voice notes - This information is added to the Notes field of the Sound Voice object. For example, you may want to add the name of the character speaking the dialogue.
Audio source notes - This information is added to the Notes field of the audio source. For example, you may want to include the actual line of dialogue that is spoken.

	Note
	When you import voice assets into Wwise, the audio sources are created in the reference language only. To create audio sources for the different language versions in your project, refer to Importing Language Files.

The order and amount of information in your text file is not important, because before importing the file, you must specify which columns in your text file you want to import. The only mandatory piece of information is the filename because this name is used to create the Sound Voice object and the audio source. If a column in your text file has not been mapped to one of the four information types, it will be ignored by Wwise.

To help you make sure that you have correctly assigned the columns, a preview is displayed of the objects that will be created and the information that will be imported.

	Caution
	After you have imported the voice assets from a text file, it can't be undone.

To import voice assets from a text file:

From the Project menu, select Import Voice Assets.

The Voice Asset Importer opens.
Click the browse button (...) next to the File to import field.

The Open dialog box opens.
Select the text file you want to import and click Open.

The file's location is displayed in the File to import field.
If there is a header row in the text file and you want to use it to assign columns, select the Use header check box.
In the Header row spinner, specify which row in the text file contains the header information.
In the Start import at row spinner, specify the row at which you want Wwise to start reading the voice asset information.

From the Column Index list, select the corresponding column in your text file for each of the following column types:

	Note
	The filename column in your text file must be assigned to the Filename column type so that the voice assets in your text file can be recreated in Wwise. All other information is optional.

Filename
Random Container Name
Sound Voice Note
Audio Source Note

Review the information in the Voice Assets Preview table to make sure that you correctly assigned the columns in your text file to the corresponding information types in Wwise.
If you want to change the location where the new Sound Voice assets will be created, do the following:
- Click the Browse... button beside the Import destination text box.
- In the Project Explorer - Browser, select a new location in your project hierarchy.
- Click OK.
The new path is displayed in the Import destination text field.
Click Import.

The Sound Voice objects are created in Wwise along with their corresponding audio sources and Random Containers, if any. If any problems are encountered during import, Wwise will list them in the Import Completed dialog box.

Note

The import process may take a while if you have many assets because Wwise has to verify that every asset name is unique.

Related Topics

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.

Get started with Wwise

Wwise Help