Connect GameSound with Unity

Install the package

If Git is not installed, install and verify it from PATH first, then install the public package through Unity Package Manager.

1. 1

   Open Package Manager

   Go to Window > Package Manager in Unity.

2. 2

   Choose Git URL install

   Click the + button and choose Install package from git URL.

3. 3

   Enter package URL

   Paste https://github.com/vadaso/gamesound-unity.git to install.

4. 4

   Confirm setup

   Open Window > GameSound > Setup Wizard and confirm import folder and scene audio defaults.

Connect safely from the browser

Press Login in Browser in Window > GameSound to open the approval page. Unity will connect automatically after login and approval.

1. 1

   Open GameSound window

   Choose Window > GameSound.

2. 2

   Start login

   Press Login in Browser to open GameSound approval on gamesound.ai.

3. 3

   Approve connection

   Check account and request details in browser and approve.

4. 4

   Check projects

   Back in Unity, confirm loaded projects. If not refreshed, press Load Projects.

Import and update project audio

After selecting a project, find sounds by search, source filter, and folder groups, then import selected files into Assets/GameSound.

1. 1

   Choose project

   Press Load Projects and pick the project to use.

2. 2

   Refresh manifest

   Press Refresh from GameSound to fetch the latest project manifest.

3. 3

   Preview and import

   Use Preview, then Import / Update for one sound, and Update Imported for already imported tracks.

4. 4

   Apply updates

   If files changed on GameSound, run Refresh or Update Imported again; .meta references are preserved.

Place an Emitter in your scene

Press Create Emitter or drag an imported sound into Scene to create a GameSoundEventEmitter based on AudioSource playback.

• Playback triggers: Object Start, Enable, Disable, Destroy, Trigger, Collision, Mouse, Manual
• Loop, volume, 2D/3D spatial blend, distance, fade out, and positive pitch variation
• Imported AudioClip and GameSoundAsset are referenced like normal assets in the Unity project.
• Updated audio stays linked to the same reference when using Update Imported from GameSound.

Sync web-edited audio back to Unity

Unity does not open the web editor automatically. Open the project in GameSound, find the sound, and use the edit button.

1. 1

   Open web project

   In the GameSound project, open the sound you want to edit and press Edit.

2. 2

   Edit in web editor

   Adjust clip level, category, and effects in the new tab editor.

3. 3

   Save updated version

   Save a new version to the same project item from the web editor header.

4. 4

   Update Unity

   Use Refresh from GameSound or Update Imported to bring changes into Unity.

Troubleshoot connection and import

If connection drops, re-login in Unity. If assets do not refresh, fetch the latest manifest first, then run Update Imported.

• Only import paths under the Assets folder of your Unity project are supported.
• Supported direct import formats are MP3, WAV, OGG, and AIF.
• For incomplete downloads, keep the existing AudioClip and stop the update.
• Library downloads require a valid purchase or plan and available daily quota.
• If original MP3 frame metadata is invalid, re-upload a valid file in GameSound.