Αυτοί οι οδηγοί αντιστοιχίζουν τις έννοιες ενός κλάδου στα αντικείμενα που έχει σήμερα η πλατφόρμα (bouquets, lines, πακέτα, λογαριασμοί διανομέων, κόμβοι, το API). Είναι εννοιολογικές αντιστοιχίσεις, όχι λειτουργίες ειδικές για κλάδο, και ο λογαριασμός διανομέα είναι ανατεθειμένος λογαριασμός, όχι απομονωμένος tenant.
Εννοιολογική αντιστοίχιση
Τίποτα στον πίνακα δεν λέγεται εκπομπή ή υποστηρικτής. Ο πίνακας δείχνει ποιο αντικείμενο παίζει ποιον ρόλο· τα κεφάλαια παρακάτω τα στήνουν με αυτή τη σειρά.
| Στον κλάδο σας | Στην πλατφόρμα | Πού στον πίνακα |
|---|---|---|
| Το κανάλι του στούντιο | Ζωντανό κανάλι: ένα stream με τις πηγές, το EPG και τις μορφές εξόδου του | Streams → προσθήκη ζωντανού stream (URL πηγής ή αποστολή RTMP) |
| Βιβλιοθήκη εκπομπών | Κατάλογος VOD: ταινίες και σειρές με σεζόν και επεισόδια, κατηγορίες και μεταδεδομένα | Movies και Series, ή η εργασία VOD ingest |
| Επίπεδο συνδρομής | Bouquet: ονομασμένο σύνολο καναλιών, ταινιών ή σειρών που παραχωρεί ένα πακέτο | Bouquets, από Streams και Movies / Series |
| Πρόσβαση υποστηρικτή | Line: μία πρόσβαση με το πακέτο, τα bouquets, τη λήξη, το όριο συνδέσεων και τις εξόδους της | Lines → προσθήκη, ή κωδικοί ενεργοποίησης, ή το Reseller API |
| Περίοδος χρέωσης | Ημερομηνία λήξης του line, που ανανεώνεται με πακέτο, credit ή το API | Η ημερομηνία λήξης του line και η διάρκεια του πακέτου |
| Λογαριασμός affiliate ή διανομέα | Λογαριασμός μεταπωλητή: ανατεθειμένος πίνακας με credits, δικαιώματα και δικά του lines | Users → προσθήκη μεταπωλητή· Groups για τα δικαιώματά του |
| Ενσωμάτωση καταστήματος ή συνδρομών | Reseller API και webhooks: οι λειτουργίες του πίνακα από το δικό σας σύστημα | Κλειδιά Reseller API και webhooks στον πίνακα του μεταπωλητή |
Προαπαιτούμενα
Τι να έχετε πριν την εγκατάσταση.
- Έναν διακομιστή (Ubuntu 22.04 ή 24.04) με δημόσια διεύθυνση ή domain και αρκετό εύρος ζώνης upstream για το κοινό που περιμένετε.
- Τα έτοιμα επεισόδια, το playout ή τον encoder του στούντιο για το κανάλι και ένα κατάστημα σε πλατφόρμα με connector, ή τη δυνατότητα κλήσης ενός HTTP API.
- Μια απόφαση για τα επίπεδα και τους affiliates: τι χορηγεί κάθε συνδρομή και ποιος μπορεί να την πουλά.
Εγκατάσταση υποδομής
Πρώτα ένας διακομιστής, nodes όσο μεγαλώνει το κοινό.
- Εκτελέστε το πρόγραμμα εγκατάστασης στον διακομιστή διαχείρισης και βάλτε τον πίνακα πίσω από reverse proxy με TLS· ορίστε τα trusted proxies ώστε οι κανόνες IP να βλέπουν την πραγματική διεύθυνση του θεατή.
- Ορίστε το playback base URL στη δημόσια διεύθυνση στην οποία φτάνει το κοινό σας.
- Εγγράψτε ένα node από τους Servers σε μια περιοχή όπου βλέπουν πολλοί υποστηρικτές· ο πίνακας το εγκαθιστά μέσω SSH και κατευθύνει σε αυτό τους θεατές της περιοχής.
- Δημιουργήστε έναν λογαριασμό συνεργάτη (reseller) για κάθε μέλος του προσωπικού που διαχειρίζεται τον κατάλογο ή τους υποστηρικτές, με δική του ομάδα δικαιωμάτων.
Οργάνωση περιεχομένου
Εκπομπές ως σειρές, επίπεδα ως bouquets.
- Δημιουργήστε κατηγορίες ανά είδος και μία σειρά ανά εκπομπή με μια σεζόν ανά δέσμη κυκλοφορίας και ένα επεισόδιο ανά βίντεο.
- Δημιουργήστε ένα bouquet για το ζωντανό κανάλι, ένα για το δωρεάν ή εισαγωγικό περιεχόμενο και ένα για κάθε ανώτερο επίπεδο.
- Δημιουργήστε ένα πακέτο ανά επίπεδο με την περίοδο χρέωσης ως διάρκεια, ένα δοκιμαστικό πακέτο για νέους επισκέπτες αν θέλετε και μια τιμή σε credits για τους affiliates.
- Κρατήστε τον κατάλογο αρχείου στη δική του κατηγορία ώστε να μετακινείται μεταξύ επιπέδων χωρίς να αγγίζετε τις σειρές.
Ρύθμιση συνεργατών (reseller)
Affiliates και διανομείς.
- Δημιουργήστε μια ομάδα για affiliates μόνο με δικαιώματα lines, ώστε να μην μπορούν να αλλάξουν τον κατάλογο.
- Προσθέστε κάθε affiliate ως reseller με αυτή την ομάδα και ένα υπόλοιπο credits· η τιμή του πακέτου του είναι ό,τι αποφασίσει το στούντιο.
- Ένας διανομέας με υπο-affiliates μπορεί να δημιουργήσει sub-resellers κάτω από τον δικό του λογαριασμό, έως πέντε επίπεδα βάθος.
Ρύθμιση πρόσβασης υποστηρικτών
Ένα line ανά υποστηρικτή.
- Εγκαταστήστε το connector του καταστήματός σας (για παράδειγμα WooCommerce) και εισάγετε το κλειδί Reseller API και το πακέτο που αντιστοιχεί σε κάθε προϊόν.
- Κατά τη συνδρομή το connector καλεί create_line με το πακέτο και ένα request id· η περίοδος χρέωσης είναι η διάρκεια του πακέτου.
- Ορίστε τις μέγιστες συνδέσεις στον αριθμό συσκευών που μπορεί να χρησιμοποιεί ένας υποστηρικτής, συνήθως δύο ή τρεις.
- Για ένα δώρο ή μια εκκίνηση, δημιουργήστε κωδικούς ενεργοποίησης μαζικά ή προσθέστε lines από Lines → add με ένα δοκιμαστικό πακέτο.
Βιβλιοθήκη εκπομπών
Επεισόδια κατά παραγγελία.
- Ανεβάστε κάθε επεισόδιο ως πηγή, ή εισάγετέ το με τη διεργασία VOD ingest· συμπληρώστε τον τίτλο, τη σεζόν, τον αριθμό επεισοδίου και τα μεταδεδομένα TMDB αν η εκπομπή έχει.
- Συνδέστε κάθε σειρά με τα bouquets των επιπέδων που μπορούν να τη δουν.
- Ελέγξτε την αναπαραγωγή με ένα δοκιμαστικό line κάθε επιπέδου πριν ανακοινώσετε μια κυκλοφορία.
Το κανάλι του στούντιο
Ένα κανάλι όλο το 24ωρο.
- Προσθέστε ένα ζωντανό stream για το playout του στούντιο (RTMP push) και τοποθετήστε το στα bouquets κάθε επιπέδου που περιλαμβάνει το κανάλι.
- Φορτώστε τον οδηγό του καναλιού ως XMLTV ώστε οι υποστηρικτές να βλέπουν τι παίζει, και ενεργοποιήστε το catch-up για τις εκπομπές που αξίζει να επαναληφθούν.
- Κρατήστε το playout σε λειτουργία ανάμεσα στις κυκλοφορίες με δικό του προγραμματισμένο περιεχόμενο του στούντιο· ο πίνακας απλώς αναμεταδίδει το stream.
Λήξη συνδρομής
Η πρόσβαση ακολουθεί την πληρωμή.
- Ένα line λήγει στο τέλος της περιόδου του πακέτου του· το κατάστημα το ανανεώνει με renew_line όταν φτάσει η επόμενη πληρωμή.
- Εγγράψτε το κατάστημα στα webhooks για να στέλνει υπενθύμιση στο line.expiring και να υποβιβάζει έναν υποστηρικτή στο line.expired.
- Ένας υποστηρικτής που ακυρώνει απενεργοποιείται από το κατάστημα με disable_line και το line μπορεί να ανανεωθεί αργότερα χωρίς νέο λογαριασμό.
Ενσωμάτωση με το κατάστημα
Το κατάστημα πουλά· ο player παίζει.
- Το connector δημιουργεί, ανανεώνει και απενεργοποιεί lines σε συγχρονισμό με τις παραγγελίες· κάθε άλλο κατάστημα χρησιμοποιεί το Reseller API και webhooks.
- Οι affiliates βλέπουν τα δικά τους lines στον πίνακά τους και το Reseller API τους επιτρέπει να το αυτοματοποιήσουν.
- Δεν υπάρχει ενιαία σύνδεση (single sign-on) για θεατές: οι υποστηρικτές συνδέονται στον player με τα διαπιστευτήρια του line τους, που τους στέλνει το κατάστημα.
Ζητήματα ασφάλειας
Προστατέψτε τη συνδρομή, όχι μόνο τον διακομιστή.
- Εξυπηρετήστε τον πίνακα και το playback base URL μέσω TLS και ορίστε το TRUSTED_PROXIES στο reverse proxy σας.
- Σύνδεση δύο παραγόντων για κάθε λογαριασμό του πίνακα και ομάδες δικαιωμάτων ώστε οι affiliates να μην μπορούν να αλλάξουν τον κατάλογο.
- Υπογεγραμμένοι σύνδεσμοι αναπαραγωγής που λήγουν και όριο συνδέσεων ανά line· δέστε ένα line σε χώρα αν μια άδεια είναι περιφερειακή.
- Κρυπτογραφημένα αντίγραφα ασφαλείας της βάσης με εξωτερικό αντίγραφο και το audit log για κάθε αλλαγή lines και καταλόγου.
Αντιμετώπιση προβλημάτων
Οι συνηθισμένοι πρώτοι έλεγχοι.
- Ένας νέος υποστηρικτής δεν μπορεί να δει μετά την πληρωμή: ελέγξτε την κλήση του connector του καταστήματος στο log του Reseller API και την ημερομηνία λήξης του line.
- Ένας υποστηρικτής βλέπει περιεχόμενο ανώτερου επιπέδου: ελέγξτε το πακέτο του line και τα bouquets που χορηγεί.
- Το κανάλι σταματά στο τέλος ενός κύκλου playout: ελέγξτε το push του encoder στο ζωντανό stream και την κατάσταση probe του stream.
- Η πώληση ενός affiliate δεν εμφανίζεται: ελέγξτε τα credits του και ότι το πακέτο που χρησιμοποίησε ανήκει στην ομάδα του.