add - doc - Added asynchronous play/forget

---

To make BassBoom even more suitable for games and other applications,
we've made an asynchronous version of Play-n-Forget functions.

---

Type: add
Breaking: False
Doc Required: True
Backport Required: False
Part: 1/1

BassBoom.Basolia/Independent/PlayForget.cs

@@ -20,6 +20,7 @@
 using BassBoom.Basolia.File;
 using BassBoom.Basolia.Playback;
 using System.IO;
+using System.Threading.Tasks;
 
 namespace BassBoom.Basolia.Independent
 {
@@ -29,7 +30,7 @@ namespace BassBoom.Basolia.Independent
     public static class PlayForget
     {
         /// <summary>
-        /// Plays the file
+        /// Plays the file (synchronous)
         /// </summary>
         /// <param name="path">Path to a music file</param>
         /// <param name="settings">Settings of the play/forget technique</param>
@@ -46,7 +47,15 @@ public static void PlayFile(string path, PlayForgetSettings? settings = null)
         }
 
         /// <summary>
-        /// Plays the stream
+        /// Plays the file (asynchronous)
+        /// </summary>
+        /// <param name="path">Path to a music file</param>
+        /// <param name="settings">Settings of the play/forget technique</param>
+        public static async Task PlayFileAsync(string path, PlayForgetSettings? settings = null) =>
+            await Task.Run(() => PlayFile(path, settings));
+
+        /// <summary>
+        /// Plays the stream (synchronous)
         /// </summary>
         /// <param name="stream">Stream that contains valid MPEG audio stream</param>
         /// <param name="settings">Settings of the play/forget technique</param>
@@ -62,6 +71,14 @@ public static void PlayStream(Stream stream, PlayForgetSettings? settings = null
             PlayAndForget(media, settings);
         }
 
+        /// <summary>
+        /// Plays the stream (asynchronous)
+        /// </summary>
+        /// <param name="stream">Stream that contains valid MPEG audio stream</param>
+        /// <param name="settings">Settings of the play/forget technique</param>
+        public static async Task PlayStreamAsync(Stream stream, PlayForgetSettings? settings = null) =>
+            await Task.Run(() => PlayStream(stream, settings));
+
         internal static void PlayAndForget(BasoliaMedia media, PlayForgetSettings settings)
         {
             // Set the volume