|
Wwise SDK 2025.1.2
|
The Media Pool is a central repository in Wwise that stores cached information about audio files and their metadata in databases. You can use the Media Pool to quickly and efficiently search audio files across your file system according to various search criteria including natural language descriptions and audio similarity to other media files. You can add databases to the Media Pool to search files even if they are not part of the Wwise project.
You can access the Media Pool in Wwise Authoring, where you can also audition the audio files. You can use the Wwise Authoring API (WAAPI) to create, organize, and query databases.
Media Pool databases are organized in a tree structure, with a private root node. The databases contain metadata about audio files such as their names, fields, and extracted audio features. The databases do not contain the audio files themselves. Wwise never writes, renames, or moves the actual audio files added to the Media Pool.
There is one Project Originals database, which contains information about audio files that are already included in the Wwise project. You can also create User Databases, which link to libraries or directories that contain audio files that are not included in the Wwise project (for example, a recently downloaded Strata collection). If you import files into Wwise from a location linked to a User Database, their information is added to the Project Originals database as well.
Add User Databases as required to search audio files from multiple locations in your file system. When you use WAAPI to create databases, ensure that you create them under the User Databases folder.
The following example shows the tree structure of the Media Pool databases and folders along with their GUIDs:
The databases are created in:
LOCALAPPDATA%\Audiokinetic\Wwise\MediaPool\Databases$HOME/Library/Application Support/Audiokinetic/Wwise/MediaPool/DatabasesEach database has an associated Lightning Memory-Mapped Database (LMDB) as its storage backend.
The databases in the Media Pool are standard Wwise objects and can be managed with the following WAAPI functions:
The WAAPI object type for a database is "MediaPoolDatabase". See Wwise Objects Reference for more object types.
When querying the Media Pool, you can search for audio files based on various criteria such as names, metadata fields, or audio features. You can filter results by specific fields and values.
To query the Media Pool, use ak.wwise.core.mediaPool.get.
Queries executed through WAAPI can define the following arguments:
operator and a value."equals", "notEquals", "contains", "startsWith", "endsWith", "matchesRegex"."equals", "notEquals", "lessThan", "greaterThan", "lessThanOrEqual", "greaterThanOrEqual".weight (0-1) to influence its importance in the search.weight (0-1) to influence its importance.See Examples for examples of Media Pool queries.
The Media Pool provides access to various metadata fields. In Wwise Authoring, these fields appear in the Media Pool's metadata pane.
You can use Media Pool fields to do the following:
Path, FileId, and Db for each file.The Media Pool supports additional return options such as "Markers" and "DetectedRegions". See the return option in ak.wwise.core.mediaPool.get for the complete list.
The fields are collected from the audio files and arranged under the following categories:
To retrieve the full list of available fields, use ak.wwise.core.mediaPool.getFields. Fields under the BWFXML section are discovered dynamically when Wwise scans the audio files.
The Universal Category System (UCS) is an attempt to standardize audio file naming and categorization to improve organization, searchability, and interoperability across different sound libraries and software. UCS fields are located under the BWFXML/ASWG and BWFXML/USER sections in the Media Pool:
Des questions ? Des problèmes ? Besoin de plus d'informations ? Contactez-nous, nous pouvons vous aider !
Visitez notre page d'AideEnregistrez votre projet et nous vous aiderons à démarrer sans aucune obligation !
Partir du bon pied avec Wwise