SinusBot
Macro Deck के साथ शामिलअपने SinusBot इंस्टेंस का संगीत नियंत्रित करें और अपने डेक पर दिखाएँ कि वे क्या चला रहे हैं।
ट्रैक चलाते दो म्यूज़िक प्लेयर विजेट, एक पूरा कवर स्टाइल में और एक छोटा कवर स्टाइल में, दोनों के हेडर में SinusBot का नाम और लोगो
- किसी भी SinusBot इंस्टेंस पर चलाएँ, रोकें, आगे बढ़ें और सीक करें
- वॉल्यूम, शफ़ल और रिपीट सेट करें
- बॉट की लाइब्रेरी से कोई ट्रैक चलाएँ
- चल रहा ट्रैक म्यूज़िक प्लेयर विजेट में दिखाता है
- जितने चाहें उतने बॉट इंस्टेंस जोड़ें
SinusBot, TeamSpeak और Discord के लिए एक म्यूज़िक बॉट है, जिसे आप अपने सर्वर पर चलाते हैं। SinusBot इंटीग्रेशन Macro Deck को SinusBot वेब इंटरफ़ेस से जोड़ता है, ताकि आप नियंत्रित कर सकें कि कोई बॉट इंस्टेंस क्या चलाए और अपने डेक पर मौजूदा ट्रैक देख सकें। यह किसी भी ऐसे SinusBot के साथ काम करता है जिस तक Macro Deck नेटवर्क पर पहुँच सके, चाहे वह उसी कंप्यूटर पर हो, आपके लोकल नेटवर्क में हो या किसी सर्वर पर।
आप क्या कर सकते हैं
- चलाएँ, रोकें, टॉगल करें, अगले या पिछले ट्रैक पर जाएँ और मौजूदा ट्रैक में किसी जगह पर पहुँचें।
- वॉल्यूम सेट करें, उसे बढ़ाएँ या घटाएँ, शफ़ल चालू या बंद करें और रिपीट चालू या बंद करें।
- Play Track से बॉट की लाइब्रेरी का कोई खास ट्रैक चलाएँ। बटन दबाते समय ट्रैक चुनने के लिए उसे खाली छोड़ें।
- Macro Deck के म्यूज़िक प्लेयर विजेट में चल रहा ट्रैक, कलाकार और कवर दिखाएँ, और वेरिएबल के ज़रिए बॉट का ट्रैक, स्थिति और वॉल्यूम लेबल में इस्तेमाल करें।
कुछ उदाहरण सेटअप:
- आपके TeamSpeak चैनल के बॉट के लिए Previous Track, Toggle Play/Pause और Next Track वाले बटनों की एक पंक्ति। चलाने का बटन दिखाता है कि बॉट चल रहा है या नहीं।
- बॉट के वॉल्यूम वेरिएबल,
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 से कनेक्ट करें डायलॉग में ये डालें:
- सर्वर URL: 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 के साथ शामिलअपने डेक से Discord में म्यूट करें, आवाज़ बंद करें, वॉइस चैनल से जुड़ें, वॉइस सेटिंग बदलें और वेबहुक संदेश भेजें।
Discord वेबहुक
Macro Deck के साथ शामिलवेबहुक के ज़रिए Discord चैनलों पर एम्बेड और उल्लेख वाले रिच संदेश पोस्ट करें, लाइव प्रीव्यू के साथ।