discord example app
1.0.0
Este proyecto contiene una aplicación básica de discordia al estilo de timbres de papel de roca escrita en JavaScript, creada para la guía de inicio.
A continuación se muestra una descripción general básica de la estructura del proyecto:
├── 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
Antes de comenzar, deberá instalar NodeJS y crear una aplicación de Discord con los permisos adecuados:
applications.commands
bot (con mensajes de envío habilitado)
La configuración de la aplicación se cubre en detalle en la guía de inicio.
Primer clon el proyecto:
git clone https://github.com/discord/discord-example-app.git
Luego navegue a su directorio e instale dependencias:
cd discord-example-app npm install
Obtenga las credenciales de la configuración de su aplicación y agrégalas a un archivo .env (consulte .env.sample para obtener un ejemplo). Necesitará su ID de aplicación ( APP_ID ), Token BOT ( DISCORD_TOKEN ) y Public Key ( PUBLIC_KEY ).
Obtener credenciales se cubre en detalle en la guía de inicio.
Las variables de entorno se pueden agregar al archivo
.enven fallas o cuando se desarrollan localmente, y en la pestaña Secretos en la presentación (el icono de bloqueo a la izquierda).
Los comandos para la aplicación Ejemplo están configurados en commands.js . Todos los comandos en la matriz ALL_COMMANDS en la parte inferior de commands.js se instalarán cuando ejecute el comando register configurado en package.json :
npm run register
Después de agregar sus credenciales, continúe y ejecute la aplicación:
node app.js
Un paquete como
nodemon, que observa los cambios locales y reinicia su aplicación, puede ser útil mientras se desarrolla localmente.
Si no está siguiendo la guía de inicio, puede mover el contenido de examples/app.js (el archivo app.js terminado) a la app.js de nivel superior.
El proyecto necesita un punto final público donde Discord pueda enviar solicitudes. Para desarrollar y probar localmente, puede usar algo como el tráfico HTTP ngrok para túnel.
Instale ngrok si aún no lo ha hecho, luego comience a escuchar en el puerto 3000 :
ngrok http 3000
Deberías ver tu conexión abierta:
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
Copie la dirección de reenvío que comienza con https , en este caso https://1234-someurl.ngrok.io , luego vaya a la configuración de su aplicación.
En la pestaña Información general , habrá una URL de punto final de interacciones . Pegue su dirección NGROK allí y agregue /interactions ( https://1234-someurl.ngrok.io/interactions en el ejemplo).
Haga clic en Guardar cambios y su aplicación debe estar lista para ejecutarse
Lea la documentación para obtener información en profundidad sobre las características de la API.
Explore los examples/ carpeta en este proyecto para ejemplos de código más pequeños y específicos de características
Únase al servidor Discord Developers para hacer preguntas sobre la API, asistir a eventos organizados por el equipo de Discord API e interactuar con otros desarrolladores.
Consulte los recursos de la comunidad para las herramientas específicas del idioma mantenidas por los miembros de la comunidad.
