يحتوي هذا المشروع على تطبيق Discord على طراز Paper-Paper-Paper Basic مكتوب في 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 ( DISCORD_TOKEN
) والمفتاح العام ( PUBLIC_KEY
).
تتم تغطية بيانات الاعتماد الجلب بالتفصيل في دليل البدء.
يمكن إضافة متغيرات البيئة إلى ملف
.env
في خلل أو عند التطوير محليًا ، وفي علامة التبويب الأسرار في الإعادة (أيقونة القفل على اليسار).
يتم إعداد أوامر تطبيق المثال في commands.js
. register
تثبيت package.json
الأوامر في صفيف ALL_COMMANDS
في أسفل commands.js
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
في المثال).
انقر فوق حفظ التغييرات ، ويجب أن يكون تطبيقك جاهزًا للتشغيل
اقرأ الوثائق للحصول على معلومات متعمقة حول ميزات API.
تصفح examples/
المجلد في هذا المشروع للحصول على أمثلة رمز أصغر مميزة
انضم إلى خادم Discord Developers لطرح أسئلة حول API ، وحضور الأحداث التي يستضيفها فريق Discord API ، والتفاعل مع Devs الآخرين.
تحقق من موارد المجتمع للأدوات الخاصة باللغة التي يحتفظ بها أفراد المجتمع.