Adding Entity guides, flowcharts, better sample system. (#2054)

* initial * Interaction glossary entry * Sharded Interaction sample * Renames into solution * Debugging samples * Modify target location for webhookclient * Finalizing docs work, resolving docfx errors. * Adding threaduser to user chart * Add branch info to readme. * Edits to user chart * Resolve format for glossary entries * Patch sln target * Issue with file naming fixed * Patch 1/x for builds * Appending suggestions
2022-01-27 14:50:49 +01:00
parent b0f59e3eb9
commit b14af1c008
57 changed files with 1059 additions and 344 deletions
--- a/samples/ShardedClient/Services/CommandHandlingService.cs
+++ b/samples/ShardedClient/Services/CommandHandlingService.cs
@@ -0,0 +1,72 @@
+using Discord;
+using Discord.Commands;
+using Discord.WebSocket;
+using Microsoft.Extensions.DependencyInjection;
+using System;
+using System.Reflection;
+using System.Threading.Tasks;
+
+namespace ShardedClient.Services
+{
+    public class CommandHandlingService
+    {
+        private readonly CommandService _commands;
+        private readonly DiscordShardedClient _discord;
+        private readonly IServiceProvider _services;
+
+        public CommandHandlingService(IServiceProvider services)
+        {
+            _commands = services.GetRequiredService<CommandService>();
+            _discord = services.GetRequiredService<DiscordShardedClient>();
+            _services = services;
+
+            _commands.CommandExecuted += CommandExecutedAsync;
+            _commands.Log += LogAsync;
+            _discord.MessageReceived += MessageReceivedAsync;
+        }
+
+        public async Task InitializeAsync()
+        {
+            await _commands.AddModulesAsync(Assembly.GetEntryAssembly(), _services);
+        }
+
+        public async Task MessageReceivedAsync(SocketMessage rawMessage)
+        {
+            // Ignore system messages, or messages from other bots
+            if (rawMessage is not SocketUserMessage message)
+                return;
+            if (message.Source != MessageSource.User)
+                return;
+
+            // This value holds the offset where the prefix ends
+            var argPos = 0;
+            if (!message.HasMentionPrefix(_discord.CurrentUser, ref argPos))
+                return;
+
+            // A new kind of command context, ShardedCommandContext can be utilized with the commands framework
+            var context = new ShardedCommandContext(_discord, message);
+            await _commands.ExecuteAsync(context, argPos, _services);
+        }
+
+        public async Task CommandExecutedAsync(Optional<CommandInfo> command, ICommandContext context, IResult result)
+        {
+            // command is unspecified when there was a search failure (command not found); we don't care about these errors
+            if (!command.IsSpecified)
+                return;
+
+            // the command was successful, we don't care about this result, unless we want to log that a command succeeded.
+            if (result.IsSuccess)
+                return;
+
+            // the command failed, let's notify the user that something happened.
+            await context.Channel.SendMessageAsync($"error: {result}");
+        }
+
+        private Task LogAsync(LogMessage log)
+        {
+            Console.WriteLine(log.ToString());
+
+            return Task.CompletedTask;
+        }
+    }
+}
--- a/samples/ShardedClient/Services/InteractionHandlingService.cs
+++ b/samples/ShardedClient/Services/InteractionHandlingService.cs
@@ -0,0 +1,57 @@
+using Discord;
+using Discord.Interactions;
+using Discord.WebSocket;
+using Microsoft.Extensions.DependencyInjection;
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+
+namespace ShardedClient.Services
+{
+    public class InteractionHandlingService
+    {
+        private readonly InteractionService _service;
+        private readonly DiscordShardedClient _client;
+        private readonly IServiceProvider _provider;
+
+        public InteractionHandlingService(IServiceProvider services)
+        {
+            _service = services.GetRequiredService<InteractionService>();
+            _client = services.GetRequiredService<DiscordShardedClient>();
+            _provider = services;
+
+            _service.Log += LogAsync;
+            _client.InteractionCreated += OnInteractionAsync;
+            // For examples on how to handle post execution,
+            // see the InteractionFramework samples.
+        }
+
+        // Register all modules, and add the commands from these modules to either guild or globally depending on the build state.
+        public async Task InitializeAsync()
+        {
+            await _service.AddModulesAsync(typeof(InteractionHandlingService).Assembly, _provider);
+#if DEBUG
+            await _service.AddCommandsToGuildAsync(_client.Guilds.First(x => x.Id == 1));
+#else
+            await _service.AddCommandsGloballyAsync();
+#endif
+        }
+
+        private async Task OnInteractionAsync(SocketInteraction interaction)
+        {
+            _ = Task.Run(async () =>
+            {
+                var context = new ShardedInteractionContext(_client, interaction);
+                await _service.ExecuteCommandAsync(context, _provider);
+            });
+            await Task.CompletedTask;
+        }
+
+        private Task LogAsync(LogMessage log)
+        {
+            Console.WriteLine(log.ToString());
+
+            return Task.CompletedTask;
+        }
+    }
+}