discord example app
1.0.0
Dieses Projekt enthält eine grundlegende Discord-App im Rock-Paper-Scissors-im Stil, die in JavaScript geschrieben wurde und für die Erste Schritte erstellt wurde.
Unten finden Sie einen grundlegenden Überblick über die Projektstruktur:
├── examples -> short, feature-specific sample apps │ ├── app.js -> finished app.js code │ ├── button.js │ ├── command.js │ ├── modal.js │ ├── selectMenu.js ├── .env.sample -> sample .env file ├── app.js -> main entrypoint for app ├── commands.js -> slash command payloads + helpers ├── game.js -> logic specific to RPS ├── utils.js -> utility functions and enums ├── package.json ├── README.md └── .gitignore
Bevor Sie beginnen, müssen Sie NodeJs installieren und eine Discord -App mit den richtigen Berechtigungen erstellen:
applications.commands
bot (mit aktivierten Senden von Nachrichten)
Das Konfigurieren der App wird im Handbuch für Erste ausführlich behandelt.
Zuerst das Projekt klonen:
git clone https://github.com/discord/discord-example-app.git
Navigieren Sie dann zu seinem Verzeichnis und installieren Sie Abhängigkeiten:
cd discord-example-app npm install
Holen Sie sich die Anmeldeinformationen aus den Einstellungen Ihrer App und fügen Sie sie einer .env -Datei hinzu (siehe .env.sample für ein Beispiel). Sie benötigen Ihre App -ID ( APP_ID ), Bot Token ( DISCORD_TOKEN ) und Public Key ( PUBLIC_KEY ).
Das Abrufen von Anmeldeinformationen wird im Ersten Anleitungen ausführlich behandelt.
Umgebungsvariablen können in die
.env-Datei in Glitch oder bei der lokalen Entwicklung und in der Registerkarte Secrets in Replit (das Schlossymbol links) hinzugefügt werden.
Die Befehle für die Beispiel -App sind in commands.js eingerichtet. Alle Befehle im ALL_COMMANDS -Array am Ende der commands.js werden installiert, wenn Sie den in package.json konfigurierten register ausführen.
npm run register
Nachdem Ihre Anmeldeinformationen hinzugefügt wurden, führen Sie die App aus:
node app.js
Ein Paket wie
nodemon, das Ihre App nach lokalen Änderungen beobachtet und neu startet, ist möglicherweise hilfreich, während Sie sich lokal entwickeln.
Wenn Sie nicht dem Handbuch für Erste Schritte folgen, können Sie den Inhalt von examples/app.js (die fertige app.js Datei) in die oberste app.js verschieben.
Das Projekt benötigt einen öffentlichen Endpunkt, an dem Discord Anfragen senden kann. Um sich lokal zu entwickeln und zu testen, können Sie so etwas wie ngrok zum Tunnel -HTTP -Verkehr verwenden.
Installieren Sie NGROK, wenn Sie es noch nicht getan haben, und hören Sie an Port 3000 an:
ngrok http 3000
Sie sollten Ihre Verbindung offen sehen:
Tunnel Status online Version 2.0/2.0 Web Interface http://127.0.0.1:4040 Forwarding https://1234-someurl.ngrok.io -> localhost:3000 Connections ttl opn rt1 rt5 p50 p90 0 0 0.00 0.00 0.00 0.00
Kopieren Sie die Weiterleitungsadresse, die mit https beginnt, in diesem Fall https://1234-someurl.ngrok.io , dann gehen Sie zu den Einstellungen Ihrer App.
Auf der Registerkarte Allgemeine Informationen wird eine Interaktionen -Endpunkt -URL vorhanden. Fügen Sie dort Ihre NGROK-Adresse ein und fügen Sie im Beispiel die Anhängen /interactions an ( https://1234-someurl.ngrok.io/interactions ).
Klicken Sie auf Änderungen speichern , und Ihre App sollte zum Ausführen bereit sein
Lesen Sie die Dokumentation für eingehende Informationen zu API-Funktionen.
examples/
Schließen Sie sich dem Server von Discord Developers an, um Fragen zur API zu stellen, an Veranstaltungen teilzunehmen, die vom Discord API -Team gehostet werden, und interagieren mit anderen Entwicklern.
Besuchen Sie die Community-Ressourcen für sprachspezifische Tools, die von Community-Mitgliedern gepflegt werden.
