discord example app
1.0.0
Этот проект содержит базовое приложение Discord в стиле рок-бумаги, написанное в JavaScript, созданном для руководства по началу работы.
Ниже приведен базовый обзор структуры проекта:
├── 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
Перед началом вам нужно будет установить Nodejs и создать приложение Discord с правильными разрешениями:
applications.commands
bot (с включенными сообщениями отправки)
Настройка приложения подробно описана в руководстве по началу работы.
Сначала клонировать проект:
git clone https://github.com/discord/discord-example-app.git
Затем перейдите к его каталогу и установите зависимости:
cd discord-example-app npm install
Извлеките учетные данные из настройки вашего приложения и добавьте их в файл .env (см. Пример .env.sample ). Вам понадобится идентификатор вашего приложения ( APP_ID ), токен бот ( DISCORD_TOKEN ) и открытый ключ ( PUBLIC_KEY ).
Извлечение учетных данных подробно рассматривается в руководстве по началу работы.
Переменные среды могут быть добавлены в файл
.envв сбою или при разработке локально, а на вкладке Secrets в repit (значок блокировки слева).
Команды для примера приложения настроены в commands.js . Все команды в массиве ALL_COMMANDS в нижней register commands.js package.json
npm run register
После того, как ваши учетные данные будут добавлены, продолжайте и запустите приложение:
node app.js
Пакет, такой как
nodemon, который наблюдает за локальными изменениями и перезапускает ваше приложение, может быть полезен во время развития на местном уровне.
Если вы не следуете руководству по началу работы, вы можете переместить содержимое examples/app.js (файл готового app.js ) в app.js верхнего уровня.
Проект нуждается в общедоступной конечной точке, где Discord может отправлять запросы. Чтобы разработать и тестировать локально, вы можете использовать что -то вроде ngrok для туннеля HTTP -трафика.
Установите Ngrok, если вы еще этого не сделали, тогда начните прослушивание на порту 3000 :
ngrok http 3000
Вы должны увидеть открытое соединение:
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
Скопируйте адрес пересылки, который начинается с https , в данном случае https://1234-someurl.ngrok.io , затем перейдите в настройки вашего приложения.
На вкладке «Общая информация» будет установлен URL -адрес конечной точки взаимодействия . Вставьте туда свой адрес NGROK и добавьте /interactions с ним ( https://1234-someurl.ngrok.io/interactions в примере).
Нажмите «Сохранить изменения» , и ваше приложение должно быть готово к запуску
Прочитайте документацию для подробной информации об функциях API.
Просмотрите examples/ папку в этом проекте для небольших примеров кода, специфичных для функций
Присоединяйтесь к серверу Discord Developers, чтобы задать вопросы об API, посещать мероприятия, организованные командой Discord API, и взаимодействовать с другими разработками.
Проверьте ресурсы сообщества для инструментов для конкретных языков, поддерживаемых членами сообщества.
