該項目包含一個用JavaScript編寫的基本岩石紙紙式的Discord應用程序,該應用程序為入門指南構建。
以下是項目結構的基本概述:
├── 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
)。您將需要您的應用ID( APP_ID
),BOT令牌( DISCORD_TOKEN
)和public鍵( PUBLIC_KEY
)。
獲取憑據在“入門指南”中詳細介紹。
環境變量可以添加到小故障或本地開發時的
.env
文件,以及在REPLIT中的“秘密”選項卡(左側的鎖定圖標)中。
示例應用程序的命令是在commands.js
中設置的。當您在package.json
:json ALL_COMMANDS
json commands.js
register
:json:
npm run register
添加憑據後,繼續運行應用程序:
node app.js
在本地開發時,像
nodemon
這樣的軟件包可以觀看本地更改並重新啟動您的應用程序。
如果您不遵循“入門指南”,則可以將examples/app.js
(完成的app.js
文件)的內容移至頂級app.js
該項目需要一個公共端點,不在,在該點可以發送請求。要在本地開發和測試,您可以使用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
in示例中)。
單擊“保存更改” ,您的應用程序應準備好運行
閱讀文檔以獲取有關API功能的深入信息。
在此項目中瀏覽examples/
文件夾以獲取較小的特定特征代碼示例
加入Discord Developers Server ,詢問有關API的問題,參加Discord API團隊主持的活動,並與其他開發人員進行互動。
查看社區資源,以獲取社區成員維護的特定語言工具。