[AudioIO] Add new internal API for play audio with repetitions (#6395)

* [AudioIO] Add new internal API for play audio with repetitions

diff --git a/src/Tizen.Multimedia.AudioIO/Interop/Interop.WavPlayer.cs b/src/Tizen.Multimedia.AudioIO/Interop/Interop.WavPlayer.cs
index 0712ee1c43095b4703d86b89d0ba84e4f37f8185..7c7299690e52af6744a3f99f129211432cfb49f2 100644 (file)
--- a/src/Tizen.Multimedia.AudioIO/Interop/Interop.WavPlayer.cs
+++ b/src/Tizen.Multimedia.AudioIO/Interop/Interop.WavPlayer.cs
@@ -29,6 +29,10 @@ internal static partial class Interop
         internal static extern WavPlayerError Start(string filePath, AudioStreamPolicyHandle streamInfoHandle,
             WavPlayerCompletedCallback completedCallback, IntPtr userData, out int id);
 
+        [DllImport(Libraries.WavPlayer, EntryPoint = "wav_player_start_loop")]
+        internal static extern WavPlayerError StartLoop(string filePath, AudioStreamPolicyHandle streamInfoHandle, uint count,
+            WavPlayerCompletedCallback completedCallback, IntPtr userData, out int id);
+
         [DllImport(Libraries.WavPlayer, EntryPoint = "wav_player_stop")]
         internal static extern WavPlayerError Stop(int id);
     }

diff --git a/src/Tizen.Multimedia.AudioIO/WavPlayer/WavPlayer.cs b/src/Tizen.Multimedia.AudioIO/WavPlayer/WavPlayer.cs
index 5c159d5cbffdafb2516c2fa7de5942b6340cd9cb..3dcfb24c26ed159e6264a2255d60f060ebe7e59f 100644 (file)
--- a/src/Tizen.Multimedia.AudioIO/WavPlayer/WavPlayer.cs
+++ b/src/Tizen.Multimedia.AudioIO/WavPlayer/WavPlayer.cs
@@ -15,6 +15,7 @@
  */
 
 using System;
+using System.ComponentModel;
 using System.IO;
 using System.Threading;
 using System.Threading.Tasks;
@@ -85,20 +86,62 @@ namespace Tizen.Multimedia
             }
 
             return cancellationToken.IsCancellationRequested ? Task.FromCanceled(cancellationToken) :
-                StartAsyncCore(path, streamPolicy, cancellationToken);
+                StartAsyncCore(path, streamPolicy, 1, cancellationToken);
         }
 
-        private static async Task StartAsyncCore(string path, AudioStreamPolicy streamPolicy,
+        /// <summary>
+        /// Plays a wav file based on the specified <see cref="AudioStreamPolicy"/> with given repetition number.
+        /// </summary>
+        /// <remarks>If loopCount is 0, it means infinite loops</remarks>
+        /// <returns>A task that represents the asynchronous operation.</returns>
+        /// <param name="path">A file path to play.</param>
+        /// <param name="streamPolicy">A <see cref="AudioStreamPolicy"/>.</param>
+        /// <param name="loopCount">A number of repetitions.</param>
+        /// <param name="cancellationToken">A cancellation token which can be used to stop.</param>
+        /// <exception cref="ArgumentNullException">
+        ///     <paramref name="path"/> is null.
+        ///     <para>-or-</para>
+        ///     <paramref name="streamPolicy"/> is null.
+        /// </exception>
+        /// <exception cref="InvalidOperationException">An internal error occurs.</exception>
+        /// <exception cref="FileNotFoundException"><paramref name="path"/> does not exists.</exception>
+        /// <exception cref="FileFormatException">The format of <paramref name="path"/> is not supported.</exception>
+        /// <exception cref="ObjectDisposedException"><paramref name="streamPolicy"/> has already been disposed of.</exception>
+        [EditorBrowsable(EditorBrowsableState.Never)]
+        public static Task StartAsync(string path, AudioStreamPolicy streamPolicy, uint loopCount,
+            CancellationToken cancellationToken)
+        {
+            if (path == null)
+            {
+                throw new ArgumentNullException(nameof(path));
+            }
+
+            if (streamPolicy == null)
+            {
+                throw new ArgumentNullException(nameof(streamPolicy));
+            }
+
+            if (File.Exists(path) == false)
+            {
+                throw new FileNotFoundException("File does not exists.", path);
+            }
+
+            return cancellationToken.IsCancellationRequested ? Task.FromCanceled(cancellationToken) :
+                StartAsyncCore(path, streamPolicy, loopCount, cancellationToken);
+        }
+
+        private static async Task StartAsyncCore(string path, AudioStreamPolicy streamPolicy, uint loopCount,
             CancellationToken cancellationToken)
         {
+            int id = 0;
             var tcs = new TaskCompletionSource<bool>();
 
             Native.WavPlayerCompletedCallback cb = (id_, _) => tcs.TrySetResult(true);
 
             using (var cbKeeper = ObjectKeeper.Get(cb))
             {
-                Native.Start(path, streamPolicy.Handle, cb, IntPtr.Zero, out var id).
-                    Validate("Failed to play.");
+                Native.StartLoop(path, streamPolicy.Handle, loopCount, cb, IntPtr.Zero, out id).
+                    Validate("Failed to play with loop.");
 
                 using (RegisterCancellationAction(tcs, cancellationToken, id))
                 {