Bruce Marriner e0c0dd8c02 Updates to Ping Pong bot. | 8 роки тому | |
---|---|---|
examples | 8 роки тому | |
.travis.yml | 9 роки тому | |
LICENSE | 9 роки тому | |
README.md | 8 роки тому | |
discord.go | 8 роки тому | |
discord_test.go | 8 роки тому | |
endpoints.go | 8 роки тому | |
events.go | 8 роки тому | |
message.go | 8 роки тому | |
oauth2.go | 8 роки тому | |
oauth2_test.go | 8 роки тому | |
restapi.go | 8 роки тому | |
restapi_test.go | 8 роки тому | |
state.go | 8 роки тому | |
structs.go | 8 роки тому | |
util.go | 8 роки тому | |
voice.go | 8 роки тому | |
wsapi.go | 8 роки тому |
DiscordGo is a Go package that provides low level bindings to the Discord chat client API. DiscordGo has nearly complete support for all of the Discord JSON-API endpoints, websocket interface, and voice interface.
See dgVoice package to extend DiscordGo with additional voice helper functions and features.
See dca for an experimental stand alone
tool that wraps ffmpeg
to create opus encoded audio appropriate for use with
Discord (and DiscordGo)
Join #go_discordgo Discord chat channel for support.
The master branch represents the latest released version of DiscordGo. This branch will always have a stable and tested version of the library. Each release is tagged and you can easily download a specific release and view release notes on the github releases page.
The develop branch is where all development happens and almost always has new features over the master branch. However breaking changes are frequently added to develop and even sometimes bugs are introduced. Bugs get fixed and the breaking changes get documented before pushing to master.
So, what should you use?
If you can accept the constant changing nature of develop then it is the recommended branch to use. Otherwise, if you want to tail behind development slightly and have a more stable package with documented releases then use master
DiscordGo has been tested to compile on Debian 8 (Go 1.3.3), FreeBSD 10 (Go 1.5.1), and Windows 7 (Go 1.5.2).
This assumes you already have a working Go environment, if not please see this page first.
go get
will always pull the latest released version from the master branch.
go get github.com/bwmarrin/discordgo
If you want to use the develop branch, follow these steps next.
cd $GOPATH/src/github.com/bwmarrin/discordgo
git checkout develop
Import the package into your project.
import "github.com/bwmarrin/discordgo"
Construct a new Discord client which can be used to access the variety of Discord API functions and to set callback functions for Discord events.
discord, err := discordgo.New("username", "password")
See Documentation and Examples below for more detailed information.
NOTICE : This library and the Discord API are unfinished. Because of that there may be major changes to library functions, constants, and structures.
The DiscordGo code is fairly well documented at this point and is currently the only documentation available. Both GoDoc and GoWalker (below) present that information in a nice format.
Below is a list of examples and other projects using DiscordGo. Please submit an issue if you would like your project added or removed from this list
For help with common problems please reference the Troubleshooting section of the project wiki.
Contributions are very welcomed, however please follow the below guidelines.
See this chart for a feature comparison and list of other Discord API libraries.