ये गाइड किसी उद्योग की अवधारणाओं को उन ऑब्जेक्ट से जोड़ती हैं जो प्लेटफ़ॉर्म में आज हैं (बुके, लाइनें, पैकेज, पार्टनर खाते, नोड्स, API)। ये वैचारिक मैपिंग हैं, उद्योग-विशिष्ट फ़ीचर नहीं, और पार्टनर खाता एक प्रतिनिधि खाता है, अलग-थलग टेनेंट नहीं।
वैचारिक मैपिंग
पैनल में कुछ भी कमरा या ठहराव नहीं कहलाता। तालिका बताती है कि कौन-सा ऑब्जेक्ट कौन-सी भूमिका निभाता है; नीचे के अध्याय उन्हें उसी क्रम में सेट करते हैं।
| आपके उद्योग में | प्लेटफ़ॉर्म पर | पैनल में कहाँ |
|---|---|---|
| होटल ऑपरेटर या अधिकृत पार्टनर | पार्टनर खाता (रीसेलर): क्रेडिट, अनुमतियों और अपनी लाइनों वाला प्रतिनिधि डैशबोर्ड | Users → रीसेलर जोड़ें; उसकी अनुमतियों के लिए Groups |
| चैनल पैकेज | बुके: चैनलों, फ़िल्मों या सीरीज़ का नामित समूह जो कोई पैकेज देता है | Bouquets, Streams और Movies / Series से |
| कमरा या डिवाइस | लाइन: एक एक्सेस, अपने पैकेज, बुके, समाप्ति, कनेक्शन सीमा और आउटपुट के साथ | Lines → जोड़ें, या एक्टिवेशन कोड, या Reseller API |
| होटल के जानकारी वीडियो | VOD कैटलॉग: सीज़न और एपिसोड वाली फ़िल्में और सीरीज़, श्रेणियाँ और मेटाडेटा | Movies और Series, या VOD इन्जेस्ट जॉब |
| लाइसेंस वाले टेलीविज़न चैनल | लाइव चैनल: अपने स्रोतों, EPG और आउटपुट फ़ॉर्मैट वाली स्ट्रीम | Streams → लाइव स्ट्रीम जोड़ें (स्रोत URL या RTMP पुश) |
| ठहरने की अवधि | लाइन की समाप्ति तिथि, जिसे पैकेज, क्रेडिट या API रिन्यू करती है | लाइन की समाप्ति तिथि और पैकेज की अवधि |
| हर इमारत या विंग के लिए एक नोड | स्ट्रीमिंग नोड्स: पैनल से जोड़े गए एज सर्वर, हर साइट या इमारत के लिए एक | Servers → नोड जोड़ें, SSH से इंस्टॉल |
पूर्वापेक्षाएँ
इंस्टॉल करने से पहले क्या होना चाहिए।
- प्रॉपर्टी नेटवर्क पर एक सर्वर (Ubuntu 22.04 या 24.04), इंस्टॉलर, और ऐसा पता जिस तक कमरों के डिवाइस पहुँच सकें।
- वे चैनल फ़ीड जिनके अधिकार प्रॉपर्टी के पास हैं (पुल URL या RTMP), होटल के जानकारी वीडियो, और कमरों के डिवाइस (Android TV बॉक्स, MAG या Enigma2 बॉक्स, प्लेयर ऐप या ब्राउज़र वाले स्मार्ट टीवी)।
- चेक-इन और चेक-आउट पर PMS की HTTP API कॉल करने की क्षमता, या इसे पैनल में करने की डेस्क प्रक्रिया।
इन्फ्रास्ट्रक्चर डिप्लॉयमेंट
केंद्रीय सर्वर और हर इमारत के लिए एक नोड।
- केंद्रीय सर्वर पर इंस्टॉलर चलाएँ; प्लेबैक बेस को प्रॉपर्टी के आंतरिक पते पर सेट करें ताकि कमरे स्थानीय नेटवर्क पर ही रहें।
- चैनल फ़ीड Streams के अंतर्गत और जानकारी वीडियो Movies के अंतर्गत जोड़ें; उन्हें वेब प्लेयर में जाँचें।
- Servers से हर विंग या इमारत के लिए एक नोड जोड़ें; पैनल उसे SSH से इंस्टॉल करता है और उस इमारत के कमरों को उसी तक भेजता है।
- सर्वर पर लाइसेंस कुंजी सेट करें; सक्रियण साइट पर होता है और सेवा अपलिंक के बिना चलती है।
कंटेंट का संगठन
चैनल पैकेज और होटल के वीडियो।
- प्रॉपर्टी के चैनलों से हर चैनल पैकेज (स्टैंडर्ड कमरे, सुइट, सम्मेलन) के लिए एक बुके बनाएँ।
- होटल वीडियो (स्वागत, सुविधाएँ, सुरक्षा) का एक बुके बनाएँ और उसे हर पैकेज में जोड़ें।
- हर कमरे की श्रेणी के लिए एक पैकेज बनाएँ, जिसमें उसके बुके और एक दिन की अवधि हो: चेक-इन पर कमरे की लाइन ठहरने की हर रात के लिए एक बार रिन्यू होती है (हर रिन्यूअल पैकेज की अवधि जोड़ता है), और चेक-आउट पर उसे अक्षम कर दिया जाता है (अध्याय 8)।
- चैनलों को क्रम में रखें और उन्हें लोगो दें ताकि टेलीविज़न का मेन्यू अच्छा पढ़ा जाए।
पार्टनर (रीसेलर) कॉन्फ़िगरेशन
प्रॉपर्टी, या कई प्रॉपर्टी चलाने वाला ऑपरेटर, प्रतिनिधि खाते के रूप में।
- ऐसी अनुमतियों वाला ग्रुप बनाएँ जो लाइनों (कमरों) तक सीमित हों और कैटलॉग में कोई बदलाव न हो।
- प्रॉपर्टी के फ़्रंट डेस्क, या ऑपरेटर को उस ग्रुप और कमरे के पैकेजों के साथ रीसेलर के रूप में जोड़ें।
- कई प्रॉपर्टी वाले ऑपरेटर को हर प्रॉपर्टी के लिए एक रीसेलर मिलता है, हर एक के अपने कमरे और क्रेडिट के साथ।
कमरे (लाइन) का कॉन्फ़िगरेशन
हर कमरे के लिए एक लाइन, उसके नंबर से नाम दी गई।
- Lines के अंतर्गत हर कमरे के लिए एक लाइन बनाएँ, कमरा नंबर को उसका नाम और कमरे की श्रेणी का पैकेज देकर।
- अधिकतम कनेक्शन 1 (एक टेलीविज़न) या कमरे में स्क्रीनों की संख्या पर सेट करें।
- जब नेटवर्क डिवाइस को निश्चित पते देता है, तब लाइन को कमरे के डिवाइस के पते से बाँधें।
- डिवाइस को (लाइन के क्रेडेंशियल के साथ Xtream Codes API या M3U, या MAG / Enigma2 पोर्टल) एक बार कॉन्फ़िगर करें; क्रेडेंशियल कमरे के साथ रहते हैं।
होटल के जानकारी वीडियो
प्रॉपर्टी के अपने वीडियो ऑन डिमांड।
- स्वागत और जानकारी वीडियो फ़िल्मों के रूप में अपलोड करें, प्रॉपर्टी के भाषा संस्करण अलग प्रविष्टियों या ऑडियो ट्रैक के रूप में।
- उन्हें होटल वीडियो बुके में रखें ताकि कमरे की हर श्रेणी उन्हें पाए।
- जानकारी बदलने पर उन्हें पैनल से अपडेट करें; कमरे नया संस्करण तुरंत देखते हैं।
लाइसेंस वाले टेलीविज़न चैनल
प्रॉपर्टी के चैनल लाइव स्ट्रीम के रूप में।
- हर लाइसेंस वाला चैनल Streams के अंतर्गत उसके फ़ीड के साथ जोड़ें; टाइमशिफ़्ट या कैच-अप केवल वहीं सक्षम करें जहाँ लाइसेंस अनुमति दे।
- EPG स्रोत जोड़ें ताकि टेलीविज़न पर गाइड कार्यक्रम दिखाए।
- क्षेत्र-सीमित चैनलों को ऐसे बुके में रखें जिन्हें केवल सही पैकेज देते हों।
चेक-इन, चेक-आउट और समाप्ति
लाइन की वैधता के रूप में ठहरना।
- चेक-इन पर कमरे की लाइन सक्षम करें और उसे ठहरने की अवधि के लिए रिन्यू करें (API से PMS, या पैनल में डेस्क)।
- चेक-आउट पर लाइन अक्षम करें; नया ठहराव उसे फिर सक्षम करता है, इसलिए क्रेडेंशियल कमरे से बाहर नहीं जाते।
- सक्षम, अक्षम और समाप्त लाइनें देखने के लिए PMS या डेस्क को webhooks की सदस्यता दें।
PMS के साथ इंटीग्रेशन
चेक-इन और चेक-आउट कमरों को चलाते हैं।
- PMS के लिए एक Reseller API कुंजी बनाएँ और उसे PMS के कॉन्फ़िगरेशन में रखें।
- चेक-इन पर PMS कमरे की लाइन के लिए रिक्वेस्ट आईडी के साथ action=enable_line और action=renew_line कॉल करता है; चेक-आउट पर action=disable_line।
- अतिथि-सेवा एप्लिकेशन (स्टाफ़ को बुलाना, हाउसकीपिंग, एक्सप्रेस चेक-आउट, रूम सर्विस) और उसका बैक-ऑफ़िस कनेक्शन Enterprise प्लान का हिस्सा हैं और प्रॉपर्टी के साथ स्कोप किए जाते हैं।
सुरक्षा संबंधी विचार
चैनलों को प्रॉपर्टी के भीतर रखें।
- प्लेबैक बेस और नोड्स को प्रॉपर्टी के नेटवर्क पर रखें; इंटरनेट पर ऐसा कुछ उजागर न करें जो कमरों को नहीं चाहिए।
- हर कमरे का एक कनेक्शन, डिवाइस से बँधा; हस्ताक्षरित लिंक समाप्त हो जाते हैं, इसलिए कॉपी किया गया लिंक काम करना बंद कर देता है।
- पैनल के लिए दो-चरणीय साइन-इन; डेस्क को सीमित अनुमति ग्रुप मिलता है।
- एन्क्रिप्टेड डेटाबेस बैकअप चालू करें; कमरों के क्रेडेंशियल उसी में रहते हैं।
समस्या-निवारण
आम तौर पर पहली जाँचें।
- किसी कमरे में टेलीविज़न नहीं है: जाँचें कि उसकी लाइन सक्षम है और समाप्त नहीं हुई, फिर डिवाइस के क्रेडेंशियल और पता।
- किसी कमरे में चैनल नहीं दिख रहा: कमरे की श्रेणी के पैकेज का बुके जाँचें।
- इंटरनेट बंद होने पर टेलीविज़न रुक जाता है: जाँचें कि प्लेबैक बेस और स्रोत आंतरिक पते हैं; बाहरी फ़ीड अपलिंक पर निर्भर करते हैं।
- PMS कॉल विफल होती है: API कुंजी जाँचें, कि राइट POST हैं, और रीट्राई पर रिक्वेस्ट आईडी।