Table of Contents

Interface IGuildUser

Namespace
Kook
Assembly
Kook.Net.Core.dll

表示一个通用的服务器用户。

public interface IGuildUser : IUser, IEntity<ulong>, IMentionable, IPresence, IVoiceState
Inherited Members
Extension Methods

Properties

ActiveAt

获取此用户在该服务器内的最近活跃时间。

DateTimeOffset? ActiveAt { get; }

Property Value

DateTimeOffset?

Color

获取此用户的显示名称的颜色。

Color? Color { get; }

Property Value

Color?

Remarks

如果此用户所拥有的最高角色的颜色类型为渐变色，则此属性返回的颜色是渐变色权益失效后的回退颜色。

warning

一个角色的颜色可能是纯色或渐变色，参见 ColorType。但由于服务器用户列表 API 及服务器用户详情 API 所返回的用户信息均不包含角色的颜色类型和渐变色信息，因此，如果用户的最高角色的颜色是渐变色， 则此属性的值可能是不正确的。如需获取该用户的准确的显示名称及颜色，请获取此用户的最高角色实体对象，访问其颜色类型及渐变色属性。

if (guildUser.RoleIds.Select(x => guildUser.Guild.GetRole(x)).OfType<IRole>().MinBy(x => x.Position) is { } topRole)
          {
              ColorType colorType = topRole.ColorType;
              GradientColor? gradientColor = topRole.GradientColor;
          }

DisplayName

获取此用户的显示名称。

string DisplayName { get; }

Property Value

string

Remarks

如果此用户在该服务器内设置了昵称，则此属性返回昵称；否则返回用户名。

Guild

获取此服务器用户所属的服务器。

IGuild Guild { get; }

Property Value

IGuild

GuildId

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

ulong GuildId { get; }

Property Value

ulong

GuildPermissions

获取此用户在该服务器内的权限。

GuildPermissions GuildPermissions { get; }

Property Value

GuildPermissions

IsMobileVerified

获取此用户的手机号码是否已验证。

bool? IsMobileVerified { get; }

Property Value

bool?

IsOwner

获取此用户是否为当前服务器的所有者。

bool? IsOwner { get; }

Property Value

bool?

JoinedAt

获取此用户加入服务器的时间。

DateTimeOffset? JoinedAt { get; }

Property Value

DateTimeOffset?

Nickname

获取此用户在该服务器内的昵称。

string? Nickname { get; }

Property Value

string

Remarks

如果此用户在该服务器内没有设置昵称，则此属性返回 null。

RoleIds

获取此用户在该服务器内拥有的所有角色的 ID。

IReadOnlyCollection<uint> RoleIds { get; }

Property Value

IReadOnlyCollection<uint>

Remarks

此属性返回此用户所拥有的所有角色的 ID。对于 WebSocket 服务器用户实体，Roles 属性可以用来获取所有角色对象；对于 REST 服务器用户实体，受限于 KOOK API，在服务器用户实体上仅能直接获取其所拥有的所有角色的 ID。

Methods

AddRoleAsync(IRole, RequestOptions?)

在该服务器内授予此用户指定的角色。

Task AddRoleAsync(IRole role, RequestOptions? options = null)

Parameters

role IRole

要在该服务器内为此用户授予的角色。

options RequestOptions

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

Returns

Task

一个表示异步授予操作的任务。

AddRoleAsync(uint, RequestOptions?)

在该服务器内授予此用户指定的角色。

Task AddRoleAsync(uint roleId, RequestOptions? options = null)

Parameters

roleId uint

要在该服务器内为此用户授予的角色的 ID。

options RequestOptions

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

Returns

Task

一个表示异步授予操作的任务。

AddRolesAsync(IEnumerable<IRole>, RequestOptions?)

在该服务器内授予此用户指定的一些角色。

Task AddRolesAsync(IEnumerable<IRole> roles, RequestOptions? options = null)

Parameters

roles IEnumerable<IRole>

要在该服务器内为此用户授予的所有角色。

options RequestOptions

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

Returns

Task

一个表示异步授予操作的任务。

AddRolesAsync(IEnumerable<uint>, RequestOptions?)

在该服务器内授予此用户指定的一些角色。

Task AddRolesAsync(IEnumerable<uint> roleIds, RequestOptions? options = null)

Parameters

roleIds IEnumerable<uint>

要在该服务器内为此用户授予的所有角色的 ID。

options RequestOptions

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

Returns

Task

一个表示异步授予操作的任务。

DeafenAsync(RequestOptions?)

在该服务器内限制此用户的语音接收。

Task DeafenAsync(RequestOptions? options = null)

Parameters

options RequestOptions

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

Returns

Task

一个表示异步静音操作的任务。

Remarks

此操作会使此用户无法在该服务器内的语音频道中接收来自其他用户的语音。

GetBoostSubscriptionsAsync(RequestOptions?)

获取此用户在该服务器内的所有服务器助力包订阅信息。

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

Parameters

options RequestOptions

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

Returns

Task<IReadOnlyCollection<BoostSubscriptionMetadata>>

一个表示异步获取操作的任务。任务的结果包含此用户在该服务器内的所有服务器助力包订阅信息。

GetConnectedVoiceChannelsAsync(RequestOptions?)

获取此用户当前所连接到的所有语音频道。

Task<IReadOnlyCollection<IVoiceChannel>> GetConnectedVoiceChannelsAsync(RequestOptions? options = null)

Parameters

options RequestOptions

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

Returns

Task<IReadOnlyCollection<IVoiceChannel>>

一个表示异步获取操作的任务。任务的结果包含此用户当前所连接到的所有语音频道。

GetPermissions(IGuildChannel)

获取此用户在指定频道内所拥有的权限。

ChannelPermissions GetPermissions(IGuildChannel channel)

Parameters

channel IGuildChannel

要获取权限的频道。

Returns

ChannelPermissions

一个表示此用户在指定频道内所拥有的频道权限的权限集。

KickAsync(RequestOptions?)

将此用户从此服务器中踢出。

Task KickAsync(RequestOptions? options = null)

Parameters

options RequestOptions

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

Returns

Task

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

ModifyNicknameAsync(string?, RequestOptions?)

修改此用户在该服务器内的昵称。

Task ModifyNicknameAsync(string? name, RequestOptions? options = null)

Parameters

name string

要设置到此用户在该服务器内的新昵称。

options RequestOptions

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

Returns

Task

一个表示异步修改操作的任务。

Remarks

此方法使用指定的属性修改当前用户在该服务器内的昵称。
如要清除此用户在该服务器内的昵称，请将 name 设置为 null。

warning

如果将昵称设置为与用户名相同，KOOK 也会将该用户在此服务器内的昵称清除，显示名称将跟随用户名，而不是固定为指定的昵称。

MuteAsync(RequestOptions?)

在该服务器内关闭此用户的语音输入。

Task MuteAsync(RequestOptions? options = null)

Parameters

options RequestOptions

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

Returns

Task

一个表示异步关闭操作的任务。

Remarks

此操作会使此用户无法在该服务器内的语音频道中发言。

RemoveRoleAsync(IRole, RequestOptions?)

在该服务器内撤销此用户指定的角色。

Task RemoveRoleAsync(IRole role, RequestOptions? options = null)

Parameters

role IRole

要在该服务器内为此用户撤销的角色。

options RequestOptions

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

Returns

Task

一个表示异步撤销操作的任务。

RemoveRoleAsync(uint, RequestOptions?)

在该服务器内撤销此用户指定的角色。

Task RemoveRoleAsync(uint roleId, RequestOptions? options = null)

Parameters

roleId uint

要在该服务器内为此用户撤销的角色的 ID。

options RequestOptions

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

Returns

Task

一个表示异步撤销操作的任务。

RemoveRolesAsync(IEnumerable<IRole>, RequestOptions?)

在该服务器内撤销此用户指定的一些角色。

Task RemoveRolesAsync(IEnumerable<IRole> roles, RequestOptions? options = null)

Parameters

roles IEnumerable<IRole>

要在该服务器内为此用户撤销的所有角色。

options RequestOptions

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

Returns

Task

一个表示异步撤销操作的任务。

RemoveRolesAsync(IEnumerable<uint>, RequestOptions?)

在该服务器内撤销此用户指定的一些角色。

Task RemoveRolesAsync(IEnumerable<uint> roleIds, RequestOptions? options = null)

Parameters

roleIds IEnumerable<uint>

要在该服务器内为此用户撤销的所有角色的 ID。

options RequestOptions

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

Returns

Task

一个表示异步撤销操作的任务。

UndeafenAsync(RequestOptions?)

在该服务器内恢复此用户的语音接收。

Task UndeafenAsync(RequestOptions? options = null)

Parameters

options RequestOptions

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

Returns

Task

一个表示异步恢复操作的任务。

Remarks

此操作会撤销由于服务器静音而导致的无法在语音频道中接收来自其他用户的语音的状态。

UnmuteAsync(RequestOptions?)

在该服务器内恢复此用户的语音输入。

Task UnmuteAsync(RequestOptions? options = null)

Parameters

options RequestOptions

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

Returns

Task

一个表示异步恢复操作的任务。

Remarks

此操作会撤销由于服务器闭麦而导致的在语音频道中无法发言状态。

Edit this page