Table of Contents

Interface IGuild

Namespace
Kook
Assembly
Kook.Net.Core.dll

表示一个通用的服务器。

public interface IGuild : IEntity<ulong>
Inherited Members

Properties

AudioClient

获取在此服务内的语音频道上建立的语音客户端。

[Obsolete("Use AudioClients instead.")]
IAudioClient? AudioClient { get; }

Property Value

IAudioClient
See Also

AudioClients

获取在此服务内的语音频道上建立的所有语音客户端。

IReadOnlyDictionary<ulong, IAudioClient> AudioClients { get; }

Property Value

IReadOnlyDictionary<ulong, IAudioClient>
See Also

Banner

获取此服务器横幅图像的 URL。

string Banner { get; }

Property Value

string

BoostLevel

获取此服务器的服务器助力等级。

BoostLevel BoostLevel { get; }

Property Value

BoostLevel

BoostSubscriptionCount

获取此服务器的服务器助力包的数量。

int BoostSubscriptionCount { get; }

Property Value

int

BufferBoostSubscriptionCount

获取此服务器来自拥有 BUFF 会员的用的服务器助力包的数量。

int BufferBoostSubscriptionCount { get; }

Property Value

int

DefaultChannelId

获取默认文字频道的 ID。

ulong? DefaultChannelId { get; }

Property Value

ulong?

Emotes

获取此服务器的所有自定义表情。

IReadOnlyCollection<GuildEmote> Emotes { get; }

Property Value

IReadOnlyCollection<GuildEmote>

EveryoneRole

获取此服务器中的 @全体成员 全体成员角色。

IRole EveryoneRole { get; }

Property Value

IRole

Features

获取此服务器的所有特性。

GuildFeatures Features { get; }

Property Value

GuildFeatures

Icon

获取此服务器图标的 URL。

string Icon { get; }

Property Value

string

IsAvailable

确定此服务器实体是否已准备就绪以供用户代码访问。

bool IsAvailable { get; }

Property Value

bool

Remarks

note

此属性仅对基于网关连接的客户端有意义。

此属性为 true 表示，此服务器实体已完整缓存基础数据，并与网关同步。
缓存基础数据包括服务器基本信息、频道、角色、频道权限重写、当前用户在服务器内的昵称。

IsOpenEnabled

获取此服务器是否为公开服务器。

bool IsOpenEnabled { get; }

Property Value

bool

MaxBitrate

获取此服务器中语音频道的最高比特率。

int MaxBitrate { get; }

Property Value

int

Remarks

此限制取决于服务器的助力状态。

MaxUploadLimit

获取此服务器的文件上传限制，以字节为单位。

ulong MaxUploadLimit { get; }

Property Value

ulong

Remarks

此限制取决于服务器的助力状态。

Name

获取此服务器的名称。

string Name { get; }

Property Value

string

NotifyType

获取此服务器的默认通知类型。

NotifyType NotifyType { get; }

Property Value

NotifyType

OpenId

获取此服务器的公开 ID。

uint? OpenId { get; }

Property Value

uint?

Remarks

当 IsOpenEnabled 为 true 时，此属性应该返回一个有效的公开服务器 ID； 如果 IsOpenEnabled 为 false，则此属性应该返回 null。

OwnerId

获取此服务器所有者的用户 ID。

ulong OwnerId { get; }

Property Value

ulong

RecommendInfo

获取此服务器的推荐信息。

IRecommendInfo? RecommendInfo { get; }

Property Value

IRecommendInfo

Region

获取此服务器的默认语音服务器区域。

string Region { get; }

Property Value

string

Remarks

语音服务器区域是指语音服务器所在的地理位置，各个语音服务器区域由一个唯一的字符串表示。
可用语音服务器区域参考列表：

区域 ID 区域名称
chengdu 西南(成都)
beijing 华北(北京)
shanghai 华东(上海)
shenzhen 华南(深圳)
hk 亚太(香港)
vnga 国际专线(助力专享)
此列表仅供参考。

Roles

获取此服务器的所有角色。

IReadOnlyCollection<IRole> Roles { get; }

Property Value

IReadOnlyCollection<IRole>

Topic

获取此服务器的介绍。

string Topic { get; }

Property Value

string

WelcomeChannelId

获取欢迎通知频道的 ID。

ulong? WelcomeChannelId { get; }

Property Value

ulong?

Methods

AddBanAsync(IUser, int, string?, RequestOptions?)

封禁服务器内的用户。

Task AddBanAsync(IUser user, int pruneDays = 0, string? reason = null, RequestOptions? options = null)

Parameters

user IUser

要封禁的用户。

pruneDays int

要删除此服务器中来自此用户的最近几天的消息，范围为 0 至 7，0 表示不删除。

reason string

封禁原因。

options RequestOptions

发送请求时要使用的选项。

Returns

Task

一个表示异步封禁操作的任务。

Exceptions

ArgumentException

pruneDays 超出了 0 至 7 的范围。

AddBanAsync(ulong, int, string?, RequestOptions?)

封禁服务器内的用户。

Task AddBanAsync(ulong userId, int pruneDays = 0, string? reason = null, RequestOptions? options = null)

Parameters

userId ulong

要封禁的用户的 ID。

pruneDays int

要删除此服务器中来自此用户的最近几天的消息，范围为 0 至 7，0 表示不删除。

reason string

封禁原因。

options RequestOptions

发送请求时要使用的选项。

Returns

Task

一个表示异步封禁操作的任务。

Exceptions

ArgumentException

pruneDays 超出了 0 至 7 的范围。

CreateCategoryChannelAsync(string, Action<CreateCategoryChannelProperties>?, RequestOptions?)

在此服务器内创建一个新的分组频道。

Task<ICategoryChannel> CreateCategoryChannelAsync(string name, Action<CreateCategoryChannelProperties>? func = null, RequestOptions? options = null)

Parameters

name string

频道的名称。

func Action<CreateCategoryChannelProperties>

一个包含要应用到新创建频道的配置的委托。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<ICategoryChannel>

一个表示异步创建操作的任务。任务的结果包含新创建的分组频道。

CreateEmoteAsync(string, Image, RequestOptions?)

在此服务器内创建一个新的自定义表情。

Task<GuildEmote> CreateEmoteAsync(string name, Image image, RequestOptions? options = null)

Parameters

name string

新自定义表情的名称。

image Image

新自定义表情的图像信息。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<GuildEmote>

一个表示异步创建操作的任务。任务的结果包含新创建的自定义表情。

CreateInviteAsync(InviteMaxAge, InviteMaxUses, RequestOptions?)

创建一个到此服务器的新邀请。

Task<IInvite> CreateInviteAsync(InviteMaxAge maxAge = InviteMaxAge._604800, InviteMaxUses maxUses = InviteMaxUses.Unlimited, RequestOptions? options = null)

Parameters

maxAge InviteMaxAge

邀请链接的有效时长，NeverExpires 表示永不过期。

maxUses InviteMaxUses

邀请链接的可用人次，Unlimited 表示无限制。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IInvite>

一个表示异步创建操作的任务。任务的结果包含新创建的邀请链接的元数据，其中包含有关邀请链接的信息。

CreateInviteAsync(int?, int?, RequestOptions?)

创建一个到此服务器的新邀请。

Task<IInvite> CreateInviteAsync(int? maxAge = 604800, int? maxUses = null, RequestOptions? options = null)

Parameters

maxAge int?

邀请链接的有效时长，null 表示永不过期。

maxUses int?

邀请链接的可用人次，null 表示无限制。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IInvite>

一个表示异步创建操作的任务。任务的结果包含新创建的邀请链接的元数据，其中包含有关邀请链接的信息。

CreateRoleAsync(string, RequestOptions?)

在此服务器内创建一个新角色。

Task<IRole> CreateRoleAsync(string name, RequestOptions? options = null)

Parameters

name string

角色的名称。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IRole>

一个表示异步创建操作的任务。任务的结果包含新创建的角色。

CreateTextChannelAsync(string, Action<CreateTextChannelProperties>?, RequestOptions?)

在此服务器内创建一个新的文字频道。

Task<ITextChannel> CreateTextChannelAsync(string name, Action<CreateTextChannelProperties>? func = null, RequestOptions? options = null)

Parameters

name string

频道的名称。

func Action<CreateTextChannelProperties>

一个包含要应用到新创建频道的配置的委托。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<ITextChannel>

一个表示异步创建操作的任务。任务的结果包含新创建的文字频道。

CreateThreadChannelAsync(string, Action<CreateThreadChannelProperties>?, RequestOptions?)

在此服务器内创建一个新的帖子频道。

Task<IThreadChannel> CreateThreadChannelAsync(string name, Action<CreateThreadChannelProperties>? func = null, RequestOptions? options = null)

Parameters

name string

频道的名称。

func Action<CreateThreadChannelProperties>

一个包含要应用到新创建频道的配置的委托。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IThreadChannel>

一个表示异步创建操作的任务。任务的结果包含新创建的帖子频道。

CreateVoiceChannelAsync(string, Action<CreateVoiceChannelProperties>?, RequestOptions?)

在此服务器内创建一个新的语音频道。

Task<IVoiceChannel> CreateVoiceChannelAsync(string name, Action<CreateVoiceChannelProperties>? func = null, RequestOptions? options = null)

Parameters

name string

频道的名称。

func Action<CreateVoiceChannelProperties>

一个包含要应用到新创建频道的配置的委托。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IVoiceChannel>

一个表示异步创建操作的任务。任务的结果包含新创建的语音频道。

DeleteEmoteAsync(GuildEmote, RequestOptions?)

删除此服务器内的现有自定义表情。

Task DeleteEmoteAsync(GuildEmote emote, RequestOptions? options = null)

Parameters

emote GuildEmote

要删除的自定义表情。

options RequestOptions

发送请求时要使用的选项。

Returns

Task

一个表示异步删除操作的任务。

DownloadBoostSubscriptionsAsync(RequestOptions?)

下载此服务器内的所有服务器助力信息。

Task DownloadBoostSubscriptionsAsync(RequestOptions? options = null)

Parameters

options RequestOptions

发送请求时要使用的选项。

Returns

Task

一个表示异步下载操作的任务。

Remarks

此方法会通过网关下载此服务器内的所有服务器助力信息，并缓存它们。 要下载所有服务器助力信息，当前用户必须具有 ManageGuild 权限。

DownloadUsersAsync(RequestOptions?)

下载此服务器内的所有用户。

Task DownloadUsersAsync(RequestOptions? options = null)

Parameters

options RequestOptions

发送请求时要使用的选项。

Returns

Task

一个表示异步下载操作的任务。

Remarks

此方法会下载所有加入到此服务器内的用户，并缓存它们。

DownloadVoiceStatesAsync(RequestOptions?)

下载此服务器内的所有语音状态。

Task DownloadVoiceStatesAsync(RequestOptions? options = null)

Parameters

options RequestOptions

发送请求时要使用的选项。

Returns

Task

一个表示异步下载操作的任务。

Remarks

此方法会下载此服务器内的所有语音状态，并缓存它们。

GetActiveBoostSubscriptionsAsync(RequestOptions?)

获取此服务器所有生效中的服务器助力包。

Task<ImmutableDictionary<IUser, IReadOnlyCollection<BoostSubscriptionMetadata>>> GetActiveBoostSubscriptionsAsync(RequestOptions? options = null)

Parameters

options RequestOptions

发送请求时要使用的选项。

Returns

Task<ImmutableDictionary<IUser, IReadOnlyCollection<BoostSubscriptionMetadata>>>

一个表示异步获取操作的任务。任务的结果是所有为此服务器助力的用户及所应用的生效中的服务器助力包。

GetBadgeAsync(BadgeStyle, RequestOptions?)

获取与此服务器关联的徽章。

Task<Stream> GetBadgeAsync(BadgeStyle style = BadgeStyle.GuildName, RequestOptions? options = null)

Parameters

style BadgeStyle

要获取的徽章的样式。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<Stream>

一个表示异步获取操作的任务。任务的结果包含与此服务器关联的徽章的流。

GetBanAsync(IUser, RequestOptions?)

获取指定用户在此服务器内当前的封禁信息。

Task<IBan?> GetBanAsync(IUser user, RequestOptions? options = null)

Parameters

user IUser

要获取封禁信息的用户。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IBan>

一个表示异步获取操作的任务。任务的结果包含该用户在此服务器内的封禁信息；如果该用户当前未被此服务器封禁，则返回 null。

GetBanAsync(ulong, RequestOptions?)

获取指定用户在此服务器内的封禁信息。

Task<IBan?> GetBanAsync(ulong userId, RequestOptions? options = null)

Parameters

userId ulong

要获取封禁信息的用户的 ID。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IBan>

一个表示异步获取操作的任务。任务的结果包含该用户在此服务器内的封禁信息；如果该用户未被此服务器封禁，或封禁已过期或解除，则返回 null。

GetBansAsync(RequestOptions?)

获取此服务器的所有封禁信息。

Task<IReadOnlyCollection<IBan>> GetBansAsync(RequestOptions? options = null)

Parameters

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IReadOnlyCollection<IBan>>

一个表示异步获取操作的任务。任务的结果包含此服务器的所有封禁信息。

GetBoostSubscriptionsAsync(RequestOptions?)

所有此服务器的所有服务器助力包。

Task<ImmutableDictionary<IUser, IReadOnlyCollection<BoostSubscriptionMetadata>>> GetBoostSubscriptionsAsync(RequestOptions? options = null)

Parameters

options RequestOptions

发送请求时要使用的选项。

Returns

Task<ImmutableDictionary<IUser, IReadOnlyCollection<BoostSubscriptionMetadata>>>

一个表示异步获取操作的任务。任务的结果是所有为此服务器助力的用户及所应用的服务器助力包。

GetCategoryChannelsAsync(CacheMode, RequestOptions?)

获取此服务器中的所有分组频道。

Task<IReadOnlyCollection<ICategoryChannel>> GetCategoryChannelsAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions? options = null)

Parameters

mode CacheMode

指示当前方法是否应该仅从缓存中获取结果，还是可以通过 API 请求获取数据。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IReadOnlyCollection<ICategoryChannel>>

一个表示异步获取操作的任务。任务的结果包含此服务器的所有分组频道。

GetChannelAsync(ulong, CacheMode, RequestOptions?)

获取此服务器内的频道。

Task<IGuildChannel?> GetChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions? options = null)

Parameters

id ulong

要获取的频道的 ID。

mode CacheMode

指示当前方法是否应该仅从缓存中获取结果，还是可以通过 API 请求获取数据。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IGuildChannel>

一个表示异步获取操作的任务。任务的结果包含与指定的 id 关联的频道；如果未找到，则返回 null。

GetChannelsAsync(CacheMode, RequestOptions?)

获取此服务器的所有频道。

Task<IReadOnlyCollection<IGuildChannel>> GetChannelsAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions? options = null)

Parameters

mode CacheMode

指示当前方法是否应该仅从缓存中获取结果，还是可以通过 API 请求获取数据。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IReadOnlyCollection<IGuildChannel>>

一个表示异步获取操作的任务。任务的结果包含此服务器的所有频道。

GetCurrentUserAsync(CacheMode, RequestOptions?)

获取此服务器内当前登录的用户。

Task<IGuildUser?> GetCurrentUserAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions? options = null)

Parameters

mode CacheMode

指示当前方法是否应该仅从缓存中获取结果，还是可以通过 API 请求获取数据。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IGuildUser>

一个表示异步获取操作的任务。任务的结果包含此服务器内当前登录的用户。

GetDefaultChannelAsync(CacheMode, RequestOptions?)

获取此服务器的默认文字频道。

Task<ITextChannel?> GetDefaultChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions? options = null)

Parameters

mode CacheMode

指示当前方法是否应该仅从缓存中获取结果，还是可以通过 API 请求获取数据。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<ITextChannel>

一个表示异步获取操作的任务。任务的结果包含此服务器的默认文字频道；如果未找到，则返回 null。

GetEmoteAsync(string, RequestOptions?)

获取此服务器的指定自定义表情。

Task<GuildEmote?> GetEmoteAsync(string id, RequestOptions? options = null)

Parameters

id string

要获取的自定义表情的 ID。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<GuildEmote>

一个表示异步获取操作的任务。任务的结果包含与指定的 id 关联的自定义表情；如果未找到，则返回 null。

GetEmotesAsync(RequestOptions?)

获取此服务器的所有自定义表情。

Task<IReadOnlyCollection<GuildEmote>> GetEmotesAsync(RequestOptions? options = null)

Parameters

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IReadOnlyCollection<GuildEmote>>

一个表示异步获取操作的任务。任务的结果包含此服务器的所有自定义表情。

GetInvitesAsync(RequestOptions?)

获取此服务器内的所有邀请信息。

Task<IReadOnlyCollection<IInvite>> GetInvitesAsync(RequestOptions? options = null)

Parameters

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IReadOnlyCollection<IInvite>>

一个表示异步获取操作的任务。任务的结果包含此服务器内的所有邀请信息。

GetOwnerAsync(CacheMode, RequestOptions?)

获取此服务器的所有者。

Task<IGuildUser?> GetOwnerAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions? options = null)

Parameters

mode CacheMode

指示当前方法是否应该仅从缓存中获取结果，还是可以通过 API 请求获取数据。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IGuildUser>

一个表示异步获取操作的任务。任务的结果包含此服务器的所有者。

GetRole(uint)

获取此服务器内的角色。

IRole? GetRole(uint id)

Parameters

id uint

要获取的角色的 ID。

Returns

IRole

一个表示异步获取操作的任务。任务的结果包含与指定的 id 关联的角色；如果未找到，则返回 null。

GetTextChannelAsync(ulong, CacheMode, RequestOptions?)

获取此服务器内指定具有文字聊天能力的频道。

Task<ITextChannel?> GetTextChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions? options = null)

Parameters

id ulong

要获取的频道的 ID。

mode CacheMode

指示当前方法是否应该仅从缓存中获取结果，还是可以通过 API 请求获取数据。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<ITextChannel>

一个表示异步获取操作的任务。任务的结果包含与指定的 id 关联的频道；如果未找到，则返回 null。

Remarks

语音频道也是一种文字频道，此方法本意用于获取具有文字聊天能力的频道。如果通过此方法传入的 ID 对应的频道是语音频道，那么也会返回对应的语音频道实体。 如需获取频道的实际类型，请参考 GetChannelType(IChannel)。

GetTextChannelsAsync(CacheMode, RequestOptions?)

获取此服务器中所有具有文字聊天能力的频道。

Task<IReadOnlyCollection<ITextChannel>> GetTextChannelsAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions? options = null)

Parameters

mode CacheMode

指示当前方法是否应该仅从缓存中获取结果，还是可以通过 API 请求获取数据。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IReadOnlyCollection<ITextChannel>>

一个表示异步获取操作的任务。任务的结果包含此服务器的所有具有文字聊天能力的频道。

Remarks

语音频道也是一种文字频道，此方法本意用于获取所有具有文字聊天能力的频道，通过此方法获取到的文字频道列表中也包含了语音频道。 如需获取频道的实际类型，请参考 GetChannelType(IChannel)。

GetThreadChannelAsync(ulong, CacheMode, RequestOptions?)

获取此服务器内的指定帖子频道。

Task<IThreadChannel?> GetThreadChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions? options = null)

Parameters

id ulong

要获取的频道的 ID。

mode CacheMode

指示当前方法是否应该仅从缓存中获取结果，还是可以通过 API 请求获取数据。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IThreadChannel>

一个表示异步获取操作的任务。任务的结果包含与指定的 id 关联的频道；如果未找到，则返回 null。

GetThreadChannelsAsync(CacheMode, RequestOptions?)

获取此服务器中的所有帖子频道。

Task<IReadOnlyCollection<IThreadChannel>> GetThreadChannelsAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions? options = null)

Parameters

mode CacheMode

指示当前方法是否应该仅从缓存中获取结果，还是可以通过 API 请求获取数据。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IReadOnlyCollection<IThreadChannel>>

一个表示异步获取操作的任务。任务的结果包含此服务器的所有帖子频道。

GetUserAsync(ulong, CacheMode, RequestOptions?)

获取此服务器内的用户。

Task<IGuildUser?> GetUserAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions? options = null)

Parameters

id ulong

要获取的用户的 ID。

mode CacheMode

指示当前方法是否应该仅从缓存中获取结果，还是可以通过 API 请求获取数据。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IGuildUser>

一个表示异步获取操作的任务。任务的结果包含与指定的 id 关联的用户；如果未找到，则返回 null。

Remarks

此方法获取加入到此服务器内的用户。

note

此方法在网关的实现中可能返回 null，因为在大型服务器中，用户列表的缓存可能不完整。

GetUsersAsync(CacheMode, RequestOptions?)

获取此服务器内的所有用户。

Task<IReadOnlyCollection<IGuildUser>> GetUsersAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions? options = null)

Parameters

mode CacheMode

指示当前方法是否应该仅从缓存中获取结果，还是可以通过 API 请求获取数据。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IReadOnlyCollection<IGuildUser>>

一个表示异步获取操作的任务。任务的结果包含此服务器内的所有用户。

GetVoiceChannelAsync(ulong, CacheMode, RequestOptions?)

获取此服务器内指定具有语音聊天能力的频道。

Task<IVoiceChannel?> GetVoiceChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions? options = null)

Parameters

id ulong

要获取的频道的 ID。

mode CacheMode

指示当前方法是否应该仅从缓存中获取结果，还是可以通过 API 请求获取数据。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IVoiceChannel>

一个表示异步获取操作的任务。任务的结果包含与指定的 id 关联的频道；如果未找到，则返回 null。

GetVoiceChannelsAsync(CacheMode, RequestOptions?)

获取此服务器中所有具有语音聊天能力的频道。

Task<IReadOnlyCollection<IVoiceChannel>> GetVoiceChannelsAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions? options = null)

Parameters

mode CacheMode

指示当前方法是否应该仅从缓存中获取结果，还是可以通过 API 请求获取数据。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<IReadOnlyCollection<IVoiceChannel>>

一个表示异步获取操作的任务。任务的结果包含此服务器的所有具有语音聊天能力的频道。

GetWelcomeChannelAsync(CacheMode, RequestOptions?)

获取此服务器的欢迎通知频道。

Task<ITextChannel?> GetWelcomeChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions? options = null)

Parameters

mode CacheMode

指示当前方法是否应该仅从缓存中获取结果，还是可以通过 API 请求获取数据。

options RequestOptions

发送请求时要使用的选项。

Returns

Task<ITextChannel>

一个表示异步获取操作的任务。任务的结果包含此服务器的欢迎通知频道；如果未找到，则返回 null。

LeaveAsync(RequestOptions?)

退出此服务器。

Task LeaveAsync(RequestOptions? options = null)

Parameters

options RequestOptions

发送请求时要使用的选项。

Returns

Task

一个表示异步退出操作的任务。

ModifyEmoteNameAsync(GuildEmote, string, RequestOptions?)

修改此服务器内的现有自定义表情。

Task ModifyEmoteNameAsync(GuildEmote emote, string name, RequestOptions? options = null)

Parameters

emote GuildEmote

要修改的自定义表情。

name string

新的自定义表情名称。

options RequestOptions

发送请求时要使用的选项。

Returns

Task

一个表示异步修改操作的任务。任务的结果包含修改后的自定义表情。

MoveUsersAsync(IEnumerable<IGuildUser>, IVoiceChannel, RequestOptions?)

移动用户到语音频道。

Task MoveUsersAsync(IEnumerable<IGuildUser> users, IVoiceChannel targetChannel, RequestOptions? options = null)

Parameters

users IEnumerable<IGuildUser>

要移动的用户。

targetChannel IVoiceChannel

要移动用户到的语音频道。

options RequestOptions

发送请求时要使用的选项。

Returns

Task

一个表示异步移动操作的任务。

RemoveBanAsync(IUser, RequestOptions?)

解除服务器对用户的封禁。

Task RemoveBanAsync(IUser user, RequestOptions? options = null)

Parameters

user IUser

要解除封禁的用户。

options RequestOptions

发送请求时要使用的选项。

Returns

Task

一个表示异步封禁解除操作的任务。

RemoveBanAsync(ulong, RequestOptions?)

解除服务器对用户的封禁。

Task RemoveBanAsync(ulong userId, RequestOptions? options = null)

Parameters

userId ulong

要解除封禁的用户的 ID。

options RequestOptions

发送请求时要使用的选项。

Returns

Task

一个表示异步封禁解除操作的任务。

SearchUsersAsync(Action<SearchGuildMemberProperties>, int, CacheMode, RequestOptions?)

搜索加入到此服务器内匹配指定搜索条件的所有用户。

IAsyncEnumerable<IReadOnlyCollection<IGuildUser>> SearchUsersAsync(Action<SearchGuildMemberProperties> func, int limit = 50, CacheMode mode = CacheMode.AllowDownload, RequestOptions? options = null)

Parameters

func Action<SearchGuildMemberProperties>

一个包含要搜索的用户属性及排序条件的委托。

limit int

搜索结果的最大数量。

mode CacheMode

指示当前方法是否应该仅从缓存中获取结果，还是可以通过 API 请求获取数据。

options RequestOptions

发送请求时要使用的选项。

Returns

IAsyncEnumerable<IReadOnlyCollection<IGuildUser>>

一个表示异步获取操作的任务。任务的结果包含与提供的 func 中指定的属性匹配的服务器用户集合。

Remarks

此方法使用指定的属性搜索服务器用户。要查看可用的属性，请参考 SearchGuildMemberProperties。

Edit this page