Golang Discord API 接口封装与 disgo 库使用指南

Discord API 概述

Discord 提供了完善的 REST API 和 WebSocket 网关接口，允许开发者构建机器人、集成应用等。在 Golang 中，我们可以使用 disgo 这样的库来简化与 Discord API 的交互。

disgo 库简介

disgo 是一个功能强大的 Discord API 封装库，提供了以下特性：

• 完整的 Discord API 覆盖
• 简洁易用的接口设计
• 支持 WebSocket 和 REST API
• 事件驱动架构
• 完善的文档和示例

安装 disgo

go get github.com/DisgoOrg/disgo

基础使用示例

1. 创建 Discord 机器人客户端

package main

import (
	"github.com/DisgoOrg/disgo"
	"github.com/DisgoOrg/disgo/bot"
	"github.com/DisgoOrg/disgo/discord"
	"github.com/DisgoOrg/disgo/events"
	"github.com/DisgoOrg/disgo/gateway"
	"log"
	"os"
)

func main() {
	// 从环境变量获取token
	token := os.Getenv("DISCORD_BOT_TOKEN")
	if token == "" {
		log.Fatal("DISCORD_BOT_TOKEN 环境变量未设置")
	}

	// 创建客户端
	client, err := disgo.New(token,
		bot.WithGatewayConfigOpts(
			gateway.WithIntents(
				gateway.IntentGuilds,
				gateway.IntentGuildMessages,
				gateway.IntentDirectMessages,
			),
		),
	)
	if err != nil {
		log.Fatal("创建客户端失败:", err)
	}

	// 添加事件监听器
	client.AddEventListeners(&events.ListenerAdapter{
		OnMessageCreate: func(event *events.MessageCreateEvent) {
			handleMessageCreate(client, event)
		},
	})

	// 连接到Discord
	if err = client.Connect(); err != nil {
		log.Fatal("连接Discord失败:", err)
	}

	log.Println("机器人已上线! 按Ctrl+C退出")
	select {} // 保持程序运行
}

func handleMessageCreate(client bot.Client, event *events.MessageCreateEvent) {
	// 忽略机器人自己的消息
	if event.Message.Author.Bot {
		return
	}

	// 如果消息内容是"!ping"，回复"pong!"
	if event.Message.Content == "!ping" {
		_, _ = client.Rest().Channels().CreateMessage(event.ChannelID, discord.NewMessageCreateBuilder().
			SetContent("pong!").
			Build(),
		)
	}
}

2. 发送消息

func sendMessage(client bot.Client, channelID discord.Snowflake, content string) {
	// 创建消息构建器
	messageBuilder := discord.NewMessageCreateBuilder().
		SetContent(content).
		AddActionRow(
			discord.NewPrimaryButton("点击我", "button_click"),
		)

	// 发送消息
	message, err := client.Rest().Channels().CreateMessage(channelID, messageBuilder.Build())
	if err != nil {
		log.Printf("发送消息失败: %v", err)
		return
	}
	log.Printf("消息已发送: %s", message.ID)
}

3. 处理按钮交互

client.AddEventListeners(&events.ListenerAdapter{
	OnButtonInteraction: func(event *events.ButtonInteractionEvent) {
		if event.Data.CustomID == "button_click" {
			_ = event.CreateMessage(discord.NewMessageCreateBuilder().
				SetContent("你点击了按钮!").
				SetEphemeral(true).
				Build(),
			)
		}
	},
})

高级功能示例

1. 创建Slash命令

func registerCommands(client bot.Client, guildID discord.Snowflake) {
	// 定义命令
	commands := []discord.ApplicationCommandCreate{
		{
			Name:        "hello",
			Description: "打招呼",
			Options: []discord.ApplicationCommandOption{
				{
					Name:        "name",
					Description: "你的名字",
					Type:        discord.ApplicationCommandOptionTypeString,
					Required:    true,
				},
			},
		},
	}

	// 注册命令
	_, err := client.Rest().Applications().CreateGuildCommands(
		client.ApplicationID(),
		guildID,
		commands...,
	)
	if err != nil {
		log.Printf("注册命令失败: %v", err)
	}
}

// 处理Slash命令
client.AddEventListeners(&events.ListenerAdapter{
	OnApplicationCommandInteraction: func(event *events.ApplicationCommandInteractionEvent) {
		if event.Data.Name == "hello" {
			name := event.Data.Options[0].Value.(string)
			_ = event.CreateMessage(discord.NewMessageCreateBuilder().
				SetContentf("你好, %s!", name).
				Build(),
			)
		}
	},
})

2. 处理消息组件

// 创建带有下拉菜单的消息
func createSelectMenuMessage(client bot.Client, channelID discord.Snowflake) {
	selectMenu := discord.NewStringSelectMenu("food_select", "选择你喜欢的食物").
		AddOptions(
			discord.NewStringSelectMenuOption("披萨", "pizza").
				WithDescription("美味的披萨").
				WithEmoji(discord.Emoji{Name: "🍕"}),
			discord.NewStringSelectMenuOption("汉堡", "hamburger").
				WithDescription("多汁的汉堡").
				WithEmoji(discord.Emoji{Name: "🍔"}),
		)

	messageBuilder := discord.NewMessageCreateBuilder().
		SetContent("请选择你喜欢的食物:").
		AddActionRow(selectMenu)

	_, _ = client.Rest().Channels().CreateMessage(channelID, messageBuilder.Build())
}

// 处理下拉菜单选择
client.AddEventListeners(&events.ListenerAdapter{
	OnStringSelectInteraction: func(event *events.StringSelectInteractionEvent) {
		if event.Data.CustomID == "food_select" {
			selected := event.Data.Values[0]
			var response string
			
			switch selected {
			case "pizza":
				response = "🍕 披萨是个好选择!"
			case "hamburger":
				response = "🍔 汉堡也很棒!"
			default:
				response = "谢谢你的选择!"
			}
			
			_ = event.CreateMessage(discord.NewMessageCreateBuilder().
				SetContent(response).
				Build(),
			)
		}
	},
})

最佳实践

1. 错误处理：始终检查API调用返回的错误
2. 速率限制：disgo会自动处理Discord的速率限制，但要注意不要过于频繁地发送请求
3. 意图(Intents)：只请求必要的意图以减少带宽使用
4. 状态管理：disgo会缓存状态，对于大型服务器可能需要调整缓存设置
5. 日志记录：配置日志记录以调试问题

总结

disgo 提供了强大而简洁的接口来与 Discord API 交互。通过合理使用其功能，你可以构建出功能丰富的 Discord 机器人。本文介绍了基本消息处理、交互组件和Slash命令等核心功能，你可以在此基础上扩展更复杂的功能。