Lumberyard
User Guide (Version 1.15)

Creating a Wwise Project for Runtime Text-to-Speech

You can use the Audiokinetic Wwise audio system in Amazon Lumberyard to implement Text-to-Speech Cloud Gem features in your game project. To use Wwise to integrate sound into your Lumberyard game, you perform the following major steps:

For the first four steps, you use the Audiokinetic Wwise authoring tool. For the last step, you use the Audio Controls Editor in Lumberyard Editor.

Prerequisites

Audiokinetic Wwise LTX – Audiokinetic Wwise LTX is an exclusive, free version of the Audiokinetic Wwise audio system for PC games that is included with Lumberyard. For installation information, see Audiokinetic Wwise LTX.

Create a Wwise Sound Project

To create a Wwise sound project and its associated directories, you use the Wwise authoring tool.

To create a Wwise sound project

  1. Run the Wwise LTX tool.

  2. In the Project Launcher dialog box, click New.

    
            Click new
  3. In the New Project dialog box, specify the directory for the sound project files. Lumberyard requires that your sound project files (.wproj file and subdirectories) be placed in the dev\game_project\Sounds\wwise_project\ directory.

    
            Specify the sound project directory
  4. Click OK. Your project appears in the wwwise_project directory that you specified.

Create a Sound in the Wwise Project

To create a sound, you use the Audio tab of the Wwise authoring tool.

To create a sound in the Wwise project

  1. In the Wwise Project Explorer panel, create a directory under Actor-Mixer Hierarchy. Right-click Default Work Unit, and then choose New Child, Virtual Folder.

    
            Create a virtual directory
  2. Give the directory a name.

    
            Name the directory
  3. Create a sound object. Right-click the directory that you created, and then choose New Child, Sound SFX.

  4. Give the sound a name.

    
            Create and name a sound object

Create an Event to Trigger the Sound

After you create a sound, you create an event with which you can trigger the sound from the context of your game.

To create a sound trigger event

  1. Under Actor-Mixer Hierarchy, select your new sound.

  2. In the project view Contents Editor pane, click Add Source, and then select Wwise Audio Input.

    
            Add the Wwise audio input source
  3. Right-click the sound that you created. Choose New Event, Play to create an event that can trigger the sound.

    
            Create an event

    A new event is created with the default name of Play_{sound-name}_{nn}. You can specify a different name if you want. The event ID appears on the upper right.

    
            Created sound event

Generate the Soundbank File and Save the Wwise Project

After you have created an event for the sound, you generate a soundbank file and save the sound project.

To generate the soundbank and save the project

  1. In Wwise LTX, click Generate Soundbank.

    
            Generate soundbank file

    If the Generate Soundbank button is not available in the version of Wwise that you are using, perform the following steps:

    1. Open SoundBank Manager. Choose Layouts, SoundBank, or press F7.

    2. In the SoundBanks pane, select the Default Work Unit check box.

    3. In the Platforms pane, select Windows.

    4. In the Languages pane, select English (US).

    5. Click Generate.

  2. In the Generating SoundBanks - Completed window, click Close.

  3. In the Wwise Project menu, choose Save.

Integrate the Wwise Project with Your Game Project

Now you are ready to use Lumberyard's Audio Controls Editor to integrate your Wwise sound project with your Lumberyard game project.

To integrate the Wwise sound project with your Lumberyard game project

  1. In Lumberyard Editor, choose Tools, Other, Audio Controls Editor. Alternatively, click the headphone icon.

  2. In the left panel of Audio Controls Editor, create a new directory. This example creates a directory called wwise.

  3. In the Wwise Controls middleware pane (the default location is on the far right) you should see an item for each event that you created and a .bnk file. The .bnk file is the soundbank file that you generated.

    
            Generated sound files

    Drag these items from the Wwise Controls pane to the directory that you created on the left. This step alerts your game to the presence of the Wwise objects.

  4. Click the item on the left that was created from the .bnk file. The Inspector panel inspects the object.

  5. If the list under Preloaded Soundbanks is empty, drag the .bnk file from the Wwise Controls panel into the list of preloaded soundbanks.

    
            Drag the soundbank file
  6. In the Audio Controls Editor, choose File, Save All.