discord example app
1.0.0
Ce projet contient une application Discord de style rock papier rock-papier-scissors écrit en javascript, conçue pour le guide de démarrage.
Vous trouverez ci-dessous un aperçu de base de la structure du projet:
├── 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
Avant de commencer, vous devrez installer NodeJS et créer une application Discord avec les autorisations appropriées:
applications.commands
bot (avec les messages d'envoi activés)
La configuration de l'application est couverte en détail dans le guide de démarrage.
Premier cloner le projet:
git clone https://github.com/discord/discord-example-app.git
Accédez ensuite à son répertoire et installez les dépendances:
cd discord-example-app npm install
Remplissez les informations d'identification des paramètres de votre application et ajoutez-les à un fichier .env (voir .env.sample pour un exemple). Vous aurez besoin de votre ID d'application ( APP_ID ), de Bot Token ( DISCORD_TOKEN ) et de la clé publique ( PUBLIC_KEY ).
La récupération des informations d'identification est couverte en détail dans le guide de démarrage.
Des variables d'environnement peuvent être ajoutées au fichier
.envdans Glitch ou lors du développement localement, et dans l'onglet Secrets dans Replit (l'icône de verrouillage à gauche).
Les commandes de l'exemple d'application sont configurées dans commands.js . Toutes les commandes du tableau ALL_COMMANDS en bas de commands.js seront installées lorsque vous exécutez la commande register configurée dans package.json :
npm run register
Une fois vos informations d'identification ajoutées, allez-y et exécutez l'application:
node app.js
Un package comme
nodemon, qui regarde pour les modifications locales et redémarre votre application, peut être utile pendant le développement local.
Si vous ne suivez pas le Guide de démarrage, vous pouvez déplacer le contenu des examples/app.js (le fichier app.js fini) sur app.js de niveau supérieur.
Le projet a besoin d'un point de terminaison public où Discord peut envoyer des demandes. Pour développer et tester localement, vous pouvez utiliser quelque chose comme ngrok pour tunnel le trafic HTTP.
Installez ngrok si vous ne l'avez pas déjà fait, commencez à écouter sur le port 3000 :
ngrok http 3000
Vous devriez voir votre connexion ouverte:
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
Copiez l'adresse de transfert qui commence par https , dans ce cas https://1234-someurl.ngrok.io , puis accédez aux paramètres de votre application.
Sur l'onglet Informations générales , il y aura une URL de point de terminaison d'interactions . Collez votre adresse NGROK là-bas et appelez /interactions à elle ( https://1234-someurl.ngrok.io/interactions dans l'exemple).
Cliquez sur Enregistrer les modifications et votre application doit être prête à fonctionner
Lisez la documentation pour des informations détaillées sur les fonctionnalités de l'API.
Parcourez les examples/ dossiers de ce projet pour des exemples de code plus petits et spécifiques à des fonctionnalités
Rejoignez le serveur Discord Developers pour poser des questions sur l'API, assister aux événements organisés par l'équipe API Discord et interagir avec d'autres développeurs.
Consultez les ressources communautaires pour les outils spécifiques à la langue maintenus par les membres de la communauté.
