AudioLink 1.0.0

[pema99]

1.0.0 - September 29th, 2023

New features

• Added a new AudioLink Controller, with a completely revamped design. The old controller is still included, if you don't want to change. (Thanks to everyone who helped, including Pema, Lea, Teeh, Sacred, TechAnon and more)
• Added automatic gain adjustment. It's enabled by default, but you can disable it on the AudioLink controller. (Thanks, cnlohr)
• Added Async GPU Readback, you can toggle it on the AudioLink prefab. This means you can read data from AudioLink in Udon, without having to pay a heavy performance penalty! Note that this feature only works on PC. Quest (and other mobile platforms) will continue to use the old slow synchronous readbacks, which we advise against.
• Added a new C# API for reading audio data in Udon, to better accomodate the new Async Readbacks.
• Added Media Playback States, which provide information about the currently playing track. (See Docs). (Thanks, fundale)
• Added Media States Udon API VideoPlayer API, to control the aforementioned Playback States. (Thanks, fundale)
• Added an AudioLink prefab for ChilloutVR.

Changes

• We have switched to using Semantic Versioning, marking this release as 1.0.0. This may break shaders written for very old versions of AudioLink. The version will now read as 1.00f to AudioLink shaders.
• The "VRCAudioLink" namespace has been renamed to "AudioLink". This is a breaking change. We've added a new scripting define, AUDIOLINK_V1, which will be present for future versions of AudioLink, to aid with backwards compatability.
• Removed the dependency on the VPM package resolver.

Improvements

• Made yt-dlp integration resolve URLs asynchronously.
• Improved the yt-dlp integration UI in a number of ways. (Thanks, rRazgriz)
• Improved the "Add Audiolink Prefab to Scene" button.
• Improved logging, with less meaningless warning spam.
• Cache the local player in AudioLink scripts for slightly improved performance. (Thanks, Nessie)
• Fixed null reference exceptions being fired when a player leaves the world. (Thanks, Nessie)
• Fixed an issue where theme colors would reset to the defaults on world start (Theme Colors and Mode Revert to Default at Runtime llealloo/audiolink#281).

[pema99]

I noticed a few minor cosmetic issues. I intend to amend the release with a hotfix today.

[pema99]

Alright, I've amended the release with the changes I wanted. Should be good to go now 👍

[momo-the-monster]

Reviewed internally, no new concerns - thanks!