ये गाइड किसी उद्योग की अवधारणाओं को उन ऑब्जेक्ट से जोड़ती हैं जो प्लेटफ़ॉर्म में आज हैं (बुके, लाइनें, पैकेज, पार्टनर खाते, नोड्स, API)। ये वैचारिक मैपिंग हैं, उद्योग-विशिष्ट फ़ीचर नहीं, और पार्टनर खाता एक प्रतिनिधि खाता है, अलग-थलग टेनेंट नहीं।
वैचारिक मैपिंग
पैनल में कुछ भी शो या समर्थक नहीं कहलाता। तालिका बताती है कि कौन-सी ऑब्जेक्ट कौन-सी भूमिका निभाती है; नीचे के अध्याय उन्हें इसी क्रम में सेट करते हैं।
| आपके उद्योग में | प्लेटफ़ॉर्म पर | पैनल में कहाँ |
|---|---|---|
| स्टूडियो का चैनल | लाइव चैनल: अपने स्रोतों, EPG और आउटपुट फ़ॉर्मैट वाली स्ट्रीम | Streams → लाइव स्ट्रीम जोड़ें (स्रोत URL या RTMP पुश) |
| शो लाइब्रेरी | VOD कैटलॉग: सीज़न और एपिसोड वाली फ़िल्में और सीरीज़, श्रेणियाँ और मेटाडेटा | Movies और Series, या VOD इन्जेस्ट जॉब |
| सब्सक्रिप्शन टियर | बुके: चैनलों, फ़िल्मों या सीरीज़ का नामित समूह जो कोई पैकेज देता है | Bouquets, Streams और Movies / Series से |
| समर्थक का एक्सेस | लाइन: एक एक्सेस, अपने पैकेज, बुके, समाप्ति, कनेक्शन सीमा और आउटपुट के साथ | Lines → जोड़ें, या एक्टिवेशन कोड, या Reseller API |
| बिलिंग अवधि | लाइन की समाप्ति तिथि, जिसे पैकेज, क्रेडिट या API रिन्यू करती है | लाइन की समाप्ति तिथि और पैकेज की अवधि |
| एफ़िलिएट या डिस्ट्रीब्यूटर खाता | पार्टनर खाता (रीसेलर): क्रेडिट, अनुमतियों और अपनी लाइनों वाला प्रतिनिधि डैशबोर्ड | Users → रीसेलर जोड़ें; उसकी अनुमतियों के लिए Groups |
| शॉप या मेंबरशिप इंटीग्रेशन | Reseller API और webhooks: पैनल के ऑपरेशन आपके अपने सिस्टम से | रीसेलर के डैशबोर्ड में Reseller API कुंजियाँ और webhooks |
पूर्वापेक्षाएँ
इंस्टॉल करने से पहले क्या तैयार रखें।
- सार्वजनिक पते या डोमेन वाला सर्वर (Ubuntu 22.04 या 24.04), और अपेक्षित दर्शकों के लिए पर्याप्त अपस्ट्रीम बैंडविड्थ।
- तैयार एपिसोड, चैनल के लिए स्टूडियो का प्लेआउट या एनकोडर, और कनेक्टर वाले प्लेटफ़ॉर्म पर एक शॉप, या HTTP API कॉल करने की क्षमता।
- टियर और एफ़िलिएट्स पर फ़ैसला: हर सब्सक्रिप्शन क्या देता है, और उसे कौन बेच सकता है।
इन्फ्रास्ट्रक्चर डिप्लॉयमेंट
पहले एक सर्वर, दर्शक बढ़ने पर नोड।
- मैनेजमेंट सर्वर पर इंस्टॉलर चलाएँ और पैनल को TLS वाले रिवर्स प्रॉक्सी के पीछे रखें; ट्रस्टेड प्रॉक्सी सेट करें ताकि IP नियम दर्शक का असली पता देखें।
- प्लेबैक बेस URL उस सार्वजनिक पते पर सेट करें जिस तक आपके दर्शक पहुँचते हैं।
- जिस क्षेत्र में कई समर्थक देखते हैं वहाँ Servers से एक नोड एनरोल करें; पैनल उसे SSH से इंस्टॉल करता है और उस क्षेत्र के दर्शकों को उस पर रूट करता है।
- कैटलॉग या समर्थकों को चलाने वाले हर स्टाफ़ सदस्य के लिए उसके अपने अनुमति ग्रुप के साथ पार्टनर खाता (रीसेलर) बनाएँ।
कंटेंट का संगठन
शो सीरीज़ के रूप में, टियर बुके के रूप में।
- हर विधा की श्रेणियाँ बनाएँ, और हर शो की एक सीरीज़, हर रिलीज़ बैच का एक सीज़न और हर वीडियो का एक एपिसोड।
- लाइव चैनल के लिए एक बुके, मुफ़्त या प्रारंभिक कंटेंट के लिए एक, और हर ऊँचे टियर के लिए एक बनाएँ।
- हर टियर के लिए एक पैकेज बनाएँ जिसकी अवधि बिलिंग अवधि हो, चाहें तो नए आगंतुकों के लिए ट्रायल पैकेज, और एफ़िलिएट्स के लिए क्रेडिट में कीमत।
- बैक कैटलॉग को उसकी अपनी श्रेणी में रखें ताकि उसे सीरीज़ को छुए बिना टियरों के बीच ले जाया जा सके।
पार्टनर (रीसेलर) कॉन्फ़िगरेशन
एफ़िलिएट्स और डिस्ट्रीब्यूटर।
- एफ़िलिएट्स के लिए सिर्फ़ लाइन अनुमतियों वाला ग्रुप बनाएँ, ताकि वे कैटलॉग न बदल सकें।
- हर एफ़िलिएट को उस ग्रुप और क्रेडिट बैलेंस के साथ रीसेलर के रूप में जोड़ें; उसके पैकेज की कीमत वही है जो स्टूडियो तय करता है।
- सब-एफ़िलिएट्स वाला डिस्ट्रीब्यूटर अपने खाते के नीचे पाँच स्तर तक सब-रीसेलर बना सकता है।
समर्थक एक्सेस का कॉन्फ़िगरेशन
हर समर्थक की एक लाइन।
- अपनी शॉप का कनेक्टर इंस्टॉल करें (जैसे WooCommerce) और Reseller API कुंजी तथा हर प्रोडक्ट से मेल खाता पैकेज दर्ज करें।
- सब्सक्रिप्शन पर कनेक्टर पैकेज और रिक्वेस्ट आईडी के साथ create_line कॉल करता है; बिलिंग अवधि पैकेज की अवधि है।
- अधिकतम कनेक्शन उतने डिवाइसों पर सेट करें जितने समर्थक इस्तेमाल कर सकता है, आमतौर पर दो या तीन।
- गिवअवे या लॉन्च के लिए एक्टिवेशन कोड थोक में बनाएँ या ट्रायल पैकेज के साथ Lines → जोड़ें से लाइनें जोड़ें।
शो लाइब्रेरी
ऑन डिमांड एपिसोड।
- हर एपिसोड को स्रोत के रूप में अपलोड करें, या VOD इन्जेस्ट जॉब से इन्जेस्ट करें; शीर्षक, सीज़न, एपिसोड नंबर और, अगर शो में हो, TMDB मेटाडेटा भरें।
- हर सीरीज़ को उन टियरों के बुके से जोड़ें जो उसे देख सकते हैं।
- रिलीज़ की घोषणा से पहले हर टियर की टेस्ट लाइन से प्लेबैक जाँचें।
स्टूडियो का चैनल
चौबीसों घंटे चलने वाला चैनल।
- स्टूडियो के प्लेआउट (RTMP पुश) के लिए लाइव स्ट्रीम जोड़ें और उसे हर उस टियर के बुके में रखें जिसमें चैनल शामिल है।
- चैनल की गाइड XMLTV के रूप में लोड करें ताकि समर्थक देखें कि क्या चल रहा है, और जिन शो को दोबारा देखना सार्थक है उन पर कैच-अप चालू करें।
- रिलीज़ के बीच प्लेआउट को स्टूडियो की अपनी शेड्यूल की गई सामग्री से चलाते रखें; पैनल सिर्फ़ स्ट्रीम को आगे पहुँचाता है।
सब्सक्रिप्शन की समाप्ति
एक्सेस भुगतान के साथ चलता है।
- लाइन अपने पैकेज की अवधि के अंत में समाप्त होती है; अगला भुगतान आने पर शॉप उसे renew_line से रिन्यू करती है।
- शॉप को वेबहुक के लिए सब्सक्राइब करें ताकि line.expiring पर रिमाइंडर भेजा जाए और line.expired पर समर्थक का टियर घटाया जाए।
- रद्द करने वाले समर्थक को शॉप disable_line से बंद करती है, और लाइन बाद में नया खाता बनाए बिना रिन्यू की जा सकती है।
शॉप के साथ इंटीग्रेशन
शॉप बेचती है; प्लेयर चलाता है।
- कनेक्टर ऑर्डरों के साथ तालमेल में लाइनें बनाता, रिन्यू करता और बंद करता है; कोई भी दूसरी शॉप Reseller API और वेबहुक इस्तेमाल करती है।
- एफ़िलिएट्स अपने डैशबोर्ड में अपनी लाइनें देखते हैं, और Reseller API उन्हें इसे ऑटोमेट करने देती है।
- दर्शकों के लिए सिंगल साइन-ऑन नहीं है: समर्थक प्लेयर में अपनी लाइन के क्रेडेंशियल से साइन इन करते हैं, जो शॉप उन्हें भेजती है।
सुरक्षा संबंधी विचार
सिर्फ़ सर्वर नहीं, सब्सक्रिप्शन की भी सुरक्षा करें।
- पैनल और प्लेबैक बेस URL को TLS पर परोसें और TRUSTED_PROXIES को अपने रिवर्स प्रॉक्सी पर सेट करें।
- हर पैनल खाते के लिए टू-फ़ैक्टर साइन-इन, और अनुमति ग्रुप ताकि एफ़िलिएट्स कैटलॉग न बदल सकें।
- साइन किए गए और समाप्त होने वाले प्लेबैक लिंक और हर लाइन पर कनेक्शन सीमा; अगर लाइसेंस क्षेत्रीय है तो लाइन को किसी देश से बाँधें।
- ऑफ़-साइट कॉपी के साथ एन्क्रिप्टेड डेटाबेस बैकअप, और लाइनों व कैटलॉग के हर बदलाव के लिए ऑडिट लॉग।
समस्या-निवारण
आम तौर पर पहली जाँचें।
- नया समर्थक भुगतान के बाद देख नहीं पाता: Reseller API लॉग में शॉप कनेक्टर की कॉल और लाइन की समाप्ति तिथि जाँचें।
- समर्थक को ऊँचे टियर का कंटेंट दिखता है: लाइन का पैकेज और वह जो बुके देता है उन्हें जाँचें।
- प्लेआउट चक्र के अंत में चैनल रुक जाता है: लाइव स्ट्रीम पर एनकोडर का पुश और स्ट्रीम की प्रोब स्थिति जाँचें।
- एफ़िलिएट की बिक्री नहीं दिखती: उसके क्रेडिट जाँचें और यह भी कि उसके इस्तेमाल किया पैकेज उसके ग्रुप का है।