Hoe de Xtream API werkt: de logica van IPTV-sessies
Redactieteam Euro TV Pro
De Xtream API is de interface die IPTV-providers gebruiken om gegevens zoals de zenderlijst, het filmarchief en de programmagids naar speler-apps over te dragen. Voor de gebruiker zijn alleen de velden serveradres, gebruikersnaam en wachtwoord zichtbaar.
In dit artikel leggen we de rol van de API tussen het paneel, de speler en de gebruiker uit, evenals de sessiestroom, de gegevenstypen en de punten om op te letten bij de beveiliging van het account.
Wat is de Xtream API?
Een API (application programming interface) laat twee softwaresystemen volgens specifieke regels met elkaar praten. In het voorbeeld van de Xtream API is de ene kant de server van de provider en de andere kant de speler-app.
De speler stuurt een gedefinieerd verzoek naar de server en ontvangt als antwoord de zenderlijst, categorie-informatie, de film- en seriecatalogus en gidsgegevens. De gebruiker ziet alleen het resultaat in de interface.
Deze structuur biedt gemak voor de gebruiker: zenders, archief en gids worden met één set sessiegegevens op dezelfde plek beheerd. De vergelijking met het alternatieve afspeellijstformaat staat in het M3U artikel. M3U en Xtream Codes artikel.
De relatie tussen het paneel, de API en de speler
Aan de kant van de provider is er een beheerpaneel. Het paneel beheert gebruikersaccounts, pakketten, zenderbronnen en serververdeling. De API is de laag die deze gegevens naar buiten toe beschikbaar maakt.
| Laag | Taak | Effect op de gebruiker |
|---|---|---|
| Paneel | Account-, pakket- en zenderbeheer | Pakketwijzigingen en nieuwe zenders |
| API | Draagt de gegevens over aan de speler | Weergave van afspeellijst en gids |
| Speler | Toont de gegevens en speelt de stream af | Ervaring in dagelijks gebruik |
| Streamingserver | Draagt de stream | Streamkwaliteit en soepelheid |
Weten welke laag is getroffen wanneer zich een probleem voordoet, versnelt de diagnose. Als de afspeellijst niet aankomt, moet de sessie of de API worden onderzocht; als de afspeellijst aankomt maar de stream niet opent, moet de streamingserver worden onderzocht.
De sessiestroom stap voor stap
Het inlogproces bestaat uit een paar stappen. Tijdens de installatie wordt deze stroom binnen enkele seconden voltooid.
-
1. Het serveradres wordt ingevoerd: het adres dat u van de provider hebt ontvangen, wordt gedefinieerd.
-
2. De identiteitsgegevens worden verzonden: er wordt een sessie aangevraagd met de gebruikersnaam en het wachtwoord.
-
3. De sessie wordt geverifieerd: de pakketstatus en de limiet voor gelijktijdig kijken worden gecontroleerd.
-
4. De categorieën worden ontvangen: de zender-, film- en seriecategorieën worden weergegeven.
-
5. De gegevens worden gedownload: de afspeellijst en de gids worden naar de speler overgedragen.
-
6. De stream start: wanneer een zender wordt gekozen, wordt het streamadres met de sessiegegevens opgevraagd.
-
Na de installatie worden afspeellijst-updates via dezelfde stroom ontvangen; daarom verschijnen nieuwe zenders over het algemeen wanneer de app opnieuw wordt gestart.
Zender-, archief- en gidsgegevens
De gegevens die via de API worden ontvangen, zijn niet van één enkel type. Livezenders, archiefcontent en gidsgegevens worden met verschillende verzoeken ontvangen.
-
Livezenders: deze komen samen met de categorie- en zendernaaminformatie.
-
Filmarchief: het wordt weergegeven met de filmnaam, het jaar en soms de cover; de details staan in het wat is VOD artikel.
-
Seriearchief: de seizoens- en afleveringsstructuur wordt met afzonderlijke verzoeken ontvangen.
-
Gidsgegevens: programma-informatie wordt gekoppeld aan zenderidentiteiten; de details staan in het wat is EPG artikel.
Naarmate het datavolume groeit, wordt de laadtijd van de afspeellijst langer. Bij abonnementen met veel zenders verkort het verbergen van categorieën in de spelerinstellingen of het gebruik van een favorietenlijst de laadtijd.
Beveiliging en het delen van accounts
De sessiegegevens zijn de enige sleutel tot het abonnement. Als ze worden gedeeld, kan het account op andere apparaten worden gebruikt en raakt de limiet voor gelijktijdig kijken snel uitgeput.
-
Gegevens delen: het serveradres, de gebruikersnaam en het wachtwoord mogen niet met derden worden gedeeld.
-
Gelijktijdig kijken: het aantal apparaten dat tegelijk is toegestaan, hangt af van het pakket.
-
Apparaatwissel: wanneer het apparaat verandert, moet de sessie op het oude apparaat worden gesloten.
-
Verdachte activiteit: bij onverwachte onderbrekingen in het account moet de provider worden geïnformeerd.
De keuze voor de limiet voor gelijktijdig kijken en het aantal apparaten één apparaat of meerdere artikel, en de beoordelingscriteria voor providers in de providerkeuze artikel.
Veelvoorkomende problemen
De meeste sessiegerelateerde problemen komen voort uit de identiteitsgegevens of de verbinding.
-
Inloggen mislukt: de gebruikersnaam en het wachtwoord zijn hoofdlettergevoelig; een kopieerfout moet worden gecontroleerd.
-
De afspeellijst is leeg: de pakketperiode kan zijn verlopen of de limiet voor gelijktijdig kijken kan zijn overschreden.
-
Het archief is niet zichtbaar: de pakketomvang of de spelerversie kan een factor zijn.
-
De gids is leeg: de brondefinitie en de tijdzone-instelling moeten worden herzien.
Veelgestelde vragen
Wat is de Xtream API?
Het is de interface die de provider gebruikt om zender-, archief- en gidsgegevens naar speler-apps over te dragen; aan de gebruikerskant werkt het met sessiegegevens.
Zijn Xtream Codes en Xtream API hetzelfde?
Xtream Codes definieert de paneelinfrastructuur en de API definieert de gegevensoverdrachtlaag van deze infrastructuur; vanuit het oogpunt van de gebruiker werken de twee samen.
Wat gebeurt er als mijn sessiegegevens worden gedeeld?
Het account kan op andere apparaten worden gebruikt en de limiet voor gelijktijdig kijken kan worden uitgeput, waardoor de stream wordt onderbroken.
Hoe vindt de afspeellijst-update plaats?
Wanneer de app opnieuw wordt geopend, worden de afspeellijst- en gidsgegevens via dezelfde sessie vernieuwd.
Wat moet ik doen als het inloggen mislukt?
Controleer of de gebruikersnaam en het wachtwoord qua hoofdletters overeenkomen en of er een kopieerfout is.
Bronnen
Voor de technische uitspraken in dit artikel zijn officiële bronnen geraadpleegd: Xtream Codes – Paneel- en API-documentatie, ITU-T Y.1901 – Requirements for IPTV services, RFC 8216 – HTTP Live Streaming. Deze bronnen leggen uit hoe uitzendtechnologie in het algemeen werkt; voor de dienstomvang en apparaatondersteuning verwijzen we naar de betreffende pakket- en supportpagina's.
Tags:
XCIPTV installeren: stap-voor-stap installatiegids
