跳到主要内容
版本:3.3.0

信息类型

simbot提供了一组标准的 基础信息 类型,用来作为后续章节中会出现的 Objectives 的信息载体类型。

对于大多数 基础信息 来讲,他们的命名方式都类似于 XxxInfo,即以 Info 作为结尾,例如 UserInfo基础信息 会提供一些 预期内 能够提供的属性,并约定当属性不支持时的默认值。

对于基础信息中提供的属性,大多数都是一些普通的属性而并非可挂起属性。

OrganizationInfo

代表 组织 的基本信息。

属性类型描述
idID唯一标识。
nameString名称。
iconString图标/组织头像。如果不支持则可能为空。
descriptionString组织的描述。如果不支持则可能为空。
createTimeTimestamp组织创建时间。如果不支持则可能为 Timestamp.NotSupport
ownerIdID组织拥有者/创建者的ID。
maximumMemberInt当前组织内成员最大承载量。如果不支持则为 -1
currentMemberInt组织内当前成员数量。如果不能 直接 支持则可能会尝试查询所有用户列表;如果不支持则为 -1

GuildInfo

代表 频道服务器信息。继承自 OrganizationInfo

GroupInfo

代表 群信息。继承自 OrganizationInfo

ChannelInfo

代表 子频道信息。继承自 OrganizationInfo

属性类型描述
guildIdID此子频道对应的频道服务器ID。

UserInfo

代表 用户 的基本信息。

属性类型描述
idID唯一标识。
usernameString用户名。
avatarString头像链接。如不支持则可能为空。

BotInfo

代表 Bot 的基本信息。继承自 UserInfo

FriendInfo

代表一个bot的 好友 信息。继承自 UserInfo

属性类型描述
remarkString?bot对此好友的备注。不存在、不支持的情况下为null。
groupingGrouping好友的分组。不存在、不支持的情况下为 Grouping.Empty

MemberInfo

代表一个组织内的 组织成员 信息。继承自 UserInfo

属性类型描述
nicknameString成员在组织中的备注名。不存在、不支持的情况下为空。
joinTimeTimestamp成员加入当前组织的时间。不存在、不支持的情况下为 Timestamp.NotSupport不支持的可能性很大。