Music DJ: Spotify, YouTube और लोकल म्यूज़िक

Music DJ आपके सीन से मेल खाता बैकग्राउंड म्यूज़िक चलाता है। इस गाइड में बताया गया है कि Spotify, YouTube या अपनी ऑडियो फ़ाइलें कैसे जोड़ें, म्यूज़िक प्लेयर कैसे इस्तेमाल करें, और Game Mode और Conversation में म्यूज़िक कैसे चलाएँ।

Music DJ क्या है

Music DJ एक वैकल्पिक एजेंट है, जिसे डाउनलोड करना पड़ता है। एजेंट यानी वह मददगार, जो चैट के बैकग्राउंड में चलता है। हर जवाब के बाद यह सीन का मूड पढ़कर उससे मेल खाता म्यूज़िक चला सकता है।

शुरू करने से पहले: Agents (एजेंट) खोलें, Agent Organizer (एजेंट ऑर्गनाइज़र) चुनें और Music DJ इंस्टॉल करें। इंस्टॉल के बाद यह बंद रहता है। इसे किसी चैट के लिए बाकी एजेंट की तरह चालू करें। यह Roleplay चैट में काम करता है, Game Mode में एक अलग टॉगल से (Game Mode में Music DJ), और Conversation में Music कमांड से (Conversation का Music कमांड)।

यह तीन सोर्स से म्यूज़िक चलाता है।

चालू सोर्स टॉप बार में पिन किए छोटे Music Player (म्यूज़िक प्लेयर) के रूप में दिखता है। फ़ोन और सँकरी विंडो में यह छोटा गोल फ़्लोटिंग विजेट बन जाता है, जिसे आप खींचकर कहीं भी रख सकते हैं।

Music DJ की सेटिंग एक ही साझा जगह होती है। दाईं तरफ़ का Agents पैनल खोलें, फिर Music DJ। मिनी प्लेयर पर गियर आइकन (टूलटिप Music DJ setup) पर क्लिक करके भी यहाँ पहुँच सकते हैं।

म्यूज़िक सोर्स चुनना

Music DJ एडिटर में Music Player फ़ील्ड के साथ तीन बटन हैं: Spotify, YouTube और Custom। उनके नीचे एक लाइन बताती है कि अभी क्या चालू है, जैसे "Visible player: Spotify. Saved provider: Spotify."। यह चुनाव पूरे ऐप पर लागू होता है, हर चैट के लिए अलग से सेव नहीं होता।

Spotify सेट करना

Spotify के लिए आपका अपना मुफ़्त Spotify डेवलपर ऐप इस्तेमाल होता है। आपको सिर्फ़ Spotify Client ID पेस्ट करना होता है। कोई क्लाइंट सीक्रेट नहीं होता।

1. Music DJ एडिटर में Spotify Connection ढूँढें।
2. ऐप में दिखने वाले लिंक से Spotify Developer Dashboard खोलें।
3. नया ऐप बनाएँ और "Web API" चुनें।
4. उस ऐप की Redirect URIs में ठीक वही रीडायरेक्ट पता जोड़ें, जो Marinara ऐप के सेटअप बॉक्स के स्टेप 3 में दिखाता है। रीडायरेक्ट पता यानी वह पता, जहाँ लॉगिन के बाद Spotify आपको भेजता है।
5. Client ID कॉपी करें और Spotify Client ID में पेस्ट करें।
6. एजेंट सेव करें, फिर Connect Spotify Account पर क्लिक करें।

Spotify के लॉगिन और अनुमति की विंडो खुलती है। मंज़ूरी देने के बाद उसमें थोड़ी देर सफलता का पेज दिखता है और विंडो बंद हो जाती है। Marinara में हरे रंग की Connected to Spotify पिल दिखती है। Disconnect सेव किया हुआ कनेक्शन हटा देता है।

Note: प्ले, पॉज़, स्किप और वॉल्यूम के लिए Spotify Premium (पेड प्लान) ज़रूरी है। मुफ़्त अकाउंट भी कनेक्ट हो सकता है। टोकन अपने आप रिफ़्रेश होते हैं।

अगर यह काम नहीं किया: दूसरी मशीन पर लॉगिन विंडो फ़ेल हो सकती है (नीचे देखें)। नहीं तो जाँच लें कि रीडायरेक्ट पता हूबहू मेल खाता है।

Spotify डिवाइस

Spotify किसी डिवाइस के ज़रिए बजता है, जैसे आपका फ़ोन, डेस्कटॉप का Spotify ऐप या ऐप के अंदर का प्लेयर।

• डेस्कटॉप पर मिनी प्लेयर पर लैपटॉप आइकन (Enable Marinara player या Use Marinara player) पर क्लिक करें, ताकि ब्राउज़र टैब "Marinara Engine" नाम की Spotify डिवाइस बन जाए। टैब में स्ट्रीमिंग के लिए Premium चाहिए।
• मोबाइल पर प्लेयर आपके फ़ोन की अपनी Spotify डिवाइस को प्राथमिकता देता है, इसलिए म्यूज़िक फ़ोन पर बजता है, बैकग्राउंड टैब में नहीं।
• अगर कोई डिवाइस रिमोट वॉल्यूम की इजाज़त नहीं देती, तो स्लाइडर की जगह Use device volume आ जाता है। डिवाइस के अपने वॉल्यूम बटन इस्तेमाल करें।

दूसरी मशीन पर Spotify

Spotify सिर्फ़ सुरक्षित https:// रीडायरेक्ट पते या लूपबैक पता http://127.0.0.1 (यानी वही कंप्यूटर) स्वीकार करता है। अगर Marinara किसी दूसरी मशीन पर सादे http से चल रहा है, तो लॉगिन विंडो फ़ेल हो सकती है। इसके दो हल हैं:

• कनेक्ट करते समय Connect Spotify Account के नीचे "Browser couldn't reach the callback?" खोलें। फ़ेल हुई विंडो का पूरा पता कॉपी करें, उसे बॉक्स में पेस्ट करें और Complete connection पर क्लिक करें।
• या एक तय रीडायरेक्ट पता एनवायरनमेंट वेरिएबल (सर्वर की वह सेटिंग जो शुरू होते समय पढ़ी जाती है) के रूप में सेट करें:

SPOTIFY_REDIRECT_URI=https://your-address/api/spotify/callback

सर्वर कॉन्फ़िगरेशन रेफ़रेंस देखें।

Spotify गाने कहाँ से चुने (Roleplay)

जब Music DJ किसी Roleplay चैट में चलता है, तो उसके कार्ड पर Spotify source लिस्ट होती है।

• Liked Songs: पहले आपके सेव किए हुए ट्रैक में से चुनता है।
• Playlist: एक ही प्लेलिस्ट के अंदर रहता है, जिसे Playlist लिस्ट में चुना जाता है।
• Artist: किसी एक आर्टिस्ट के आसपास सर्च करता है, जिसका नाम Artist फ़ील्ड में टाइप किया जाता है।
• Any Spotify: जहाँ ठीक लगे, वहाँ DJ को Spotify सर्च इस्तेमाल करने देता है।

YouTube सेट करना

YouTube मोड के लिए मुफ़्त YouTube Data API कुंजी चाहिए। API कुंजी यानी एक गुप्त कोड, जिससे Marinara आपकी तरफ़ से किसी सेवा का इस्तेमाल कर पाता है। इसके लिए न YouTube लॉगिन चाहिए, न Premium।

1. Music DJ एडिटर में YouTube Connection ढूँढें।
2. ऐप के लिंक से Google Cloud Console खोलें और कोई प्रोजेक्ट बनाएँ या चुनें।
3. YouTube Data API v3 चालू करें।
4. Credentials में जाएँ, फिर Create credentials, फिर API key।
5. कुंजी को YouTube Data API Key में पेस्ट करें।
6. Save Key पर क्लिक करें। इसके बाद बटन पर Update Key लिखा आता है और हरे रंग की "API key configured" पिल दिखती है। Remove कुंजी हटा देता है।

कुंजी पर कोई पाबंदी न लगाएँ, या सिर्फ़ API के हिसाब से पाबंदी लगाकर उसे YouTube Data API v3 तक सीमित करें। HTTP रेफ़रर के हिसाब से पाबंदी न लगाएँ। सर्च सर्वर पर चलता है, इसलिए रेफ़रर वाली पाबंदी उसे रोक देगी। ऐप के मुताबिक मुफ़्त कोटा (रोज़ लगभग 100 सर्च) पर्सनल DJ के लिए काफ़ी है। यह संख्या ऐप के टेक्स्ट से आई है और बदल सकती है। आपकी कुंजी सर्वर पर एन्क्रिप्ट करके रखी जाती है।

अपनी म्यूज़िक फ़ाइलें इस्तेमाल करना

Custom (कस्टम) मोड उसी मशीन से ऑडियो फ़ाइलें चलाता है, जिस पर Marinara चल रहा है। ये फ़ाइल टाइप चलते हैं: .mp3, .ogg, .wav, .flac, .m4a, .aac और .webm।

Music DJ एडिटर में Custom Music Library ढूँढें। इसमें एक ही स्विच है: Use Game Assets music folder।

• On (चालू): Custom मोड वह ऑडियो पढ़ता है, जो आपने Game Assets में अपलोड किया है। Game Assets, Game Mode के लिए Marinara की असेट लाइब्रेरी है। फ़ोल्डर चुनने के लिए Game Assets music folder इस्तेमाल करें। पूरी लाइब्रेरी के लिए music लिखें, या music/combat जैसा कोई सबफ़ोल्डर। Open Folder उसे सर्वर वाली मशीन पर खोल देता है।
• Off (बंद): Custom मोड सर्वर डिवाइस के किसी फ़ोल्डर से पढ़ता है। सर्वर मशीन पर पिकर खोलने के लिए Select Folder इस्तेमाल करें, या Music folder on this device में पथ पेस्ट करें।

Roleplay और Game के सेटअप में वही सोर्स दिखता है। अगर आपने सर्वर डिवाइस का कोई फ़ोल्डर चुना है, तो चैट की Music DJ सेटिंग्स वही पथ और एक Choose Folder बटन दिखाती हैं।

Game Assets के बाहर के फ़ोल्डर से म्यूज़िक चलाने के लिए सर्वर पर लोकल एक्सेस चाहिए। किसी दूसरी डिवाइस से बिना लॉगिन या एडमिन सीक्रेट के इस्तेमाल करने पर यह सुविधा ब्लॉक हो सकती है। रिमोट एक्सेस: लॉगिन और IP अलाउलिस्ट देखें।

म्यूज़िक प्लेयर इस्तेमाल करना

Music Player डेस्कटॉप पर टॉप बार में एक पिल की तरह दिखता है, और मोबाइल पर ऐसे विजेट की तरह, जिसे खींचा जा सकता है। इसे दिखाने या छिपाने के लिए Settings → General → App Behavior (सेटिंग्स → जनरल → ऐप का व्यवहार) खोलें और Music Player टॉगल करें। यह डिफ़ॉल्ट रूप से चालू है। इसके चालू होने पर अगर Music DJ इंस्टॉल नहीं है, तो प्लेयर पर Download Music DJ Agent to configure लिखा दिखता है और एक Agent Organizer बटन मिलता है।

नई प्रोफ़ाइल पर सोर्स YouTube से शुरू होता है। इसे प्लेयर पर बने गोल सोर्स स्विच (टूलटिप "Switch to ... player"), एडिटर में Music Player के बटनों, या किसी चैट की Music DJ सेटिंग्स से बदलें।

प्लेयर ट्रैक का कवर या थंबनेल, टाइटल, और आर्टिस्ट या चैनल दिखाता है। कंट्रोल सोर्स पर निर्भर करते हैं।

• Spotify: शफ़ल, Previous, प्ले या पॉज़, Next, रिपीट, म्यूट वाला वॉल्यूम, DJ, लैपटॉप वाला Marinara player बटन और Music DJ setup गियर। Spotify कनेक्ट न हो, तो प्लेयर पर "Spotify not connected" लिखा आता है, और उसे टैप करने पर Music DJ setup खुलता है।
• YouTube: प्ले या पॉज़, एक तीर जो 16:9 का छोटा वीडियो पैनल खोलता है, Stop, और म्यूट वाला वॉल्यूम।
• Custom: प्ले या पॉज़ और वॉल्यूम।

DJ Mari: AI प्लेलिस्ट मेकर

Spotify मिनी प्लेयर पर बना DJ बटन ("DJ Mari composes a playlist for you!") थीम वाली प्लेलिस्ट तैयार करता है। DJ Mari आपके कनेक्ट किए हुए AI मॉडल से कहता है कि आपके पर्सोना, सबसे ज़्यादा इस्तेमाल हुए कैरेक्टर और सारी चैट की हाल की बातचीत के आधार पर प्लेलिस्ट बनाए। फिर वह मेल खाते गानों को "DJ Mari" और आज की तारीख वाले नाम की नई Spotify प्लेलिस्ट में जोड़ता है और उसे चला देता है।

इसके लिए दो चीज़ें चाहिए।

• Music DJ एजेंट को दिया गया एक मॉडल। इसके बिना यह दिखता है: "Configure a model connection on the Music DJ agent before using DJ Mari." किसी AI प्रोवाइडर से कनेक्ट करना देखें।
• कम से कम 25 मेल खाते Spotify गाने। यह ज़्यादा से ज़्यादा 50 चुनता है। 25 से कम हों, तो यह और Liked Songs जोड़कर दोबारा कोशिश करने को कहता है।

सफल होने पर Open playlist बटन के साथ "DJ Mari playlist is ready" दिखता है।

Game Mode में Music DJ

Game Mode का अपना बैकग्राउंड म्यूज़िक Game Assets से आता है। उसकी जगह Music DJ इस्तेमाल करने के लिए Game सेटअप में Music DJ टॉगल ("Use the Music DJ for this game instead of local music assets") चालू करें। यह डिफ़ॉल्ट रूप से बंद है। इसके बाद आपको वही Spotify, YouTube और Custom विकल्प और फ़ील्ड मिलते हैं, जो Roleplay में मिलते हैं।

Spotify के साथ, हर सीन के बाद सर्वर आपके चुने हुए सोर्स से असली गानों की एक छोटी लिस्ट बनाता है, और AI उनमें से एक चुनता है। इससे AI कोई गाना गढ़ नहीं पाता। Game Mode एक समय पर एक ही गाना लूप में चलाता है। मौजूदा सीन के लिए नया गाना चुनवाने के लिए Game controls (गेम कंट्रोल) खोलें और Retry Music DJ चुनें। गेम के कंट्रोल देखें।

Conversation का Music कमांड

Conversation में Music DJ को एजेंट के तौर पर नहीं जोड़ा जा सकता। इसकी जगह कैरेक्टर Music कमांड से गाने चलाते हैं।

1. चैट का Commands सेक्शन खोलें और मास्टर Commands टॉगल चालू करें।
2. Music ("Let characters play songs through the active Music Player") चालू करें।

इसके बाद कोई कैरेक्टर Spotify के लिए गाने का नाम बता सकता है, या YouTube के लिए ट्रैक का विवरण दे सकता है, और Marinara उसे चालू सोर्स पर चला देता है। यह तब भी काम करता है, जब Music DJ कहीं भी चालू न हो। इसके लिए बस Spotify कनेक्ट होना चाहिए या YouTube कुंजी सेव होनी चाहिए। अगर Spotify कनेक्ट नहीं है या उसके पास प्लेबैक की अनुमति नहीं है, तो Spotify वाला गाना कमांड कुछ नहीं करता और कोई एरर भी नहीं दिखाता।

समस्या-समाधान

• मिनी प्लेयर नहीं दिख रहा: Settings → General → App Behavior में Music Player चालू करें।
• Spotify पर कुछ नहीं बज रहा: प्लेबैक के लिए Spotify Premium और कोई चालू Spotify डिवाइस चाहिए। किसी डिवाइस पर डेस्कटॉप ऐप खोलें, या डेस्कटॉप पर Enable Marinara player पर क्लिक करें।
• दूसरी मशीन पर Spotify की लॉगिन विंडो फ़ेल हो रही है: "Browser couldn't reach the callback?" वाला पेस्ट बॉक्स इस्तेमाल करें, या सर्वर पर SPOTIFY_REDIRECT_URI सेट करें।
• YouTube सर्च फ़ेल हो रही है: पक्का करें कि आपके प्रोजेक्ट के लिए YouTube Data API v3 चालू है और कुंजी पर HTTP रेफ़रर वाली पाबंदी नहीं है। रोज़ का कोटा खत्म हो जाए, तो अगले दिन कोशिश करें या दूसरी कुंजी इस्तेमाल करें।
• रिमोट एक्सेस पर डिवाइस के फ़ोल्डर से Custom म्यूज़िक नहीं बजता: उस फ़ोल्डर के लिए सर्वर पर लोकल एक्सेस चाहिए। रिमोट एक्सेस: लॉगिन और IP अलाउलिस्ट देखें।
• Conversation में कैरेक्टर का गाना कमांड कुछ नहीं करता: Spotify कनेक्ट करें या YouTube कुंजी सेव करें, और जाँच लें कि Commands और Music टॉगल चालू हैं।

मिलती-जुलती गाइड

• डाउनलोड किए जाने वाले एजेंट का रेफ़रेंस
• एजेंट: आपकी चैट में मदद करने वाले AI
• किसी AI प्रोवाइडर से कनेक्ट करना
• गेम एसेट: म्यूज़िक, साउंड, स्प्राइट और बैकग्राउंड
• Conversation मोड: शुरुआत