Class DiscordShardedClient

Inheritance
Object
BaseDiscordClient
BaseSocketClient
DiscordShardedClient
Implements
IDisposable
IAsyncDisposable
Inherited Members
Namespace: Discord.WebSocket
Assembly: Discord.Net.WebSocket.dll
Syntax
public class DiscordShardedClient : BaseSocketClient, IDiscordClient, IDisposable, IAsyncDisposable

Constructors

| Improve this Doc View Source

DiscordShardedClient()

Creates a new REST/WebSocket Discord client.

Declaration
public DiscordShardedClient()
| Improve this Doc View Source

DiscordShardedClient(DiscordSocketConfig)

Creates a new REST/WebSocket Discord client.

Declaration
public DiscordShardedClient(DiscordSocketConfig config)
Parameters
Type Name Description
DiscordSocketConfig config
| Improve this Doc View Source

DiscordShardedClient(Int32[])

Creates a new REST/WebSocket Discord client.

Declaration
public DiscordShardedClient(int[] ids)
Parameters
Type Name Description
Int32[] ids
| Improve this Doc View Source

DiscordShardedClient(Int32[], DiscordSocketConfig)

Creates a new REST/WebSocket Discord client.

Declaration
public DiscordShardedClient(int[] ids, DiscordSocketConfig config)
Parameters
Type Name Description
Int32[] ids
DiscordSocketConfig config

Properties

| Improve this Doc View Source

Activity

Gets the activity for the logged-in user.

Declaration
public override IActivity Activity { get; protected set; }
Property Value
Type Description
IActivity

An activity object that represents the user's current activity.
Overrides
| Improve this Doc View Source

CurrentUser

Declaration
public override SocketSelfUser CurrentUser { get; protected set; }
Property Value
Type Description
SocketSelfUser
Overrides
| Improve this Doc View Source

DefaultStickerPacks

Gets a collection of default stickers.

Declaration
public override IReadOnlyCollection<StickerPack<SocketSticker>> DefaultStickerPacks { get; }
Property Value
Type Description
IReadOnlyCollection<StickerPack<SocketSticker>>
Overrides
| Improve this Doc View Source

Guilds

Gets a collection of guilds that the user is currently in.

Declaration
public override IReadOnlyCollection<SocketGuild> Guilds { get; }
Property Value
Type Description
IReadOnlyCollection<SocketGuild>

A read-only collection of guilds that the current user is in.
Overrides
| Improve this Doc View Source

Latency

Gets the estimated round-trip latency, in milliseconds, to the gateway server.

Declaration
public override int Latency { get; protected set; }
Property Value
Type Description
Int32

An that represents the round-trip latency to the WebSocket server. Please note that this value does not represent a "true" latency for operations such as sending a message.
Overrides
| Improve this Doc View Source

PrivateChannels

Gets a collection of private channels opened in this session.

Declaration
public override IReadOnlyCollection<ISocketPrivateChannel> PrivateChannels { get; }
Property Value
Type Description
IReadOnlyCollection<ISocketPrivateChannel>

A read-only collection of private channels that the user currently partakes in.
Overrides
Remarks

This method will retrieve all private channels (including direct-message, group channel and such) that are currently opened in this session.

warning

This method will not return previously opened private channels outside of the current session! If you have just started the client, this may return an empty collection.

| Improve this Doc View Source

Rest

Provides access to a REST-only client with a shared state from this client.

Declaration
public override DiscordSocketRestClient Rest { get; }
Property Value
Type Description
DiscordSocketRestClient
Overrides
| Improve this Doc View Source

Shards

Declaration
public IReadOnlyCollection<DiscordSocketClient> Shards { get; }
Property Value
Type Description
IReadOnlyCollection<DiscordSocketClient>
| Improve this Doc View Source

Status

Gets the status for the logged-in user.

Declaration
public override UserStatus Status { get; protected set; }
Property Value
Type Description
UserStatus

A status object that represents the user's online presence status.
Overrides

Methods

| Improve this Doc View Source

DownloadUsersAsync(IEnumerable<IGuild>)

Attempts to download users into the user cache for the selected guilds.

Declaration
public override async Task DownloadUsersAsync(IEnumerable<IGuild> guilds)
Parameters
Type Name Description
IEnumerable<IGuild> guilds

The guilds to download the members from.
Returns
Type Description
Task

A task that represents the asynchronous download operation.
Overrides
| Improve this Doc View Source

GetApplicationInfoAsync(RequestOptions)

Gets a Discord application information for the logged-in user.

Declaration
public override async Task<RestApplication> GetApplicationInfoAsync(RequestOptions options = null)
Parameters
Type Name Description
RequestOptions options

The options to be used when sending the request.
Returns
Type Description
Task<RestApplication>

A task that represents the asynchronous get operation. The task result contains the application information.
Overrides
Remarks

This method reflects your application information you submitted when creating a Discord application via the Developer Portal.

| Improve this Doc View Source

GetChannel(UInt64)

Gets a channel.

Declaration
public override SocketChannel GetChannel(ulong id)
Parameters
Type Name Description
UInt64 id

The snowflake identifier of the channel (e.g. 381889909113225237).
Returns
Type Description
SocketChannel

A generic WebSocket-based channel object (voice, text, category, etc.) associated with the identifier; null when the channel cannot be found.
Overrides
| Improve this Doc View Source

GetGuild(UInt64)

Gets a guild.

Declaration
public override SocketGuild GetGuild(ulong id)
Parameters
Type Name Description
UInt64 id

The guild snowflake identifier.
Returns
Type Description
SocketGuild

A WebSocket-based guild associated with the snowflake identifier; null when the guild cannot be found.
Overrides
| Improve this Doc View Source

GetShard(Int32)

Declaration
public DiscordSocketClient GetShard(int id)
Parameters
Type Name Description
Int32 id
Returns
Type Description
DiscordSocketClient
| Improve this Doc View Source

GetShardFor(IGuild)

Declaration
public DiscordSocketClient GetShardFor(IGuild guild)
Parameters
Type Name Description
IGuild guild
Returns
Type Description
DiscordSocketClient
| Improve this Doc View Source

GetShardIdFor(IGuild)

Declaration
public int GetShardIdFor(IGuild guild)
Parameters
Type Name Description
IGuild guild
Returns
Type Description
Int32
| Improve this Doc View Source

GetStickerAsync(UInt64, CacheMode, RequestOptions)

Gets a sticker.

Declaration
public override async Task<SocketSticker> GetStickerAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null)
Parameters
Type Name Description
UInt64 id

The id of the sticker to get.
CacheMode mode

Whether or not to allow downloading from the api.
RequestOptions options

The options to be used when sending the request.
Returns
Type Description
Task<SocketSticker>

A SocketSticker if found, otherwise null.
Overrides
| Improve this Doc View Source

GetUser(String, String)

Gets a user.

Declaration
public override SocketUser GetUser(string username, string discriminator = null)
Parameters
Type Name Description
String username

The name of the user.
String discriminator

The discriminator value of the user.
Returns
Type Description
SocketUser

A generic WebSocket-based user; null when the user cannot be found.
Overrides
Remarks

This method gets the user present in the WebSocket cache with the given condition.

warning

Sometimes a user may return null due to Discord not sending offline users in large guilds (i.e. guild with 100+ members) actively. To download users on startup and to see more information about this subject, see AlwaysDownloadUsers.

note

This method does not attempt to fetch users that the logged-in user does not have access to (i.e. users who don't share mutual guild(s) with the current user). If you wish to get a user that you do not have access to, consider using the REST implementation of .

| Improve this Doc View Source

GetUser(UInt64)

Gets a generic user.

Declaration
public override SocketUser GetUser(ulong id)
Parameters
Type Name Description
UInt64 id

The user snowflake ID.
Returns
Type Description
SocketUser

A generic WebSocket-based user; null when the user cannot be found.
Overrides
Remarks

This method gets the user present in the WebSocket cache with the given condition.

warning

Sometimes a user may return null due to Discord not sending offline users in large guilds (i.e. guild with 100+ members) actively. To download users on startup and to see more information about this subject, see AlwaysDownloadUsers.

note

This method does not attempt to fetch users that the logged-in user does not have access to (i.e. users who don't share mutual guild(s) with the current user). If you wish to get a user that you do not have access to, consider using the REST implementation of .

| Improve this Doc View Source

GetVoiceRegionAsync(String, RequestOptions)

Gets a voice region.

Declaration
public override async ValueTask<RestVoiceRegion> GetVoiceRegionAsync(string id, RequestOptions options = null)
Parameters
Type Name Description
String id

The identifier of the voice region (e.g. eu-central ).
RequestOptions options

The options to be used when sending the request.
Returns
Type Description
ValueTask<RestVoiceRegion>

A task that contains a REST-based voice region associated with the identifier; null if the voice region is not found.
Overrides
| Improve this Doc View Source

GetVoiceRegionsAsync(RequestOptions)

Gets all voice regions.

Declaration
public override async ValueTask<IReadOnlyCollection<RestVoiceRegion>> GetVoiceRegionsAsync(RequestOptions options = null)
Parameters
Type Name Description
RequestOptions options

The options to be used when sending the request.
Returns
Type Description
ValueTask<IReadOnlyCollection<RestVoiceRegion>>

A task that contains a read-only collection of REST-based voice regions.
Overrides
| Improve this Doc View Source

SetActivityAsync(IActivity)

Sets the activity of the logged-in user.

Declaration
public override async Task SetActivityAsync(IActivity activity)
Parameters
Type Name Description
IActivity activity

The activity to be set.
Returns
Type Description
Task

A task that represents the asynchronous set operation.
Overrides
Remarks

This method sets the activity of the user.

note

Discord will only accept setting of name and the type of activity.

warning

Bot accounts cannot set CustomStatus as their activity type and it will have no effect.

warning

Rich Presence cannot be set via this method or client. Rich Presence is strictly limited to RPC clients only.

| Improve this Doc View Source

SetCustomStatusAsync(String)

Sets the custom status of the logged-in user.

Declaration
public override async Task SetCustomStatusAsync(string status)
Parameters
Type Name Description
String status

The string that will be displayed as status.
Returns
Type Description
Task

A task that represents the asynchronous set operation.
Overrides
| Improve this Doc View Source

SetGameAsync(String, String, ActivityType)

Sets the game of the user.

Declaration
public override async Task SetGameAsync(string name, string streamUrl = null, ActivityType type = default(ActivityType))
Parameters
Type Name Description
String name

The name of the game.
String streamUrl

If streaming, the URL of the stream. Must be a valid Twitch URL.
ActivityType type

The type of the game.
Returns
Type Description
Task

A task that represents the asynchronous set operation.
Overrides
Remarks
warning

Bot accounts cannot set CustomStatus as their activity type and it will have no effect.

| Improve this Doc View Source

SetStatusAsync(UserStatus)

Sets the current status of the user (e.g. Online, Do not Disturb).

Declaration
public override async Task SetStatusAsync(UserStatus status)
Parameters
Type Name Description
UserStatus status

The new status to be set.
Returns
Type Description
Task

A task that represents the asynchronous set operation.
Overrides
| Improve this Doc View Source

StartAsync()

Declaration
public override async Task StartAsync()
Returns
Type Description
Task
Overrides
| Improve this Doc View Source

StopAsync()

Declaration
public override async Task StopAsync()
Returns
Type Description
Task
Overrides

Events

| Improve this Doc View Source

ShardConnected

Fired when a shard is connected to the Discord gateway.

Declaration
public event Func<DiscordSocketClient, Task> ShardConnected
Event Type
Type Description
Func<DiscordSocketClient, Task>
| Improve this Doc View Source

ShardDisconnected

Fired when a shard is disconnected from the Discord gateway.

Declaration
public event Func<Exception, DiscordSocketClient, Task> ShardDisconnected
Event Type
Type Description
Func<Exception, DiscordSocketClient, Task>
| Improve this Doc View Source

ShardLatencyUpdated

Fired when a shard receives a heartbeat from the Discord gateway.

Declaration
public event Func<int, int, DiscordSocketClient, Task> ShardLatencyUpdated
Event Type
Type Description
Func<Int32, Int32, DiscordSocketClient, Task>
| Improve this Doc View Source

ShardReady

Fired when a guild data for a shard has finished downloading.

Declaration
public event Func<DiscordSocketClient, Task> ShardReady
Event Type
Type Description
Func<DiscordSocketClient, Task>

Explicit Interface Implementations

| Improve this Doc View Source

IDiscordClient.CurrentUser

Gets the currently logged-in user.

Declaration
ISelfUser IDiscordClient.CurrentUser { get; }
Returns
Type Description
ISelfUser

Implements

IDisposable
IAsyncDisposable