discord example app

Memulai Aplikasi untuk Perselisihan

Proyek ini berisi aplikasi perselisihan dasar-kertas-gerak-Scissors yang ditulis dalam JavaScript, dibangun untuk panduan memulai.

Struktur proyek

Di bawah ini adalah gambaran dasar dari struktur proyek:

├── 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

Menjalankan aplikasi secara lokal

Sebelum Anda mulai, Anda harus menginstal nodeJ dan membuat aplikasi perselisihan dengan izin yang tepat:

• applications.commands

• bot (dengan pesan kirim diaktifkan)

Mengkonfigurasi aplikasi dibahas secara detail dalam panduan memulai.

Proyek Pengaturan

Klon pertama proyek:

git clone https://github.com/discord/discord-example-app.git

Kemudian arahkan ke direktori dan instal dependensi:

cd discord-example-app
npm install

Dapatkan kredensial aplikasi

Ambil kredensial dari pengaturan aplikasi Anda dan tambahkan ke file .env (lihat .env.sample untuk contoh). Anda akan memerlukan ID Aplikasi Anda ( APP_ID ), Bot Token ( DISCORD_TOKEN ), dan Public Key ( PUBLIC_KEY ).

Mengambil kredensial dibahas secara rinci dalam panduan memulai.

Variabel lingkungan dapat ditambahkan ke file .env dalam kesalahan atau saat berkembang secara lokal, dan di tab Rahasia di Replit (ikon kunci di sebelah kiri).

Instal perintah slash

Perintah untuk aplikasi contoh diatur di commands.js . Semua perintah dalam array ALL_COMMANDS di bagian bawah commands.js akan diinstal saat Anda menjalankan perintah register yang dikonfigurasi dalam package.json :

npm run register

Jalankan aplikasi

Setelah kredensial Anda ditambahkan, lanjutkan dan jalankan aplikasi:

node app.js

Paket seperti nodemon , yang menonton perubahan lokal dan memulai kembali aplikasi Anda, mungkin bermanfaat saat berkembang secara lokal.

Jika Anda tidak mengikuti panduan memulai, Anda dapat memindahkan konten examples/app.js (file app.js yang sudah jadi) ke app.js tingkat atas.

Siapkan interaktivitas

Proyek membutuhkan titik akhir publik di mana perselisihan dapat mengirim permintaan. Untuk mengembangkan dan menguji secara lokal, Anda dapat menggunakan sesuatu seperti ngrok untuk lalu lintas HTTP terowongan.

Instal Ngrok jika Anda belum melakukannya, lalu mulai mendengarkan di port 3000 :

ngrok http 3000

Anda harus melihat koneksi Anda terbuka:

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

Salin alamat penerusan yang dimulai dengan https , dalam hal ini https://1234-someurl.ngrok.io , lalu buka pengaturan aplikasi Anda.

Pada tab Informasi Umum , akan ada URL titik akhir interaksi . Tempel alamat NGROK Anda di sana, dan tambahkan /interactions padanya ( https://1234-someurl.ngrok.io/interactions dalam contoh).

Klik Simpan Perubahan , dan aplikasi Anda harus siap untuk dijalankan

Sumber daya lainnya

• Baca dokumentasi untuk informasi mendalam tentang fitur API.

• Jelajahi examples/ folder dalam proyek ini untuk contoh kode yang lebih kecil dan spesifik fitur

• Bergabunglah dengan Server Pengembang Discord untuk mengajukan pertanyaan tentang API, menghadiri acara yang diselenggarakan oleh Tim API Discord, dan berinteraksi dengan devs lain.

• Lihatlah sumber daya masyarakat untuk alat khusus bahasa yang dikelola oleh anggota masyarakat.