Retrieve tags from Bass tracks when available

osu.Framework.Tests/Audio/TrackBassTest.cs

@@ -432,6 +432,19 @@ public void TestCurrentTimeUpdatedAfterInlineSeek()
             Assert.That(track.CurrentTime, Is.EqualTo(20000).Within(100));
         }
 
+        [Test]
+        public void TestTagReader()
+        {
+            var tags = track.Tags;
+
+            Assert.That(tags, Is.Not.Null);
+            Assert.That(tags.Artist, Is.EqualTo("osu-framework"));
+            Assert.That(tags.Album, Is.EqualTo("osu-framework"));
+            Assert.That(tags.Genre, Is.EqualTo("tunes"));
+            Assert.That(tags.Year, Is.EqualTo(2008));
+            Assert.That(tags.Title, Is.EqualTo("sample-track"));
+        }
+
         private void takeEffectsAndUpdateAfter(int after)
         {
             bass.Update();

osu.Framework/Audio/Track/ITrack.cs

@@ -46,6 +46,11 @@ public interface ITrack : IAdjustableClock, IHasAmplitudes, IAdjustableAudioComp
         /// </summary>
         int? Bitrate { get; }
 
+        /// <summary>
+        /// The ID3 tags contained in this track's metadata.
+        /// </summary>
+        Tags? Tags { get; }
+
         /// <summary>
         /// Whether this track is reversed.
         /// </summary>

osu.Framework/Audio/Track/Tags.cs

@@ -0,0 +1,21 @@
+// Copyright (c) ppy Pty Ltd <[email protected]>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+namespace osu.Framework.Audio.Track
+{
+    /// <summary>
+    /// A container for audio track metadata.
+    /// </summary>
+    public class Tags
+    {
+        public string? Title { get; set; }
+
+        public string? Artist { get; set; }
+
+        public string? Album { get; set; }
+
+        public int? Year { get; set; }
+
+        public string? Genre { get; set; }
+    }
+}

osu.Framework/Audio/Track/Track.cs

@@ -23,6 +23,8 @@ public abstract class Track : AdjustableAudioComponent, ITrack, IAudioChannel
 
         public virtual bool Looping { get; set; }
 
+        public Tags? Tags => GetTags();
+
         public string Name { get; }
 
         protected Track(string name)
@@ -119,6 +121,8 @@ public virtual double Rate
 
         public virtual ChannelAmplitudes CurrentAmplitudes { get; } = ChannelAmplitudes.Empty;
 
+        protected virtual Tags? GetTags() => null;
+
         protected override void UpdateState()
         {
             FrameStatistics.Increment(StatisticsCounterType.Tracks);

osu.Framework/Audio/Track/TrackBass.cs

@@ -303,6 +303,30 @@ public override async Task<bool> SeekAsync(double seek)
             return conservativeClamped == seek;
         }
 
+        protected override Tags? GetTags()
+        {
+            var tags = TagReader.Read(activeStream);
+
+            if (tags == null)
+                return null;
+
+            var parsed = new Tags
+            {
+                Artist = tags.Artist?.Trim()!,
+                Title = tags.Title,
+                Album = tags.Album,
+                Genre = tags.Genre,
+            };
+
+            if (string.IsNullOrEmpty(parsed.Artist))
+                parsed.Artist = tags.AlbumArtist;
+
+            if (int.TryParse(tags.Year, out int year))
+                parsed.Year = year;
+
+            return parsed;
+        }
+
         private void seekInternal(double seek)
         {
             double clamped = Math.Clamp(seek, 0, Length);

osu.Framework/Graphics/Audio/DrawableTrack.cs

@@ -69,6 +69,7 @@ public double Length
         }
 
         public int? Bitrate => track.Bitrate;
+        public Tags? Tags => track.Tags;
 
         public bool IsRunning => track.IsRunning;