khl.py khl.py
主页
文档
示例
  • khl.py (opens new window)
  • khl.py.docs (opens new window)
KOOK (opens new window)
主页
文档
示例
  • khl.py (opens new window)
  • khl.py.docs (opens new window)
KOOK (opens new window)
  • 机器人

    • 初始化
    • 命令
    • 定时任务
    • 在玩状态
  • 消息

    • 消息类型
    • 上传和发送文件或图片
    • 卡片消息
  • 频道

    • 获取频道对象
    • 主动发送消息
  • 用户

    • 获取机器人用户对象
    • 获取用户对象和发送私聊信息
    • 机器人下线
  • 服务器

    • 获取服务器对象
      • 1.获取服务器对象
      • 2.成员变量
      • 3.相关接口
    • 服务器角色操作
    • 设置用户昵称
  • 事件

    • 事件基础处理
  • 其他

    • KOOK客户端获取各类ID
    • 多文件注册机器人命令
    • 配置python的venv虚拟环境
    • 获取图片链接
    • 尝试自己调用api
    • OpenSSL本地证书无法获取错误
  • docs
  • 服务器
musnows
2024-01-29
目录

获取服务器对象

# 1.获取服务器对象

获取服务器对象的方法如下,对应/api/v3/guild/view接口,返回值是Guild对象

guild = await bot.client.fetch_guild("服务器ID")

@bot.command所修饰的命令处理函数中,msg.ctx.guild是当前发起命令的频道Guild对象。

# 2.成员变量

Guild对象的成员请参考代码补全和官方文档中的说明:https://developer.kookapp.cn/doc/http/guild#获取服务器详情 (opens new window)

Guild对象在初始化的时候,就已经完成了大部分服务器内相关信息的fetch操作。

# 3.相关接口

对服务器内用户、更新服务器信息、新建emoji/角色/频道等操作,都需使用Guild对象来执行。

函数的传参可参考代码补全和官方API接口的参数列表。

函数名 对应接口 作用
delete_role /api/v3/guild-role/delete (opens new window) 删除某个角色
fetch_roles /api/v3/guild-role/list (opens new window) 获取角色列表
create_role /api/v3/guild-role/create (opens new window) 新建角色
update_role /api/v3/guild-role/update (opens new window) 更新角色
grant_role /api/v3/guild-role/grant (opens new window) 给某个用户上某个角色
revoke_role /api/v3/guild-role/revoke (opens new window) 给某个用户下角色
create_voice_channel /api/v3/channel/create (opens new window) 创建语音频道
create_text_channel /api/v3/channel/create (opens new window) 创建文字频道
create_channel_category /api/v3/channel/create (opens new window) 创建频道分组
create_mute /api/v3/guild-mute/create (opens new window) 添加服务器静音或闭麦
create_emoji /api/v3/guild-emoji/create (opens new window) 创建服务器表情
delete_channel /api/v3/channel/delete (opens new window) 删除频道
delete_emoji /api/v3/guild-emoji/delete (opens new window) 删除服务器表情
delete_mute /api/v3/guild-mute/delete (opens new window) 取消服务器静音或闭麦
delete_role /api/v3/guild-role/delete (opens new window) 删除角色
fetch_badge /api/v3/badge/guild (opens new window) 获取服务器badge
fetch_mute_list /api/v3/guild-mute/list (opens new window) 服务器静音闭麦列表
fetch_user /api/v3/user/view (opens new window) 获取GuildUser对象,用户基本信息
fetch_user_list /api/v3/guild/user-list (opens new window) 服务器的用户列表
fetch_joined_channel /api/v3/channel-user/get-joined-channel (opens new window) 获取用户所在语音频道
fetch_emoji_list /api/v3/guild-emoji/list (opens new window) 服务器表情列表
fetch_channel_list /api/v3/channel/list (opens new window) 获取频道列表
fetch_boost /api/v3/guild-boost/history (opens new window) 查询服务器助力包历史
kickout /api/v3/guild/kickout (opens new window) 将用户踢出服务器
leave /api/v3/guild/leave (opens new window) 机器人离开服务器
set_user_nickname /api/v3/guild/nickname (opens new window) 设置用户在服务器内的昵称
update_emoji /api/v3/guild-emoji/update (opens new window) 更新服务器表情
上次更新: 2024/01/29, 03:49:56
机器人下线
服务器角色操作

← 机器人下线 服务器角色操作→

Theme by Vdoing | Copyright © 2023-2025 khl.py | MIT License
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式