SinusBot
مضمّن في Macro Deckتحكّم في موسيقى نسخ SinusBot الخاصة بك واعرض ما تشغّله على لوحتك.
أداتا مشغّل الموسيقى تشغّلان مقطعًا، إحداهما بنمط غلاف كامل والأخرى بنمط غلاف صغير، وفي رأس كلتيهما اسم SinusBot وشعاره
- التشغيل والإيقاف المؤقت والتخطي والانتقال على أي نسخة من SinusBot
- ضبط مستوى الصوت والترتيب العشوائي والتكرار
- تشغيل مقطع من مكتبة البوت
- عرض المقطع الذي يُشغَّل في أداة مشغّل الموسيقى
- إضافة أي عدد تريده من نسخ البوت
SinusBot بوت موسيقى لـ TeamSpeak وDiscord تشغّله على خادمك الخاص. يربط تكامل SinusBot بين Macro Deck وواجهة الويب الخاصة بـ SinusBot، فتستطيع التحكم فيما تشغّله نسخة من البوت ورؤية المقطع الحالي على لوحتك. يعمل مع أي SinusBot يستطيع Macro Deck الوصول إليه عبر الشبكة، على الحاسوب نفسه، أو في شبكتك المحلية، أو على خادم.
ما يمكنك فعله
- التشغيل والإيقاف المؤقت والتبديل، والتخطي إلى المقطع التالي أو السابق، والانتقال إلى موضع في المقطع الحالي.
- ضبط مستوى الصوت أو رفعه أو خفضه، وتشغيل الترتيب العشوائي أو إيقافه، وتشغيل التكرار أو إيقافه.
- تشغيل مقطع محدد من مكتبة البوت باستخدام Play Track. اترك المقطع فارغًا لاختيار واحد عند الضغط على الزر.
- عرض المقطع الذي يُشغَّل والفنان والغلاف في أداة مشغّل الموسيقى في Macro Deck، واستخدام مقطع البوت وموضعه ومستوى صوته في التسميات عبر المتغيرات.
بعض الأمثلة على الإعدادات:
- صف من الأزرار مع Previous Track وToggle Play/Pause وNext Track للبوت في قناتك على TeamSpeak. يعرض زر التشغيل ما إذا كان البوت يشغّل.
- منزلق مربوط بمتغير مستوى صوت البوت،
sinusbot_<instance>_volume، فتستطيع خفض الموسيقى أثناء حديثك. - أداة مشغّل الموسيقى لكل بوت، بجانب أزرار يتبع لونها الغلاف عبر المتغير
music_player_<player>_album_color.
عدة بوتات وكيف يعمل
كل نسخة من SinusBot تريد التحكم فيها هي تهيئة واحدة. يمكنك إضافة أي عدد تريده، حتى نسخًا على خوادم مختلفة، واختيار النسخة في حقل Player لكل إجراء. عندما تترك Player فارغًا، يتحكم الإجراء في النسخة الأولى. تحصل كل تهيئة على مجموعة متغيرات خاصة بها، مسمّاة باسم التهيئة، مثل sinusbot_<instance>_volume.
يتحقق Macro Deck من الاتصال عند إعداد تهيئة ويحمّل النسخ الموجودة في البوت. وأثناء عمله، يقرأ حالة التشغيل بانتظام. عندما يتعذّر الوصول إلى البوت للحظة قصيرة، تستمر اللوحة في عرض آخر مقطع؛ وعندما يبقى غير قابل للوصول، يحمل المتغير sinusbot_<instance>_is_connected القيمة false ولا تفعل الإجراءات شيئًا حتى يستجيب البوت مجددًا.
ما تحتاج إليه
- SinusBot يعمل ويستطيع Macro Deck الوصول إلى واجهة الويب الخاصة به، مثل
http://your-bot:8087. - اسم مستخدم وكلمة مرور في SinusBot.
- نسخة واحدة على الأقل مُنشأة في واجهة الويب الخاصة بـ SinusBot.
خطوات الإعداد
الخطوة 1: تحقق من واجهة الويب الخاصة بـ SinusBot
افتح واجهة الويب الخاصة بـ SinusBot في متصفح وسجّل الدخول. دوّن العنوان مع المنفذ، مثل
http://192.168.1.20:8087، وتأكد من وجود نسخة واحدة على الأقل.الخطوة 2: افتح تكامل SinusBot
في Macro Deck، انقر التكاملات في الشريط الجانبي ثم انقر SinusBot. في علامة التبويب نظرة عامة، انقر إضافة تهيئة في قسم الإعدادات. يفتح تشغيل المفتاح في أعلى اليسار النافذة نفسها، ويُفعَّل التكامل بعد اكتمال الإعداد.
الخطوة 3: أدخل الخادم وبيانات تسجيل الدخول
في نافذة الاتصال بـ SinusBot، أدخل:
- عنوان الخادم: عنوان واجهة الويب الخاصة بـ SinusBot، بما في ذلك المنفذ.
- اسم المستخدم وكلمة المرور: الحساب الذي تسجّل به الدخول إلى SinusBot.
عند النقر على متابعة، يختبر Macro Deck الاتصال ويحمّل النسخ.
الخطوة 4: حدّد النسخة
في خطوة اختيار المثيل، اختر نسخة البوت في المثيل وانقر متابعة. تُحفظ التهيئة باسم SinusBot مع اسم النسخة بين قوسين. كرّر هذه الخطوات لكل نسخة أخرى تريد التحكم فيها.
الخطوة 5: أضف إجراءً إلى زر
في صفحة اللوحة، انقر زرًا. يجب أن تكون اللوحة غير مقفلة: إذا ظهر الزر قفل في أعلى اليسار، فهي غير مقفلة. يُفتح المحرر مع تحديد ضغطة قصيرة. انقر + إضافة إجراء، واختر SinusBot على يمين نافذة إضافة إجراء، ثم اختر Toggle Play/Pause وحدّد النسخة في Player.
الخطوة 6: اضغط الزر
اضغط الزر على لوحتك. يبدأ البوت التشغيل أو يوقفه مؤقتًا، ويعرض الزر الحالة الحالية. وتعرض أداة مشغّل الموسيقى المضبوطة على النسخة المقطع الذي يُشغَّل.
الإجراءات13
ضعها على زر أو شغّلها من تدفق.
- Play
- يستأنف التشغيل.
- Pause
- يوقف التشغيل مؤقتًا.
- Toggle Play/Pause
- يبدّل بين التشغيل والإيقاف المؤقت، ويعرض الحالة الحالية على الزر.
- Next Track
- ينتقل إلى المقطع التالي.
- Previous Track
- ينتقل إلى المقطع السابق.
- Refresh State
- يقرأ حالة ما يُشغَّل الآن مجددًا فورًا.
- Set Volume
- يضبط مستوى صوت التشغيل (من 0 إلى 100%).
- Volume Up
- يرفع مستوى صوت التشغيل بنسبة 10%.
- Volume Down
- يخفض مستوى صوت التشغيل بنسبة 10%.
- Seek
- ينتقل إلى موضع في المقطع الحالي، بالثواني.
- Toggle Shuffle
- يبدّل حالة الترتيب العشوائي، أو يشغّله أو يوقفه.
- Set Repeat Mode
- يشغّل التكرار أو يوقفه. لدى SinusBot وضع تكرار واحد، لذا يشغّله خيارا التكرار كلاهما.
- Play Track
- يشغّل مقطعًا من مكتبة البوت. اتركه فارغًا لاختيار مقطع عند الضغط على الزر.
المشغّلات7
يمكن لزر أو تدفق أن يستجيب لهذه الأحداث.
- تغيّر المقطع
- بدأ تشغيل مقطع مختلف (تحت مشغّل الموسيقى).
- بدأ التشغيل
- بدأ التشغيل أو استُؤنف (تحت مشغّل الموسيقى).
- أُوقف التشغيل مؤقتًا
- أُوقف التشغيل مؤقتًا (تحت مشغّل الموسيقى).
- توقّف التشغيل
- توقّف التشغيل (تحت مشغّل الموسيقى).
- تغيّر مستوى الصوت
- تغيّر مستوى صوت البوت، مع القيمة الجديدة والسابقة (تحت مشغّل الموسيقى).
- اتصل المشغّل
- أصبحت نسخة البوت قابلة للوصول (تحت مشغّل الموسيقى).
- انفصل المشغّل
- لم تعد نسخة البوت قابلة للوصول (تحت مشغّل الموسيقى).
المتغيرات8
اعرض هذه القيم على الأزرار والأدوات، أو استخدمها في الشروط.
sinusbot_<instance>_current_track_name,sinusbot_<instance>_current_artist,sinusbot_<instance>_current_album- المقطع الحالي وفنانه. لا يُبلغ SinusBot عن الألبوم، لذا يبقى
sinusbot_<instance>_current_albumفارغًا. sinusbot_<instance>_playback_state,sinusbot_<instance>_is_playing- ما إذا كان البوت يشغّل أو متوقفًا مؤقتًا أو متوقفًا.
sinusbot_<instance>_volume- مستوى صوت التشغيل بالنسبة المئوية. يمكنك أيضًا ضبطه، مثلًا بمنزلق.
sinusbot_<instance>_track_duration,sinusbot_<instance>_current_position,sinusbot_<instance>_progress_percentage- طول المقطع والموضع بالثواني، والتقدم بالنسبة المئوية. يمكنك ضبط الموضع للانتقال.
sinusbot_<instance>_album_art_url- عنوان الغلاف الحالي.
sinusbot_<instance>_device_name- اسم نسخة البوت.
sinusbot_<instance>_shuffle_enabled,sinusbot_<instance>_repeat_mode- ما إذا كان الترتيب العشوائي والتكرار مفعّلين.
sinusbot_<instance>_is_connected- ما إذا كان Macro Deck يستطيع الوصول إلى نسخة البوت.
الأسئلة الشائعة
هل يمكنني التحكم في أكثر من بوت؟
نعم. أضف تهيئة واحدة لكل نسخة من SinusBot، حتى على خوادم مختلفة. لكل إجراء حقل Player للنسخة التي يتحكم فيها، ولكل تهيئة متغيراتها الخاصة.
هل يجب أن يعمل SinusBot على الحاسوب نفسه؟
لا. يتواصل Macro Deck مع واجهة الويب الخاصة بـ SinusBot عبر الشبكة، لذا يمكن أن يعمل البوت على خادم أو حاسوب آخر، ما دام Macro Deck يستطيع الوصول إلى عنوانه.
يقول الإعداد إنه لم يُعثر على أي نسخ. ماذا أفعل؟
ليس لدى الحساب أي نسخة يمكنه استخدامها. أنشئ نسخة في واجهة الويب الخاصة بـ SinusBot أولًا، ثم أعدّ التهيئة مجددًا.
ماذا يحدث عندما يصبح البوت غير متصل؟
لا يمسح الانقطاع القصير اللوحة: إذ تحتفظ بآخر مقطع للحظة. وعندما يبقى البوت غير قابل للوصول، يحمل المتغير sinusbot_<instance>_is_connected القيمة false، ويواصل Macro Deck محاولة الوصول إليه.
أين تُخزَّن كلمة مروري؟
تُخزَّن كلمة المرور مشفّرة على حاسوبك، ولا تُستخدم إلا لتسجيل الدخول إلى SinusBot الخاص بك.
المزيد في الدردشة والصوت
Discord
مضمّن في Macro Deckاكتم الميكروفون والسماع، وانضم إلى القنوات الصوتية، وغيّر إعدادات الصوت، وانشر رسائل Webhook في Discord من لوحتك.
Webhooks في Discord
مضمّن في Macro Deckانشر رسائل غنية مع عناصر مضمّنة وإشارات في قنوات Discord عبر Webhooks، مع معاينة مباشرة.