discord example app
1.0.0
Este projeto contém um aplicativo Discord básico-paper-scissa-scissess, escrito em JavaScript, construído para o guia para iniciar.
Abaixo está uma visão geral básica da estrutura do projeto:
├── 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 começar, você precisará instalar o NodeJS e criar um aplicativo Discord com as permissões adequadas:
applications.commands
bot (com mensagens de envio ativadas)
Configurando o aplicativo é abordado em detalhes no guia de início do início.
Primeiro clone o projeto:
git clone https://github.com/discord/discord-example-app.git
Em seguida, navegue para seu diretório e instale dependências:
cd discord-example-app npm install
Pegue as credenciais das configurações do seu aplicativo e adicione -as a um arquivo .env (consulte .env.sample para um exemplo). Você precisará do seu ID do aplicativo ( APP_ID ), token de bot ( DISCORD_TOKEN ) e chave pública ( PUBLIC_KEY ).
As credenciais de busca são abordadas em detalhes no guia de início do início.
As variáveis de ambiente podem ser adicionadas ao arquivo
.envem falhas ou ao desenvolver localmente e na guia Secrets em Replit (o ícone de bloqueio à esquerda).
Os comandos do aplicativo Exemplo são configurados em commands.js . Todos os comandos da matriz ALL_COMMANDS na parte inferior do commands.js serão instalados quando você executar o comando register configurado no package.json :
npm run register
Depois que suas credenciais forem adicionadas, vá em frente e execute o aplicativo:
node app.js
Um pacote como
nodemon, que observa alterações locais e reinicia seu aplicativo, pode ser útil durante o desenvolvimento localmente.
Se você não estiver acompanhando o guia de início, poderá mover o conteúdo de examples/app.js (o arquivo app.js acabado) para o app.js de nível superior.
O projeto precisa de um terminal público em que a discórdia possa enviar solicitações. Para desenvolver e testar localmente, você pode usar algo como ngrok para túnel tráfego HTTP.
Instale o ngrok, se você ainda não o fez, comece a ouvir na porta 3000 :
ngrok http 3000
Você deve ver sua conexão aberta:
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 o endereço de encaminhamento que começa com https , neste caso https://1234-someurl.ngrok.io , depois vá para as configurações do seu aplicativo.
Na guia Geral Informações , haverá uma URL de endpoint de interações . Cole o seu endereço NGROK lá e anexar /interactions a ele ( https://1234-someurl.ngrok.io/interactions no exemplo).
Clique em Salvar alterações e seu aplicativo deve estar pronto para executar
Leia a documentação para obter informações detalhadas sobre os recursos da API.
Navegue pelos examples/ pasta neste projeto para exemplos de código menores e específicos de recursos
Junte -se ao Discord Developers Server para fazer perguntas sobre a API, participar de eventos hospedados pela equipe da Discord API e interagir com outros desenvolvedores.
Confira os recursos da comunidade para ferramentas específicas de idiomas mantidas pelos membros da comunidade.
