Version
|
Wwise SDK 2019.2.15
|
SoundBank generation. SoundBank generation is performed according to the settings stored in the project. Custom user settings are ignored when SoundBank generation is launched from the command line. However, some of these settings can be overridden from the command line.
PROJECTThe path to the project file (.wproj). |
--abort-on-load-issuesAborts the operation if a project load issue is detected. All logged project load issues are printed to screen. |
--audio-source-from-originalIt is possible that a project already contains some audio source files of the same name as the imported ones when doing a tab delimited import. By adding this option, the operation uses those instead of replacing them with those described by the tab-delimited file. |
--bank SOUNDBANK--bank SOUNDBANK1 SOUNDBANK2 ...--bank FILESpecifies which SoundBanks are generated. This option must be followed by the name of the SoundBank to be generated. Multiple SoundBanks can be specified. If no SoundBank is specified, all SoundBanks are generated. Alternatively, a text file containing a list of SoundBank names can be specified, by specifying the full path to the text file, including the extension '.txt'. |
--cache PATHOverrides the project's cache folder path and instead uses the (relative) path specified in the command. |
--clear-audio-file-cacheDeletes the content of the Wwise audio file cache folder prior to converting source files and generating SoundBanks, which ensures that all source files are reconverted. Note that the whole cache is cleared, for all platforms, regardless of the –platform option. |
--continue-on-errorUse this option if you want to continue even if an error occurred. |
--custom-global-closing-cmd CMDOverrides the global closing step that was defined in Wwise. This option must be followed by the new command line (use quotes if there are spaces). An empty string ("") specified for the command-line means no global closing step is executed. |
--custom-global-opening-cmd CMDOverrides the global opening step that was defined in Wwise. This option must be followed by the new command line (use quotes if there are spaces). An empty string ("") specified for the command-line means no global opening step is executed. |
--custom-post-gen-cmd PLATFORM CMD--custom-post-gen-cmd PLATFORM1 CMD1 --custom-post-gen-cmd PLATFORM2 CMD2 ...Overrides the custom post-generation step command line that was defined for this platform in Wwise. This option must be followed by the platform identifier (listed above), followed again by the new command line (use quotes if there are spaces). To override the custom post-generation step command line of another platform, repeat the option –custom-post-gen-cmd followed by the other platform's identifier and its new command line. An empty string ("") specified for the command-line means no post-generation step is executed. |
--custom-pre-gen-cmd PLATFORM CMD--custom-pre-gen-cmd PLATFORM1 CMD1 --custom-pre-gen-cmd PLATFORM2 CMD2 ...Overrides the custom pre-generation step command line that was defined for this platform in Wwise. This option must be followed by the platform identifier (listed above), followed again by the new command line (use quotes if there are spaces). To override the custom pre-generation step command line of another platform, repeat the option –custom-pre-gen-cmd followed by the other platform's identifier and its new command line. An empty string ("") specified for the command-line means no pre-generation step is executed. |
--header-fileGenerates the header file Wwise_IDs.h, even if this option is not specified in the project settings. |
--header-file-pathOverrides the header file path specified in the project settings. This option must be followed by the path (absolute or relative) in which the header file (Wwise_IDs.h) will be written. This is only effective if the header file's creation is required. |
--import-definition-file FILE--import-definition-file FILE1 FILE2 ...--import-definition-file FILE1 --import-definition-file FILE2 ...Imports a SoundBank definition file. This option must be followed by the full path of the bank definition file to be imported. Multiple files can be specified. If the option –save is not specified, the changes made to the project as a result of the imported definition file do not persist. |
--import-language LANGUAGEWith the tab-delimited import operation it is possible to import voices. This option is used to specify the language of the imported voices. This option must be followed by one of the language identifiers listed with the –language option. Note that only audio files are added for this operation; any attempt to concurrently perform other operations, such as volume adjustments, is ignored. |
--language LANGUAGE--language LANGUAGE1 --language LANGUAGE2 ...Specifies the languages for which the SoundBanks are generated. This option must be followed by a language identifier defined in the project. Each specified language must be prefixed with this option. |
--license LICENSESets the license to be used. The license is not saved in the project. |
--no-decodeAvoids generating DECODED files in the .cache folder, which saves CPU and disk space for your Wwise project. It also reduces the SoundBank generation time. Warning: If you do not generate the DECODED files, playing back these sounds in Wwise Authoring could result in an outdated playback or no playback at all. Clearing the file cache is recommended after using this option. |
--no-wwise-datDisables writing to hidden 'wwise.dat' files when converting audio files. This is useful when calling from a build tool that already handles file dependencies, as it allows multiple instances of Wwise to convert to the same directory simultaneously, without conflicting. Note that this option does not prevent the reading of existing hidden 'wwise.dat' files. |
--platform PLATFORM--platform PLATFORM1 PLATFORM2 ...--platform PLATFORM1 --platform PLATFORM2 ...Specifies the platforms for which SoundBanks are generated. This option must be followed by the platform identifiers. |
--quietDisables all non-error console text output. |
--saveSaves the project before generating SoundBanks. If a tab-delimited-import-file was provided, the imported content is saved as well. Saving the project implicitly migrates first, if required. |
--skip-languagesWill not generate any localized SoundBank in the project. |
--soundbank-path PLATFORM PATH--soundbank-path PLATFORM1 PATH1 --soundbank-path PLATFORM2 PATH2 ...Overrides the SoundBank path specified for this platform. This option must be followed by the platform identifier (listed above), followed again by the new path (absolute or relative, use quotes if there are spaces). To override the path of another platform, repeat the option –soundbank-path followed by the other platform's specifier and its new path. |
--tab-delimited-import-file FILE--tab-delimited-import-file FILE1 FILE2 ...--tab-delimited-import-file FILE1 --tab-delimited-import-file FILE2 ...The tab delimited file to import. Multiple files to import can be specified after this option. |
--tab-delimited-operation createNew--tab-delimited-operation useExisting--tab-delimited-operation replaceExistingDetermines how import object creation is performed for each object created. "createNew": creates a new object; the object is given the desired name if possible, otherwise a new unique name is used. "useExisting": uses the object if it exists, updating the specified properties; otherwise it creates a new object. This is the default value. "replaceExisting": creates a new object; if an existing object has the same name then the existing object is destroyed. Possible values:
|
--use-stable-guidGive the SoundBank a stable GUID accross multiple builds if you don't want to save the project. |
--verboseEnables extra console text output. |
|
result The process exit code of SoundBank generation. Although your SoundBanks may generate properly with warnings, it is strongly recommended that you consider these warnings as errors. For example, WwiseConsole.exe returns an error code when a source file is missing. Although a missing source file does not prevent your SoundBanks from being generated, the resulting SoundBanks may potentially be incomplete. You can change the severity of most messages encountered during the SoundBank Generation by going to Project Settings > Logs, in Wwise. Changing the severity of the messages impacts the return codes. A WwiseConsole.exe exit code of 0 means success, 1 means at least one error (and potentially warnings) occurred, and 2 means that only warnings occurred. |
Refer to Using the Command Line for more information about Wwise Console.
Questions? Problems? Need more info? Contact us, and we can help!
Visit our Support pageRegister your project and we'll help you get started with no strings attached!
Get started with Wwise