3.0 Alpha Preview 7

Even more fixes!
Some of these were a long time coming.

Changes

• The default Audio File Preset path is now set to Assets/JSAMPresets
  • You can change the path in Project Settings/Audio - JSAM/Editor/Presets Path
  • The default presets can still be found within the JSAM package folder. The default presets will always be loaded
• The Stop Sounds on Scene Load setting has been renamed to Stop All Sounds on Scene Changed. The behavior associated with this setting has been adjusted accordingly.
• Added Stop All Music on Scene Changed setting
• Added a check during Audio File preset creation that ensures the Preset path defined in the Project Settings exists.

Fixes

• Fixed a warning that appears when JSAM is imported for the first time
• Fixed AudioManager trying to do things while you're in prefab mode
• Fixed AudioManager trying to look for an AudioListener in OnValidate, this should cause less log messages to appear in console when loading scenes
• Fixed some inspector-specific behavior with Sound/Music Player components
  • Fixed Advanced Mode not being toggleable if there was no Library set in the AudioManager and the component was missing an Audio File reference
  • The "use advanced mode" warning now goes away when Advanced Mode is enabled

3.0 Alpha Preview 6

More fixes!
Some more fixed than others.

Fixes

• Fixed AudioSource spatialization only happening after the sound is played
• Suppressed an error being thrown when trying to preview a Sound/Music File Object whose missing their AudioClip references
  • Of course, you still should not try to use an Audio File Object that has no AudioClips
• Made playback preview time label mono-spaced so it's nicer to look at during playback
• Fixed "Select an Audio File to preview it here" label in the JSAM Playback Tool becoming black when the cursor is not hovering over it
• Fixed JSAM throwing an error when you reload the current scene and then try to change the volume
• Removed deprecated volume-related event references from Sound/Music Channel Helpers
• Made the height of the lock button the same as other buttons in the JSAM Playback Tool
• Fixed JSAMPaths having a syntax error specifically in Unity versions before 2021.3

3.0 Alpha Preview 5

A small release to compile some recent fixes to some annoying issues.

Fixes

• Fixed errors being thrown when trying to build
• Fixed null references thrown when changing volume with Unity's enter play mode option enabled
• Fixed JSAMStartupWindow not actually saving the fixed package path if it detects an invalid path
• Fixed Samples~.meta warning appearing when importing JSAM as a git URL

3.0 Alpha Preview 3

Still not very sure when to drop the alpha/preview tag from the version 3 release.

For those curious why 2 was skipped, it's because I pushed Preview 2 stealthily via editing the package manifest in the git repo without making a new Unity package.

If you're using Unity 2020 and later, try installing the package through the Package Manager to get access to updates like Preview 2 and 3 more easily

Major Changes

• Added a ChannelOverride property to Audio File Objects, so your SoundFileObjects can have their volume controlled by the Music slider and your MusicFileObjects can have their volume controlled by the Sound slider instead
• Added a "Voice" volume channel to the AudioManager component
  • To use the new Voice volume channel, use the ChannelOverride parameter
  • Removed the volume mixer group parameters since they conflicted with the current Volume paradigm
• Improved AudioPlaybackTool
  • Audio File libraries are now displayed in a narrow right-hand window
  • The currently selected AudioClip/AudioObject can be locked separately from Unity's built-in inspector locks. You can use this to have an in-editor music player!
• Finished implementing the Video Volume sample
• Improved usability of VideoPlayerVolume component
• Added Unity 2019 compatibility to JSAMPaths, JSAM should be usable in Unity 2019 again

Minor Changes

• Updated the names of template objects in the GameObject right-click dialogue
• Some Audio File Wizard settings now persist between closing/re-opening of the tool window
• Added a default Voice preset
• Added some additional feedback after the JSAMSettings asset is created
• Fixed the wording of the JSAMSettings generation dialogue
• The JSAMStartupWindow now accurately reports the current package version
• The "Reset to Default" button in the JSAM Project Settings now resets some settings, more reset buttons will be added down the road

Fixes

• Fixed null reference that sometimes occurs when audio playback ends
• Fixed PlayMusic not actually using the mainMusic parameter
• Fixed MusicChannelHelper not Stopping playback properly, leading to unpredictable behaviour
• Fixed Music Zones not responding to Music volume changes properly
• Fixed JSAM-related paths in the Project Settings not saving properly

3.0 Alpha Release

Finally putting together a new package since JSAM 3 is approaching a production-ready state. No documentation just yet, but the new API is well-commented and there are Example scenes you can explore.

I do not recommend upgrading an existing project from JSAM 2 to 3 as a lot of script names have changed and so most of your references will break and Sound/Music File Objects will have to be re-created.

Remember to check out the new Audio File Wizard to help convert all your AudioClips into Sound/Music File Objects!

Below is a (non-exhaustive) list of changes

Changes

• AudioFileMusic/AudioFileObjects are now called MusicFileObject/SoundFileObject respectively
• Added StopSoundIfPlaying and StopSoundIfLooping
• Added many many static methods to AudioManager as shorthands for commonly used API
  • ie. PlaySound, PlayMusic
• Expanded usability of Sound/Music File Objects
  • You can pass Sound/Music File Objects into AudioManager.Play
  • Added a .Play() shorthand to Sound/Music File Objects
  • File Objects can be used in most helper components (AudioEvents, SoundPlayer, MusicPlayer etc.)
• Added Max Playing Instance property to define the maximum number of a specific sound to be played at once.
• Added support for AudioMixers
• Added new Static Events to AudioManager component
  • OnAudioManagerInitialized
  • OnSoundPlayed, OnMusicPlayed
  • OnMasterVolumeChanged, OnMusicVolumeChanged, OnSoundVolumeChanged
• Audio Libraries are now a ScriptableObject. You can share them between different AudioManager instances or even between projects
• Added AudioFileWizard to allow mass conversion of many AudioClip assets to Sound/Music File Objects.
  • Accessible via Window -> JSAM -> Audio File Wizard
• Added VideoPlayerVolume component.
  • Add it next to a VideoPlayer component to have the VideoPlayer conform with JSAM's volume settings
• AudioMusicZones now supports having multiple different zones play the same sound
• Moved AudioManager settings into ProjectSettings
• Changed AudioChannel instantiation to use default AudioSource components and to be created during runtime without supplying a prefab.
  • A prefab override for Sound/Music channels can be specified by the user in the ProjectSettings
• Abbreviated main package folder to JSAM
• Removed File Library mode from Sound File Objects, all AudioClips are now stored in a "Files" array
• Removed 3D music as a separate music type. Music can now be spatialized
• Removed PlaySoundLoop invocation, looping property is now specified in SoundFileObjects
• Moved most properties from AudioPlayer and AudioPlayerMusic to their respective Audio File Objects
• Capitalized the instance in AudioManager.Instance
• Adjusted the font size of Quick Reference Guide text, font size can be adjusted in the Project Settings
• Removed "Category" dropdown from Audio File object inspector
• Removed "Audio File Object" label and name fields from Audio File object inspectors, now use the name of the ScriptableObject
• Added warning beneath Audio Playback Preview window to disable the "mute audio" option in the Game View to preview audio
• Added a lot more useful logging

Fixes

• Fixed Audio Particles making no distinction between playing on Particle emit and death
• Fixed double-clicking an asset to open the audio in the AudioPlayer not re-rendering the audio waveform
• Fixed sounds rarely cutting each off when a Sound marked as Spam priority was being played constantly
• Fixed Audio Music Zone continuing to play after switching scenes

Playback Tool Fixes

The fastest new release in the West

Bug Fixes

• Fixed AudioPlaybackTool not updating the waveform when you manually play a different AudioClip in the AudioFileObject's library
• Fixed AudioPlaybackTool throwing an error when you wanted to preview an AudioFileObject in library mode but has it's non-library AudioClip field empty
• Fixed AudioPlaybackTool throwing an error when trying to preview an Audio Object with no AudioClips
• Hid some in-development features that snuck through in the previous build

Minor Fix

October has been a real busy month, but if there are things to fix then they need to be fixed!

Bug Fix

• Fixed Audio File Objects and Audio File Music Objects throwing an error in cases where an AudioManager wasn't present and/or no enums were generated.

Some More Bug Fixes

Been quite busy lately so not many new features just yet

Minor Changes

• Changed the way AudioManager validates the Audio Files path, when a path that doesn't contain the Assets folder is entered, reverts to the last path entered. Paths that do not exist stay in the field in case the user wants to will them into existence

Bug Fixes

• Fixed Audio File Objects not making use of the "starting pitch" parameter
• Fixed Audio File Object names not properly updating in the inspector immediately after being changed
• Fixed a layout group error being thrown when cancelling an Audio Object's creation

More Bug Fixes

Been quite busy lately so not many new features just yet

Bug Fixes

• Fixed AudioPlayers displaying an error in the inspector when such an error doesn't exist
• Fixed AudioPlayerMusic components retaining deprecated logic

Some Bug Fixes

Bug Fixes

• Fixed helper components displacing their audio references when elements in the audio library change
• Fixed renaming Audio File Objects not updating the inspector details immediately
• Fixed enum generation allowing letters in the first position of a enum name