โครงการนี้มีแอพ Discord-style-style-scissors พื้นฐานที่เขียนด้วย 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
), Bot Token ( DISCORD_TOKEN
) และคีย์สาธารณะ ( PUBLIC_KEY
)
การดึงข้อมูลรับรองจะครอบคลุมรายละเอียดในคู่มือการเริ่มต้นใช้งาน
ตัวแปรสภาพแวดล้อมสามารถเพิ่มลงในไฟล์
.env
ในความผิดพลาดหรือเมื่อพัฒนาในพื้นที่และในแท็บความลับในการแก้ไข (ไอคอนล็อคทางด้านซ้าย)
คำสั่งสำหรับแอปตัวอย่างถูกตั้งค่าใน commands.js
js คำสั่งทั้งหมดในอาร์เรย์ ALL_COMMANDS
ที่ด้านล่างของ commands.js
จะติดตั้งเมื่อคุณเรียกใช้คำสั่ง register
ที่กำหนดค่าใน package.json
:
npm run register
หลังจากเพิ่มข้อมูลรับรองของคุณไปข้างหน้าและเรียกใช้แอพ:
node app.js
แพ็คเกจเช่น
nodemon
ซึ่งดูการเปลี่ยนแปลงในท้องถิ่นและรีสตาร์ทแอปของคุณอาจเป็นประโยชน์ในขณะที่พัฒนาในท้องถิ่น
หากคุณไม่ได้ติดตามคู่มือการเริ่มต้นใช้งานคุณสามารถย้ายเนื้อหาของ examples/app.js
(ไฟล์ app.js
เสร็จแล้ว) ไปยัง app.js
ระดับบนสุด
โครงการต้องการจุดสิ้นสุดสาธารณะที่ Discord สามารถส่งคำขอได้ ในการพัฒนาและทดสอบในพื้นที่คุณสามารถใช้บางอย่างเช่น ngrok
เพื่อรับสัญญาณ HTTP Tunnel
ติดตั้ง 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 endpoint endpoint วางที่อยู่ NGROK ของคุณที่นั่นและผนวก /interactions
กับมัน ( https://1234-someurl.ngrok.io/interactions
ในตัวอย่าง)
คลิก บันทึกการเปลี่ยนแปลง และแอพของคุณควรพร้อมที่จะเรียกใช้
อ่าน เอกสาร สำหรับข้อมูลเชิงลึกเกี่ยวกับคุณสมบัติ API
เรียกดู examples/
โฟลเดอร์ในโครงการนี้สำหรับตัวอย่างรหัสขนาดเล็กและเฉพาะคุณสมบัติ
เข้าร่วม เซิร์ฟเวอร์ Discord Developers เพื่อถามคำถามเกี่ยวกับ API เข้าร่วมกิจกรรมที่โฮสต์โดยทีม Discord API และโต้ตอบกับ devs อื่น ๆ
ตรวจสอบ ทรัพยากรชุมชน สำหรับเครื่องมือเฉพาะภาษาที่ดูแลโดยสมาชิกชุมชน