Version
menu_open

Running the Cube Demo

With the advent of the Wwise Launcher, installing the Cube Demo sample will list it under the Samples tab where you can directly click Run Cube to launch the demo.

For Mac®, however, there are a couple of extra steps to follow beforehand.

Running the Cube Demo on Mac®

The Cube Demo for Mac requires libSDL2 to be installed. Without this, attempts to run the demo from the Launcher will present an error message: "The SDL2 library is not detected. The Cube Demo for Mac requires SDL2 to be installed according to the instructions at https://www.audiokinetic.com/library/<version>/?source=Cube&id=install_libSDL2_for_mac. Please restart the Wwise Launcher after the installation is complete." Likewise, attempts to run the game from the Terminal will display this message: "Library not loaded: @rpath / SDL2.framework / Versions /A / SDL2."

To install libSDL2 for Mac, do the following:

  1. Download the latest libSDL2 Mac OS X Runtime Binaries package: http://www.libsdl.org/release/SDL2-2.0.3.dmg .

  2. Follow the instructions provided in the libSDL2 README file.

Running the Cube Demo in Other Ways

For different reasons, it may be that users prefer not to use the Launcher to run the Cube Demo. There are alternative methods to run the Cube Demo, with some differences depending on whether it is run on Mac or Windows.

[Note] Note

Before starting on Mac OS X, make sure the Wwise SDK for Mac is installed on the machine.

On Mac OS X

  1. Method 1: Run under Xcode.

    1. Check that Xcode is installed. If Xcode is not present in the Applications folder, download and install it from the Mac App Store.

    2. Make sure the unzipped Cube demo folder shares the same parent folder as the installed Wwise SDK Mac distribution. For example, if the Wwise SDK folder is ${HOME}/Wwise/wwise_${version_tag}/SDK, then the Cube demo root folder must be ${HOME}/Wwise/wwise_${version_tag}/CubeDemo.

    3. In Xcode, open the following Xcode project: /path/to/CubeDemo/cube_source/src/Mac/CubeMac.xcodeproj.

    4. Build and run the project.

  2. Method 2: Use the shell scripts.

    1. Make sure the unzipped Cube demo folder shares the same parent folder as the installed Wwise SDK Mac distribution. For example, if the Wwise SDK folder is ${HOME}/Wwise/wwise_${version_tag}/SDK, then the Cube demo root folder must be ${HOME}/Wwise/wwise_${version_tag}/CubeDemo.

    2. Locate the executable shell script for the desired configuration: /path/to/CubeDemo/Mac/<configuration>/bin/RunCubeDemo.sh.

    3. If the .sh files are configured to be opened by Terminal, double click them in Finder. Otherwise, open Terminal then type /path/to/RunCubeDemo.sh and press Enter.

  3. Method 3: Run the executable in Terminal.

    1. The current working directory must be where the executables are located! Use the cd (change directory) command from $HOME to ../path/to/CubeDemo/cube. In Method 2, this detail is taken care of by the shell script.
[Note] Running Cube on Mac OS X Yosemite

To allow the Cube Demo to run on Mac OS X Yosemite, users need to manually register the installed SDL by following this procedure:

  1. Run the following command in Terminal:sudo find /path/to/SDL2.framework/Versions -name "SDL2" -exec codesign -f -s - {} \;

    Replace the above path to SDL2 with your own setup. SDL2 is usually installed under either ~/Library/Frameworks or /Library/Frameworks. When prompted, input your administrator account password and hit Enter.

  2. Restart Xcode and rebuild the Cube Demo.

For more information, please reference http://www.paradiso.cc/2015/04/18/using-sdlv2-with-osx-yosemite/ .

On Windows

  1. Method 1: Use the BAT scripts.

    1. Whether using the Wwise Launcher or the previous Wwise installer, the Wwise installation creates BAT files in the "<WwiseRoot>\Cube\cube" folder.

    2. Double click the BAT of the Cube Demo version you wish to run: debug, profiler, or release mode. Alternatively, open the Command Prompt and type the path to the BAT and press Enter.

  2. Method 2: Run the executable from the Command Prompt.

    1. Navigate to the executable, "cube.exe", and run it. It can found under "<WwiseRoot>\Cube\Win32\<mode>\bin" where "<mode>" corresponds to the appropriate mode folder, namely Debug, Profile, or Release.

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