You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
320 lines
18 KiB
320 lines
18 KiB
using Discord.Rest;
|
|
using System;
|
|
using System.Collections.Generic;
|
|
using System.Collections.Immutable;
|
|
using System.Diagnostics;
|
|
using System.IO;
|
|
using System.Linq;
|
|
using System.Threading.Tasks;
|
|
using Model = Discord.API.Channel;
|
|
|
|
namespace Discord.WebSocket
|
|
{
|
|
/// <summary>
|
|
/// Represents a WebSocket-based channel in a guild that can send and receive messages.
|
|
/// </summary>
|
|
[DebuggerDisplay(@"{DebuggerDisplay,nq}")]
|
|
public class SocketTextChannel : SocketGuildChannel, ITextChannel, ISocketMessageChannel
|
|
{
|
|
private readonly MessageCache _messages;
|
|
|
|
/// <inheritdoc />
|
|
public string Topic { get; private set; }
|
|
/// <inheritdoc />
|
|
public virtual int SlowModeInterval { get; private set; }
|
|
/// <inheritdoc />
|
|
public ulong? CategoryId { get; private set; }
|
|
/// <summary>
|
|
/// Gets the parent (category) of this channel in the guild's channel list.
|
|
/// </summary>
|
|
/// <returns>
|
|
/// An <see cref="ICategoryChannel"/> representing the parent of this channel; <c>null</c> if none is set.
|
|
/// </returns>
|
|
public ICategoryChannel Category
|
|
=> CategoryId.HasValue ? Guild.GetChannel(CategoryId.Value) as ICategoryChannel : null;
|
|
/// <inheritdoc />
|
|
public virtual Task SyncPermissionsAsync(RequestOptions options = null)
|
|
=> ChannelHelper.SyncPermissionsAsync(this, Discord, options);
|
|
|
|
private bool _nsfw;
|
|
/// <inheritdoc />
|
|
public bool IsNsfw => _nsfw;
|
|
|
|
/// <inheritdoc />
|
|
public string Mention => MentionUtils.MentionChannel(Id);
|
|
/// <inheritdoc />
|
|
public IReadOnlyCollection<SocketMessage> CachedMessages => _messages?.Messages ?? ImmutableArray.Create<SocketMessage>();
|
|
/// <inheritdoc />
|
|
public override IReadOnlyCollection<SocketGuildUser> Users
|
|
=> Guild.Users.Where(x => Permissions.GetValue(
|
|
Permissions.ResolveChannel(Guild, x, this, Permissions.ResolveGuild(Guild, x)),
|
|
ChannelPermission.ViewChannel)).ToImmutableArray();
|
|
|
|
internal SocketTextChannel(DiscordSocketClient discord, ulong id, SocketGuild guild)
|
|
: base(discord, id, guild)
|
|
{
|
|
if (Discord.MessageCacheSize > 0)
|
|
_messages = new MessageCache(Discord);
|
|
}
|
|
internal new static SocketTextChannel Create(SocketGuild guild, ClientState state, Model model)
|
|
{
|
|
var entity = new SocketTextChannel(guild.Discord, model.Id, guild);
|
|
entity.Update(state, model);
|
|
return entity;
|
|
}
|
|
internal override void Update(ClientState state, Model model)
|
|
{
|
|
base.Update(state, model);
|
|
CategoryId = model.CategoryId;
|
|
Topic = model.Topic.Value;
|
|
SlowModeInterval = model.SlowMode.GetValueOrDefault(); // some guilds haven't been patched to include this yet?
|
|
_nsfw = model.Nsfw.GetValueOrDefault();
|
|
}
|
|
|
|
/// <inheritdoc />
|
|
public Task ModifyAsync(Action<TextChannelProperties> func, RequestOptions options = null)
|
|
=> ChannelHelper.ModifyAsync(this, Discord, func, options);
|
|
|
|
//Messages
|
|
/// <inheritdoc />
|
|
public SocketMessage GetCachedMessage(ulong id)
|
|
=> _messages?.Get(id);
|
|
/// <summary>
|
|
/// Gets a message from this message channel.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// This method follows the same behavior as described in <see cref="IMessageChannel.GetMessageAsync"/>.
|
|
/// Please visit its documentation for more details on this method.
|
|
/// </remarks>
|
|
/// <param name="id">The snowflake identifier of the message.</param>
|
|
/// <param name="options">The options to be used when sending the request.</param>
|
|
/// <returns>
|
|
/// A task that represents an asynchronous get operation for retrieving the message. The task result contains
|
|
/// the retrieved message; <c>null</c> if no message is found with the specified identifier.
|
|
/// </returns>
|
|
public async Task<IMessage> GetMessageAsync(ulong id, RequestOptions options = null)
|
|
{
|
|
IMessage msg = _messages?.Get(id);
|
|
if (msg == null)
|
|
msg = await ChannelHelper.GetMessageAsync(this, Discord, id, options).ConfigureAwait(false);
|
|
return msg;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the last N messages from this message channel.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// This method follows the same behavior as described in <see cref="IMessageChannel.GetMessagesAsync(int, CacheMode, RequestOptions)"/>.
|
|
/// Please visit its documentation for more details on this method.
|
|
/// </remarks>
|
|
/// <param name="limit">The numbers of message to be gotten from.</param>
|
|
/// <param name="options">The options to be used when sending the request.</param>
|
|
/// <returns>
|
|
/// Paged collection of messages.
|
|
/// </returns>
|
|
public IAsyncEnumerable<IReadOnlyCollection<IMessage>> GetMessagesAsync(int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
|
|
=> SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, null, Direction.Before, limit, CacheMode.AllowDownload, options);
|
|
/// <summary>
|
|
/// Gets a collection of messages in this channel.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// This method follows the same behavior as described in <see cref="IMessageChannel.GetMessagesAsync(ulong, Direction, int, CacheMode, RequestOptions)"/>.
|
|
/// Please visit its documentation for more details on this method.
|
|
/// </remarks>
|
|
/// <param name="fromMessageId">The ID of the starting message to get the messages from.</param>
|
|
/// <param name="dir">The direction of the messages to be gotten from.</param>
|
|
/// <param name="limit">The numbers of message to be gotten from.</param>
|
|
/// <param name="options">The options to be used when sending the request.</param>
|
|
/// <returns>
|
|
/// Paged collection of messages.
|
|
/// </returns>
|
|
public IAsyncEnumerable<IReadOnlyCollection<IMessage>> GetMessagesAsync(ulong fromMessageId, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
|
|
=> SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, fromMessageId, dir, limit, CacheMode.AllowDownload, options);
|
|
/// <summary>
|
|
/// Gets a collection of messages in this channel.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// This method follows the same behavior as described in <see cref="IMessageChannel.GetMessagesAsync(IMessage, Direction, int, CacheMode, RequestOptions)"/>.
|
|
/// Please visit its documentation for more details on this method.
|
|
/// </remarks>
|
|
/// <param name="fromMessage">The starting message to get the messages from.</param>
|
|
/// <param name="dir">The direction of the messages to be gotten from.</param>
|
|
/// <param name="limit">The numbers of message to be gotten from.</param>
|
|
/// <param name="options">The options to be used when sending the request.</param>
|
|
/// <returns>
|
|
/// Paged collection of messages.
|
|
/// </returns>
|
|
public IAsyncEnumerable<IReadOnlyCollection<IMessage>> GetMessagesAsync(IMessage fromMessage, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch, RequestOptions options = null)
|
|
=> SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, fromMessage.Id, dir, limit, CacheMode.AllowDownload, options);
|
|
/// <inheritdoc />
|
|
public IReadOnlyCollection<SocketMessage> GetCachedMessages(int limit = DiscordConfig.MaxMessagesPerBatch)
|
|
=> SocketChannelHelper.GetCachedMessages(this, Discord, _messages, null, Direction.Before, limit);
|
|
/// <inheritdoc />
|
|
public IReadOnlyCollection<SocketMessage> GetCachedMessages(ulong fromMessageId, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch)
|
|
=> SocketChannelHelper.GetCachedMessages(this, Discord, _messages, fromMessageId, dir, limit);
|
|
/// <inheritdoc />
|
|
public IReadOnlyCollection<SocketMessage> GetCachedMessages(IMessage fromMessage, Direction dir, int limit = DiscordConfig.MaxMessagesPerBatch)
|
|
=> SocketChannelHelper.GetCachedMessages(this, Discord, _messages, fromMessage.Id, dir, limit);
|
|
/// <inheritdoc />
|
|
public Task<IReadOnlyCollection<RestMessage>> GetPinnedMessagesAsync(RequestOptions options = null)
|
|
=> ChannelHelper.GetPinnedMessagesAsync(this, Discord, options);
|
|
|
|
/// <inheritdoc />
|
|
/// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
|
|
public Task<RestUserMessage> SendMessageAsync(string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null)
|
|
=> ChannelHelper.SendMessageAsync(this, Discord, text, isTTS, embed, options);
|
|
|
|
/// <inheritdoc />
|
|
public Task<RestUserMessage> SendFileAsync(string filePath, string text, bool isTTS = false, Embed embed = null, RequestOptions options = null, bool isSpoiler = false)
|
|
=> ChannelHelper.SendFileAsync(this, Discord, filePath, text, isTTS, embed, options, isSpoiler);
|
|
|
|
/// <inheritdoc />
|
|
/// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception>
|
|
public Task<RestUserMessage> SendFileAsync(Stream stream, string filename, string text, bool isTTS = false, Embed embed = null, RequestOptions options = null, bool isSpoiler = false)
|
|
=> ChannelHelper.SendFileAsync(this, Discord, stream, filename, text, isTTS, embed, options, isSpoiler);
|
|
|
|
/// <inheritdoc />
|
|
public Task DeleteMessagesAsync(IEnumerable<IMessage> messages, RequestOptions options = null)
|
|
=> ChannelHelper.DeleteMessagesAsync(this, Discord, messages.Select(x => x.Id), options);
|
|
/// <inheritdoc />
|
|
public Task DeleteMessagesAsync(IEnumerable<ulong> messageIds, RequestOptions options = null)
|
|
=> ChannelHelper.DeleteMessagesAsync(this, Discord, messageIds, options);
|
|
|
|
/// <inheritdoc />
|
|
public Task DeleteMessageAsync(ulong messageId, RequestOptions options = null)
|
|
=> ChannelHelper.DeleteMessageAsync(this, messageId, Discord, options);
|
|
/// <inheritdoc />
|
|
public Task DeleteMessageAsync(IMessage message, RequestOptions options = null)
|
|
=> ChannelHelper.DeleteMessageAsync(this, message.Id, Discord, options);
|
|
|
|
/// <inheritdoc />
|
|
public Task TriggerTypingAsync(RequestOptions options = null)
|
|
=> ChannelHelper.TriggerTypingAsync(this, Discord, options);
|
|
/// <inheritdoc />
|
|
public IDisposable EnterTypingState(RequestOptions options = null)
|
|
=> ChannelHelper.EnterTypingState(this, Discord, options);
|
|
|
|
internal void AddMessage(SocketMessage msg)
|
|
=> _messages?.Add(msg);
|
|
internal SocketMessage RemoveMessage(ulong id)
|
|
=> _messages?.Remove(id);
|
|
|
|
//Users
|
|
/// <inheritdoc />
|
|
public override SocketGuildUser GetUser(ulong id)
|
|
{
|
|
var user = Guild.GetUser(id);
|
|
if (user != null)
|
|
{
|
|
var guildPerms = Permissions.ResolveGuild(Guild, user);
|
|
var channelPerms = Permissions.ResolveChannel(Guild, user, this, guildPerms);
|
|
if (Permissions.GetValue(channelPerms, ChannelPermission.ViewChannel))
|
|
return user;
|
|
}
|
|
return null;
|
|
}
|
|
|
|
//Webhooks
|
|
/// <summary>
|
|
/// Creates a webhook in this text channel.
|
|
/// </summary>
|
|
/// <param name="name">The name of the webhook.</param>
|
|
/// <param name="avatar">The avatar of the webhook.</param>
|
|
/// <param name="options">The options to be used when sending the request.</param>
|
|
/// <returns>
|
|
/// A task that represents the asynchronous creation operation. The task result contains the newly created
|
|
/// webhook.
|
|
/// </returns>
|
|
public Task<RestWebhook> CreateWebhookAsync(string name, Stream avatar = null, RequestOptions options = null)
|
|
=> ChannelHelper.CreateWebhookAsync(this, Discord, name, avatar, options);
|
|
/// <summary>
|
|
/// Gets a webhook available in this text channel.
|
|
/// </summary>
|
|
/// <param name="id">The identifier of the webhook.</param>
|
|
/// <param name="options">The options to be used when sending the request.</param>
|
|
/// <returns>
|
|
/// A task that represents the asynchronous get operation. The task result contains a webhook associated
|
|
/// with the identifier; <c>null</c> if the webhook is not found.
|
|
/// </returns>
|
|
public Task<RestWebhook> GetWebhookAsync(ulong id, RequestOptions options = null)
|
|
=> ChannelHelper.GetWebhookAsync(this, Discord, id, options);
|
|
/// <summary>
|
|
/// Gets the webhooks available in this text channel.
|
|
/// </summary>
|
|
/// <param name="options">The options to be used when sending the request.</param>
|
|
/// <returns>
|
|
/// A task that represents the asynchronous get operation. The task result contains a read-only collection
|
|
/// of webhooks that is available in this channel.
|
|
/// </returns>
|
|
public Task<IReadOnlyCollection<RestWebhook>> GetWebhooksAsync(RequestOptions options = null)
|
|
=> ChannelHelper.GetWebhooksAsync(this, Discord, options);
|
|
|
|
//Invites
|
|
/// <inheritdoc />
|
|
public async Task<IInviteMetadata> CreateInviteAsync(int? maxAge = 86400, int? maxUses = null, bool isTemporary = false, bool isUnique = false, RequestOptions options = null)
|
|
=> await ChannelHelper.CreateInviteAsync(this, Discord, maxAge, maxUses, isTemporary, isUnique, options).ConfigureAwait(false);
|
|
/// <inheritdoc />
|
|
public async Task<IReadOnlyCollection<IInviteMetadata>> GetInvitesAsync(RequestOptions options = null)
|
|
=> await ChannelHelper.GetInvitesAsync(this, Discord, options).ConfigureAwait(false);
|
|
|
|
private string DebuggerDisplay => $"{Name} ({Id}, Text)";
|
|
internal new SocketTextChannel Clone() => MemberwiseClone() as SocketTextChannel;
|
|
|
|
//ITextChannel
|
|
/// <inheritdoc />
|
|
async Task<IWebhook> ITextChannel.CreateWebhookAsync(string name, Stream avatar, RequestOptions options)
|
|
=> await CreateWebhookAsync(name, avatar, options).ConfigureAwait(false);
|
|
/// <inheritdoc />
|
|
async Task<IWebhook> ITextChannel.GetWebhookAsync(ulong id, RequestOptions options)
|
|
=> await GetWebhookAsync(id, options).ConfigureAwait(false);
|
|
/// <inheritdoc />
|
|
async Task<IReadOnlyCollection<IWebhook>> ITextChannel.GetWebhooksAsync(RequestOptions options)
|
|
=> await GetWebhooksAsync(options).ConfigureAwait(false);
|
|
|
|
//IGuildChannel
|
|
/// <inheritdoc />
|
|
Task<IGuildUser> IGuildChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
|
|
=> Task.FromResult<IGuildUser>(GetUser(id));
|
|
/// <inheritdoc />
|
|
IAsyncEnumerable<IReadOnlyCollection<IGuildUser>> IGuildChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
|
|
=> ImmutableArray.Create<IReadOnlyCollection<IGuildUser>>(Users).ToAsyncEnumerable();
|
|
|
|
//IMessageChannel
|
|
/// <inheritdoc />
|
|
async Task<IMessage> IMessageChannel.GetMessageAsync(ulong id, CacheMode mode, RequestOptions options)
|
|
{
|
|
if (mode == CacheMode.AllowDownload)
|
|
return await GetMessageAsync(id, options).ConfigureAwait(false);
|
|
else
|
|
return GetCachedMessage(id);
|
|
}
|
|
/// <inheritdoc />
|
|
IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(int limit, CacheMode mode, RequestOptions options)
|
|
=> SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, null, Direction.Before, limit, mode, options);
|
|
/// <inheritdoc />
|
|
IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(ulong fromMessageId, Direction dir, int limit, CacheMode mode, RequestOptions options)
|
|
=> SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, fromMessageId, dir, limit, mode, options);
|
|
/// <inheritdoc />
|
|
IAsyncEnumerable<IReadOnlyCollection<IMessage>> IMessageChannel.GetMessagesAsync(IMessage fromMessage, Direction dir, int limit, CacheMode mode, RequestOptions options)
|
|
=> SocketChannelHelper.GetMessagesAsync(this, Discord, _messages, fromMessage.Id, dir, limit, mode, options);
|
|
/// <inheritdoc />
|
|
async Task<IReadOnlyCollection<IMessage>> IMessageChannel.GetPinnedMessagesAsync(RequestOptions options)
|
|
=> await GetPinnedMessagesAsync(options).ConfigureAwait(false);
|
|
|
|
/// <inheritdoc />
|
|
async Task<IUserMessage> IMessageChannel.SendFileAsync(string filePath, string text, bool isTTS, Embed embed, RequestOptions options, bool isSpoiler)
|
|
=> await SendFileAsync(filePath, text, isTTS, embed, options, isSpoiler).ConfigureAwait(false);
|
|
/// <inheritdoc />
|
|
async Task<IUserMessage> IMessageChannel.SendFileAsync(Stream stream, string filename, string text, bool isTTS, Embed embed, RequestOptions options, bool isSpoiler)
|
|
=> await SendFileAsync(stream, filename, text, isTTS, embed, options, isSpoiler).ConfigureAwait(false);
|
|
/// <inheritdoc />
|
|
async Task<IUserMessage> IMessageChannel.SendMessageAsync(string text, bool isTTS, Embed embed, RequestOptions options)
|
|
=> await SendMessageAsync(text, isTTS, embed, options).ConfigureAwait(false);
|
|
|
|
// INestedChannel
|
|
/// <inheritdoc />
|
|
Task<ICategoryChannel> INestedChannel.GetCategoryAsync(CacheMode mode, RequestOptions options)
|
|
=> Task.FromResult(Category);
|
|
}
|
|
}
|