Update README.md

Bot/Handler/MusicPlayer/PlayCommand/readme.md

@@ -9,72 +9,26 @@ flowchart TD
 ```
 
 ```mermaid
-classDiagram
+sequenceDiagram
-    class PlayHandler {
+    participant User
-        -MusicEmbed _musicEmbed
+    participant Bot
-        -DiscordSocketClient _client
+    participant DiscordSocketClient
-        -IAudioService _audioService
+    participant IAudioService
-        -SocketSlashCommand _context
+    participant SocketSlashCommand
-        -const int MaxTrackDuration
+    participant LavalinkPlayer
-        -LavalinkTrack? _previousTrack
-        -static HashSet~ulong~ SubscribedGuilds
-        +PlayHandler(DiscordSocketClient client, MusicEmbed musicEmbed, IAudioService audioService)
-        +Task Handle(PlayCommand command, CancellationToken cancellationToken)
-        -void PlayMusic()
-        -Task OnTrackEnded(object sender, TrackEndedEventArgs eventargs)
-        -Task OnTrackStarted(object sender, TrackStartedEventArgs eventargs)
-        -void RegisterTrackStartedEventListerner(PlayCommand command)
-        -static Task ApplyFilters(CancellationToken cancellationToken, QueuedLavalinkPlayer player)
-        -static Task ConfigureSponsorBlock(CancellationToken cancellationToken, QueuedLavalinkPlayer player)
-    }
 
-    class PlayCommand {
+    User->>Bot: /play [song]
-        +SocketSlashCommand Message
+    Bot->>DiscordSocketClient: Get user voice channel
-    }
+    DiscordSocketClient-->>Bot: Voice channel info
-
+    Bot->>IAudioService: Get or create player
-    class TrackEndedEventArgs {
+    IAudioService-->>Bot: Player instance
-    }
+    Bot->>SocketSlashCommand: Get search query
-
+    SocketSlashCommand-->>Bot: Search query
-    class TrackStartedEventArgs {
+    Bot->>IAudioService: Load tracks
-    }
+    IAudioService-->>Bot: Track collection
-
+    Bot->>LavalinkPlayer: Play track
-    class QueuedLavalinkPlayer {
+    LavalinkPlayer-->>Bot: Track started
-        +LavalinkTrack? CurrentTrack
+    Bot->>User: Now playing embed
-        +Task PlayAsync(LavalinkTrack track, CancellationToken cancellationToken)
-        +Task Queue.AddRangeAsync(List~TrackQueueItem~ queueTracks, CancellationToken cancellationToken)
-        +Task Filters.SetFilter(NormalizationFilter normalizationFilter)
-        +Task Filters.CommitAsync(CancellationToken cancellationToken)
-        +Task UpdateSponsorBlockCategoriesAsync(ImmutableArray~SegmentCategory~ categories, CancellationToken cancellationToken)
-    }
-
-    class LavalinkTrack {
-        +string Identifier
-    }
-
-    class NormalizationFilter {
-        +NormalizationFilter(double gain, bool enabled)
-    }
-
-    class SegmentCategory {
-        +static SegmentCategory Intro
-        +static SegmentCategory Sponsor
-        +static SegmentCategory SelfPromotion
-        +static SegmentCategory Outro
-        +static SegmentCategory Filler
-    }
-
-    class TrackQueueItem {
-        +TrackQueueItem(LavalinkTrack track)
-    }
-
-    PlayHandler --> PlayCommand
-    PlayHandler --> TrackEndedEventArgs
-    PlayHandler --> TrackStartedEventArgs
-    PlayHandler --> QueuedLavalinkPlayer
-    PlayHandler --> LavalinkTrack
-    PlayHandler --> NormalizationFilter
-    PlayHandler --> SegmentCategory
-    PlayHandler --> TrackQueueItem
 ```
 
 ## Steps in the code

Bot/Handler/MusicPlayer/README.md

@@ -136,4 +136,52 @@ sequenceDiagram
     end
 ```
 
-This README provides an overview of the handlers and their responsibilities, along with class and sequence diagrams to illustrate the interactions and relationships between the components.
+## Extensions.cs
+
+#### Namespaces
+- **Discord**: Provides classes for interacting with Discord.
+- **Discord.WebSocket**: Provides WebSocket-specific classes for Discord.
+- **Lavalink4NET**: Provides classes for interacting with Lavalink.
+- **Lavalink4NET.Players**: Provides player-related classes for Lavalink.
+- **Lavalink4NET.Players.Queued**: Provides queued player-related classes for Lavalink.
+- **Microsoft.Extensions.Options**: Provides classes for handling options and configurations.
+
+#### Class: `Extensions`
+This static class contains extension methods for various Discord and Lavalink operations.
+
+##### Method: `GetPlayerAsync`
+- **Parameters**:
+  - `IAudioService audioService`: The audio service to retrieve the player from.
+  - `DiscordSocketClient client`: The Discord client.
+  - `SocketSlashCommand context`: The context of the slash command.
+  - `bool connectToVoiceChannel`: Whether to connect to the voice channel (default is true).
+- **Returns**: `ValueTask<QueuedLavalinkPlayer?>`
+- **Description**: Retrieves a `QueuedLavalinkPlayer` for the given context. If the retrieval fails, it returns null and sends an appropriate error message.
+
+##### Method: `GetGuild`
+- **Parameters**:
+  - `SocketSlashCommand message`: The slash command message.
+  - `DiscordSocketClient client`: The Discord client.
+- **Returns**: `SocketGuild`
+- **Description**: Retrieves the guild associated with the given slash command message. Throws an exception if the guild ID is null.
+
+##### Method: `GetVoiceState`
+- **Parameters**:
+  - `SocketSlashCommand message`: The slash command message.
+- **Returns**: `IVoiceState`
+- **Description**: Retrieves the voice state of the user who issued the slash command. Throws an exception if the user is not connected to a voice channel.
+
+##### Method: `RespondAsync`
+- **Parameters**:
+  - `SocketSlashCommand message`: The slash command message.
+  - `string content`: The content of the response.
+- **Returns**: `Task`
+- **Description**: Sends an ephemeral response to the slash command.
+
+##### Method: `GetOptionValueByName`
+- **Parameters**:
+  - `SocketSlashCommand command`: The slash command.
+  - `string optionName`: The name of the option to retrieve the value for.
+- **Returns**: `string`
+- **Description**: Retrieves the value of the specified option from the slash command. Returns an empty string if the option is not found.
+