Discord
مضمّن في Macro Deckاكتم الميكروفون والسماع، وانضم إلى القنوات الصوتية، وغيّر إعدادات الصوت، وانشر رسائل Webhook في Discord من لوحتك.
نافذة ربط Discord مع حقلي معرّف العميل والسر الخاص بالعميل
- أزرار كتم الميكروفون والسماع تعرض حالتك الفعلية
- الانضمام إلى القنوات الصوتية أو مغادرتها وفتح القنوات النصية
- ضبط مستوى صوت الميكروفون والإخراج ووضع الصوت ومعالجة الصوت
- عرض نشاط Rich Presence مخصّص في ملفك الشخصي
- نشر رسائل وعناصر مضمّنة (embeds) في قناة عبر Webhook
يربط تكامل Discord بين Macro Deck وتطبيق Discord الرسمي لسطح المكتب على الحاسوب نفسه. يستخدم واجهة RPC المحلية في Discord، وهي الواجهة نفسها التي يتيحها Discord للتطبيقات التي تتحكم في العميل، فتعمل أزرارك كما لو أنك نقرت في Discord بنفسك. لا يمنح Discord هذا الوصول إلا للتطبيقات التي تملكها، لذلك يطلب منك الإعداد إنشاء تطبيق مجاني في Discord Developer Portal وتفويضه مرة واحدة.
ما يمكنك فعله
- كتم ميكروفونك أو كتم السماع باستخدام كتم الميكروفون وكتم السماع. يعرض الزر ما إذا كنت مكتومًا، حتى عندما تكتم الصوت في Discord نفسه.
- الانضمام إلى قناة صوتية في أحد خوادمك، أو مغادرة القناة الحالية، أو فتح قناة نصية في تطبيق Discord.
- ضبط مستوى صوت الميكروفون والإخراج أو رفعه أو خفضه، والتبديل بين الضغط للتحدث والنشاط الصوتي، وتشغيل قمع الضوضاء القياسي وإلغاء الصدى والتحكم التلقائي في الكسب أو إيقافها.
- عرض نشاط مخصّص في ملفك الشخصي باستخدام تعيين الحالة الغنية، وإزالته مجددًا باستخدام مسح الحالة الغنية.
- نشر رسالة، مع عنصر مضمّن اختياري، في أي قناة عبر Webhook باستخدام تنفيذ Webhook. يعمل هذا الإجراء دون إعداد التكامل، ما دام التكامل مفعّلًا.
بعض الأمثلة على الإعدادات:
- زر Mic مع كتم الميكروفون في وضع تبديل، يتبع لونه المتغير
discord_is_self_muted. - زر ينضم إلى القناة الصوتية لفريقك مع تفعيل انقلني إذا كنت متصلًا بالفعل، فيعمل أيضًا وأنت في قناة أخرى.
- تدفق على المشغّل تم إسكات الميكروفون يشغّل ضوءًا أحمر، وآخر على الميكروفون يعمل يطفئه مجددًا.
- زر ينشر "Stream is live" مع رابط قناتك عبر Webhook.
كيف يعمل
يتصل Macro Deck بـ Discord عند بدء تشغيله، ويعيد الاتصال تلقائيًا عندما تغلق Discord وتعيد فتحه، منتظرًا مدة أطول قليلًا بعد كل محاولة فاشلة، حتى دقيقة واحدة. ينطلق المشغّلان متصل وغير متصل عند حدوث ذلك. وما دام Discord غير متصل، تظهر المتغيرات غير متاحة، باستثناء discord_is_connected. تظهر التغييرات التي تجريها في Discord، وحالات الكتم التي يفرضها مشرف، في المتغيرات والمشغّلات فورًا. يمكنك إعداد حساب Discord واحد.
ما تحتاج إليه
- تطبيق Discord الرسمي لسطح المكتب، يعمل على الحاسوب نفسه الذي يعمل عليه Macro Deck. على Linux، تعمل نسختا Flatpak وSnap أيضًا.
- حساب Discord وتطبيق مجاني خاص بك في Discord Developer Portal.
- تشغيل Macro Deck وDiscord بالصلاحيات نفسها (لا أحد منهما كمسؤول، أو كلاهما).
- لـ تنفيذ Webhook فقط: عنوان URL لـ Webhook من قناة. يحتاج إلى تفعيل التكامل، لكن دون أي إعداد.
خطوات الإعداد
الخطوة 1: أنشئ تطبيق Discord
افتح Discord Developer Portal وأنشئ تطبيقًا جديدًا. لا يهم الاسم. انسخ Application ID من General Information: هذا هو معرّف العميل.
الخطوة 2: أضف عنوان إعادة التوجيه وانسخ السر
في تطبيقك، افتح OAuth2. أضف
http://localhost/كعنوان إعادة توجيه واحفظ. لا يُفتح هذا العنوان أبدًا، إذ يتحقق Discord فقط من أنه مسجّل. ثم انسخ Client Secret (أعد تعيينه إذا لم يعرضه Discord).الخطوة 3: افتح Discord في Macro Deck
تأكد من أن تطبيق Discord لسطح المكتب يعمل. في Macro Deck، انقر التكاملات في الشريط الجانبي ثم انقر Discord.
الخطوة 4: أدخل معرّف العميل والسر الخاص بالعميل
في علامة التبويب نظرة عامة، انقر إعداد في قسم الإعدادات. يفتح تشغيل المفتاح في أعلى اليسار النافذة نفسها. في نافذة ربط Discord، الصق معرّف العميل والسر الخاص بالعميل وانقر متابعة.
الخطوة 5: فوّض في Discord
في خطوة التفويض في Discord، انقر متابعة. يعرض Discord طلب تفويض لتطبيقك: اقبله. يحفظ Macro Deck الاتصال باسم Discord مع اسم المستخدم الخاص بك بين قوسين، ويفعّل التكامل.
الخطوة 6: أضف إجراءً إلى زر
في صفحة اللوحة، انقر زرًا. يجب أن تكون اللوحة غير مقفلة: إذا ظهر الزر قفل في أعلى اليسار، فهي غير مقفلة. يُفتح المحرر مع تحديد ضغطة قصيرة. انقر + إضافة إجراء، واختر Discord على يمين نافذة إضافة إجراء، ثم اختر كتم الميكروفون واضبط الإجراء على تبديل.
الخطوة 7: اضغط الزر
اضغط الزر على لوحتك. يكتم Discord ميكروفونك، ويعرض الزر حالة الكتم حتى تلغيه، من اللوحة أو في Discord.
الإجراءات14
ضعها على زر أو شغّلها من تدفق.
- كتم الميكروفون
- يكتم ميكروفونك أو يلغي كتمه أو يبدّل حالته.
- كتم السماع
- يكتم السماع أو يلغيه أو يبدّل حالته.
- قمع الضوضاء القياسي
- يشغّل قمع الضوضاء القياسي في Discord أو يوقفه. لا يمكنه التحكم في Krisp.
- إلغاء الصدى
- يشغّل إلغاء الصدى في Discord أو يوقفه.
- التحكم التلقائي في الكسب
- يشغّل التحكم التلقائي في الكسب أو يوقفه.
- تعيين وضع الصوت
- يبدّل إلى الضغط للتحدث أو إلى النشاط الصوتي، أو يتنقل بينهما.
- ضبط مستوى الميكروفون
- يضبط مستوى صوت الميكروفون في Discord أو يرفعه أو يخفضه.
- ضبط مستوى الإخراج
- يضبط مستوى صوت الإخراج في Discord أو يرفعه أو يخفضه، حتى 200%.
- الانضمام إلى قناة صوتية
- يصلك بقناة صوتية في أحد خوادمك، مع إمكانية نقلك من قناة أخرى.
- مغادرة القناة الصوتية
- يفصلك عن القناة الصوتية الحالية.
- فتح قناة نصية
- يفتح قناة نصية في تطبيق Discord.
- تعيين الحالة الغنية
- يعرض في ملفك الشخصي نشاطًا مخصّصًا (يلعب أو يستمع إلى أو يشاهد أو يتنافس في) مع التفاصيل والصور والوقت المنقضي.
- مسح الحالة الغنية
- يزيل النشاط الذي عيّنه Macro Deck في ملفك الشخصي.
- تنفيذ Webhook
- يرسل رسالة، مع عنصر مضمّن اختياري، إلى قناة عبر عنوان URL لـ Webhook. يعمل دون إعداد.
المشغّلات18
يمكن لزر أو تدفق أن يستجيب لهذه الأحداث.
- متصل
- اتصل Macro Deck بتطبيق Discord.
- غير متصل
- أُغلق تطبيق Discord أو انقطع الاتصال.
- تم كتم الميكروفون
- كتمت ميكروفونك بنفسك.
- تم إلغاء كتم الميكروفون
- ألغيت كتم ميكروفونك بنفسك.
- تم كتم السماع
- كتمت السماع بنفسك.
- تم إلغاء كتم السماع
- ألغيت كتم السماع بنفسك.
- كتم الصوت من الخادم
- كتم مشرف صوتك.
- إلغاء كتم الصوت من الخادم
- ألغى مشرف كتم صوتك.
- كتم السماع من الخادم
- كتم مشرف السماع لديك.
- إلغاء كتم السماع من الخادم
- ألغى مشرف كتم السماع لديك.
- تم إسكات الميكروفون
- توقف ميكروفونك عن الإرسال لأي سبب: كتم الصوت أو السماع منك أو من مشرف.
- الميكروفون يعمل
- يستطيع ميكروفونك الإرسال مجددًا: لا يوجد كتم للصوت ولا للسماع.
- الانضمام إلى قناة صوتية
- انضممت إلى قناة صوتية، ويمكن قصره على قناة محددة.
- مغادرة قناة صوتية
- غادرت قناة صوتية، ويمكن قصره على قناة محددة.
- تغيّرت حالة الاتصال الصوتي
- تغيّرت حالة الاتصال الصوتي في Discord، مثلًا إلى
VOICE_CONNECTED، مع متوسط زمن الاستجابة. - بدأ شخص بالتحدث
- بدأ شخص في قناتك الصوتية الحالية بالتحدث، مع بيان ما إذا كان أنت.
- توقّف شخص عن التحدث
- توقف شخص في قناتك الصوتية الحالية عن التحدث، مع بيان ما إذا كان أنت.
- تم استلام إشعار
- عرض Discord إشعارًا على سطح المكتب، مع عنوانه ونصه.
المتغيرات11
اعرض هذه القيم على الأزرار والأدوات، أو استخدمها في الشروط.
discord_is_connected- ما إذا كان Macro Deck متصلًا بتطبيق Discord.
discord_user_name- اسم الحساب المتصل.
discord_is_self_muted,discord_is_self_deafened- ما إذا كتمت صوتك أو السماع بنفسك.
discord_is_server_muted,discord_is_server_deafened- ما إذا كتم مشرف صوتك أو السماع لديك.
discord_is_muted,discord_is_deafened- ما إذا كان صوتك أو السماع مكتومًا لأي سبب.
discord_is_speaking- ما إذا كنت تتحدث الآن.
discord_is_in_voice_channel,discord_voice_channel,discord_voice_server- ما إذا كنت في قناة صوتية، واسما القناة وخادمها.
discord_voice_connection_state,discord_voice_ping- حالة الاتصال الصوتي ومتوسط زمن استجابته بالمللي ثانية.
discord_input_volume,discord_output_volume- مستوى صوت الإدخال والإخراج في Discord بالنسبة المئوية. يمكنك أيضًا ضبطهما، مثلًا بمنزلق.
discord_voice_mode- ما إذا كان Discord يستخدم الضغط للتحدث أو النشاط الصوتي.
discord_noise_suppression,discord_echo_cancellation,discord_automatic_gain_control- ما إذا كان قمع الضوضاء وإلغاء الصدى والتحكم التلقائي في الكسب مفعّلة.
الأسئلة الشائعة
لماذا أحتاج إلى تطبيق Discord خاص بي؟
لا يمنح Discord أذونات التحكم في العميل إلا للتطبيقات التي تكون ضمن فريقها. تطبيقك الخاص مجاني، ولا يستخدم Macro Deck معرّف العميل والسر الخاص بالعميل الخاصين به إلا للتفويض لدى Discord.
هل يعمل مع Vesktop أو Legcord أو عملاء Discord الآخرين؟
لا. يمكن لعملاء الجهات الخارجية مشاركة نشاط الألعاب، لكن Macro Deck لا يستطيع التحكم فيها. شغّل تطبيق Discord الرسمي لسطح المكتب؛ ويمكن أن يبقى العميل الآخر يعمل بجانبه.
هل يعمل عندما يكون Discord على حاسوب آخر؟
لا. يتواصل Macro Deck مع Discord عبر اتصال محلي، لذا يجب أن يعمل Discord على الحاسوب الذي يعمل عليه Macro Deck. وحده تنفيذ Webhook يعمل دون تطبيق Discord.
يقول الإعداد إن Discord رفض الاتصال. ما المشكلة؟
يعمل Macro Deck وDiscord بصلاحيات مختلفة، مثلًا شُغّل أحدهما باستخدام تشغيل كمسؤول. شغّل كليهما بالطريقة نفسها وحاول مجددًا.
لا يتغيّر إعداد صوتي. لماذا؟
قد يكون تطبيق آخر متصل بـ Discord مسيطرًا على إعدادات الصوت، أو قد يتجاهل Discord إعدادات الصوت المتقدمة أثناء تفعيل Krisp. أغلق التطبيقات الأخرى التي تتحكم في Discord، وغيّر الإعداد مرة واحدة في إعدادات Voice & Video في Discord، ثم شغّل الإجراء مجددًا.
أين تُخزَّن بيانات اعتمادي؟
يُخزَّن السر الخاص بالعميل والرموز التي يعيدها Discord مشفّرةً على حاسوبك، ولا تُرسَل إلا إلى Discord. عندما لا يعود Discord يقبل التفويض المخزّن، يعرض التكامل انتهت صلاحية تفويض Discord مع زر إعادة الاتصال.
المزيد في الدردشة والصوت
Webhooks في Discord
مضمّن في Macro Deckانشر رسائل غنية مع عناصر مضمّنة وإشارات في قنوات Discord عبر Webhooks، مع معاينة مباشرة.
SinusBot
مضمّن في Macro Deckتحكّم في موسيقى نسخ SinusBot الخاصة بك واعرض ما تشغّله على لوحتك.