discord.py

discord.py

غلاف API حديث وسهل الاستخدام وغني بالميزات وغير متزامن لـ Discord مكتوب بلغة Python.

الميزات الرئيسية

• واجهة برمجة تطبيقات Pythonic الحديثة التي تستخدم async await .
• التعامل مع حد المعدل المناسب.
• الأمثل في كل من السرعة والذاكرة.

التثبيت

مطلوب بيثون 3.8 أو أعلى

لتثبيت المكتبة دون دعم صوتي كامل، يمكنك فقط تشغيل الأمر التالي:

ملحوظة

يوصى باستخدام بيئة افتراضية لتثبيت المكتبة، خاصة على نظام Linux حيث تتم إدارة نظام Python خارجيًا ويقيد الحزم التي يمكنك تثبيتها عليها.

 # Linux/macOS
python3 -m pip install -U discord.py

# Windows
py -3 -m pip install -U discord.py

بخلاف ذلك، للحصول على الدعم الصوتي، يجب عليك تشغيل الأمر التالي:

 # Linux/macOS
python3 -m pip install -U " discord.py[voice] "

# Windows
py -3 -m pip install -U discord.py[voice]

لتثبيت الإصدار التطويري، قم بما يلي:

$ git clone https://github.com/Rapptz/discord.py
$ cd discord.py
$ python3 -m pip install -U .[voice]

الحزم الاختيارية

• PyNaCl (للدعم الصوتي)

يرجى ملاحظة أنه عند تثبيت الدعم الصوتي على Linux، يجب عليك تثبيت الحزم التالية عبر مدير الحزم المفضل لديك (على سبيل المثال apt و dnf وما إلى ذلك) قبل تشغيل الأوامر المذكورة أعلاه:

• libffi-dev (أو libffi-devel في بعض الأنظمة)
• python-dev (على سبيل المثال python3.8-dev لـ Python 3.8)

مثال سريع

 import discord

class MyClient ( discord . Client ):
    async def on_ready ( self ):
        print ( 'Logged on as' , self . user )

    async def on_message ( self , message ):
        # don't respond to ourselves
        if message . author == self . user :
            return

        if message . content == 'ping' :
            await message . channel . send ( 'pong' )

intents = discord . Intents . default ()
intents . message_content = True
client = MyClient ( intents = intents )
client . run ( 'token' )

مثال بوت

 import discord
from discord . ext import commands

intents = discord . Intents . default ()
intents . message_content = True
bot = commands . Bot ( command_prefix = '>' , intents = intents )

@ bot . command ()
async def ping ( ctx ):
    await ctx . send ( 'pong' )

bot . run ( 'token' )

يمكنك العثور على المزيد من الأمثلة في دليل الأمثلة.

روابط

• التوثيق
• خادم الخلاف الرسمي
• واجهة برمجة تطبيقات الخلاف