add PlayOrPause support

Author: hyperblast

src/Client/IPlayerClient.cs

@@ -92,12 +92,21 @@ ValueTask<PlayerState> GetPlayerState(
     ValueTask Pause(CancellationToken cancellationToken = default);
 
     /// <summary>
-    /// Toggles pause state.
+    /// Toggles between <see cref="PlaybackState.Playing"/> and <see cref="PlaybackState.Paused"/>.
+    /// Does nothing if <see cref="PlaybackState.Stopped"/>.
     /// </summary>
     /// <param name="cancellationToken">Cancellation token.</param>
     /// <returns>Request task.</returns>
     ValueTask TogglePause(CancellationToken cancellationToken = default);
 
+    /// <summary>
+    /// Toggles between <see cref="PlaybackState.Playing"/> and <see cref="PlaybackState.Paused"/>.
+    /// Starts playback if <see cref="PlaybackState.Stopped"/>.
+    /// </summary>
+    /// <param name="cancellationToken">Cancellation token.</param>
+    /// <returns>Request task.</returns>
+    ValueTask PlayOrPause(CancellationToken cancellationToken = default);
+
     /// <summary>
     /// Updates player state.
     /// </summary>

src/Client/PlayerClient.cs

@@ -134,6 +134,12 @@ public async ValueTask TogglePause(CancellationToken cancellationToken = default
         await _handler.Post("api/player/pause/toggle", null, cancellationToken).ConfigureAwait(false);
     }
 
+    /// <inheritdoc />
+    public async ValueTask PlayOrPause(CancellationToken cancellationToken = default)
+    {
+        await _handler.Post("api/player/play-pause", null, cancellationToken).ConfigureAwait(false);
+    }
+
     /// <inheritdoc />
     public async ValueTask SetPlayerState(
         SetPlayerStateRequest request, CancellationToken cancellationToken = default)

src/CommandLineTool/Commands/PauseCommand.cs

@@ -6,37 +6,44 @@
 
 namespace Beefweb.CommandLineTool.Commands;
 
-[Command("pause", Description = "Pause playback")]
+[Command("pause", Description = "Pause or resume playback")]
 public class PauseCommand(IClientProvider clientProvider) : ServerCommandBase(clientProvider)
 {
-    [Option("-t|--toggle", Description = "Toggle pause state instead of pausing")]
+    [Option("-p|--play-pause", Description = "Toggle paused state. Start playback if stopped")]
+    public bool PlayPause { get; set; }
+
+    [Option("-t|--toggle", Description = "Toggle paused state. Do nothing if stopped")]
     public bool Toggle { get; set; }
 
-    [Option("-f|--off", Description = "Disable paused state (does nothing if not paused)")]
+    [Option("-f|--off", Description = "Disable paused state. Do nothing if not paused")]
     public bool Off { get; set; }
 
     public override async Task OnExecuteAsync(CancellationToken ct)
     {
         await base.OnExecuteAsync(ct);
 
+        if (PlayPause)
+        {
+            await Client.PlayOrPause(ct);
+            return;
+        }
+
         if (Toggle)
         {
             await Client.TogglePause(ct);
             return;
         }
 
-        if (Off)
+        if (!Off)
         {
-            var state = await Client.GetPlayerState(null, ct);
-
-            if (state.PlaybackState == PlaybackState.Paused)
-            {
-                await Client.PlayCurrent(ct);
-            }
-
+            await Client.Pause(ct);
             return;
         }
 
-        await Client.Pause(ct);
+        var state = await Client.GetPlayerState(null, ct);
+        if (state.PlaybackState == PlaybackState.Paused)
+        {
+            await Client.PlayCurrent(ct);
+        }
     }
 }