Se connecter avec un compte fournisseur (API Xtream) sur Xbox
Des identifiants du fournisseur vous apportent trois choses qu’une playlist plate ne peut pas exprimer. Vous les saisissez une fois dans un navigateur, et la console hérite des trois.
Si votre fournisseur vous a remis un nom d’utilisateur, un mot de passe et un hôte, vous avez des identifiants pour l’API Xtream. Utilisez-les plutôt que l’export M3U que le même fournisseur vous donnera aussi volontiers. L’export est un instantané. L’API est une conversation, et trois choses découlent de cette différence.
Où vont les identifiants
Pas sur la console. La Xbox n’a aucun champ pour un hôte, un nom d’utilisateur ou un mot de passe, et l’écran des sources y dit ce qu’il est : en lecture seule, synchronisé depuis la console web.
Ouvrez la console web, allez dans Sources, ajoutez une source Xtream, et donnez-lui les trois valeurs que votre fournisseur vous a envoyées. Elles arrivent généralement sous cette forme :
Host https://provider.example.com
Username your-username
Password your-password
Chaque valeur est acceptée jusqu’à 2048 caractères, donc la longueur est rarement la raison d’un échec de connexion. Enregistrez. La console récupère la source à sa prochaine synchronisation, comme l’un des 13 types d’état de compte qui vous suivent d’un appareil à l’autre, et vous ne tapez jamais rien de tout cela à la manette.
Il y a une raison de sécurité à préférer ce sens, en plus de la raison ergonomique. Des identifiants saisis dans un navigateur entrent une fois dans votre compte. Des identifiants tapés sur l’écran partagé du salon sont tapés devant tous ceux qui sont dans la pièce.
Ce que l’API du fournisseur vous donne qu’un fichier ne peut pas
Un export de playlist est une liste d’URL figée à l’instant où elle a été générée. L’API du fournisseur répond à des questions, et le client lui en pose plusieurs. Toute l’API Xtream est un seul point d’accès prenant un paramètre d’action, et 15 actions couvrent tout ce qui suit.
La première est le catalogue lui-même, catégories comprises, ce qui permet à la console de vous montrer les groupes de votre fournisseur au lieu d’un mur plat de chaînes. La deuxième est l’archive : le fournisseur peut dire quelles chaînes conservent une fenêtre de retour en arrière et sur combien de jours elle s’étend, ce qui est toute la base du rattrapage. Voir ce que sont réellement le rattrapage et le timeshift.
La troisième est celle que l’on découvre à ses dépens. Le fournisseur indique combien de connexions simultanées votre abonnement autorise. Ce nombre n’est pas décoratif : c’est pourquoi une chaîne qui joue sur la Xbox refuse de jouer sur l’ordinateur portable au même moment, et pourquoi le multiview le manie avec précaution.
Le multiview compte ce budget avant d’attribuer une tuile, pas après. Demandez une grille 3x3 de 9 tuiles à un abonnement qui autorise 2 connexions et le sélecteur cesse de proposer des chaînes de cette source dès que la deuxième est prise, plutôt que de démarrer 9 flux et de laisser le fournisseur en rejeter 7. C’est un choix délibéré sur l’endroit où l’échec se produit. Limites de connexion du fournisseur détaille cette comptabilité.
Le réglage Format de flux
Une source Xtream a un contrôle Format de flux. Il ne change actuellement rien. Il normalise sa valeur, l’enregistre et la recharge, et aucun constructeur d’URL ni aucun code de lecture ne la relit.
Quelle que soit sa valeur, le client demande une URL en direct se terminant par .ts, de cette forme :
https://provider.example.com/stream/12345.ts
L’adresse réelle porte aussi vos identifiants, c’est pourquoi elle n’est pas montrée ici. C’est ce que nous demandons, pas ce que renvoie le serveur du fournisseur. Un fournisseur est libre de rediriger cette requête vers un manifeste HLS, et certains le font ; le client ne le sonde pas. MPEG-TS ou HLS contient l’argumentaire et les mesures.
Ce qui n’est pas encore sur la console
Le rattrapage est la lacune à reconnaître honnêtement. Il a d’abord été livré sur la tête desktop, et la page console correspondante est encore un travail en attente. Donc un fournisseur qui propose une archive de 7 jours vous donne cette archive dans l’Application Windows aujourd’hui, et sur la Xbox vous avez les chaînes en direct et la grille des programmes sans le retour en arrière. Même sur Windows, la fenêtre atteignable est bornée par la rétention du guide, qui garde 1 jour en arrière par défaut, plutôt que par les 7 jours annoncés par le fournisseur.
La grille elle-même est là. Sur la console, elle vit à l’intérieur de la TV en direct plutôt que comme destination séparée : ouvrez une chaîne, faites apparaître la couche des programmes, et les bumpers vous déplacent d’un jour à la fois. L’écran Guide autonome dans la navigation de l’application est encore un espace réservé.
Être précis là-dessus vaut mieux que l’alternative. Un article qui laisserait entendre une parité complète du rattrapage vous coûterait une soirée à chercher un bouton qui n’existe pas. Télévision de rattrapage sur Xbox dit ce qui fonctionne aujourd’hui et ce qui arrive.
Si la connexion au fournisseur échoue
La cause la plus courante n’est pas du tout le fournisseur. Les identifiants sont bons mais le compte est à sa limite de connexions, parce que quelque chose d’autre retient encore une connexion. Les fournisseurs n’expirent pas toujours immédiatement une session interrompue, si bien qu’un flux fermé il y a une minute sur un autre appareil peut encore compter. Quand le fournisseur répond et refuse, l’application dit pourquoi : un compte marqué expiré, désactivé ou banni, ou un mot de passe refusé, est signalé comme tel et non comme un problème de connexion.
Si la connexion échoue sur une machine et fonctionne sur une autre du même réseau, la différence se trouve sur cette machine plutôt que chez le fournisseur. Une playlist qui ne se charge pas parcourt le reste.
Ce que cet article a mesuré21 affirmations, chacune avec les preuves derrière elles
| Réclamation | Preuve | Compté |
|---|---|---|
| Il n’existe aucun écran sur la Xbox qui accepte un hôte de fournisseur, un nom d’utilisateur ou un mot de passe. Les sources sur la console sont une vue d’état en lecture seule. | n = 1 | 31 août 2026 |
| Le constructeur d’URL Xtream en direct du client ajoute un suffixe .ts sans paramètre ni branchement, et le constructeur de rattrapage fait de même. Cela décrit ce que le client demande, pas ce que renvoie le serveur du fournisseur. | n = 1 | 23 août 2026 |
| Le contrôle Format de flux proposé sur une source Xtream normalise, enregistre et recharge sa valeur, et aucun constructeur d’URL ni aucun code de lecture ne la relit. | n = 1 | 23 août 2026 |
| Le multiview compte le budget de connexions d’une source avant d’attribuer une tuile, et désactive les choix de chaînes supplémentaires depuis une source dès que celle-ci est épuisée. | n = 1 | 15 août 2026 |
| L’API Xtream est un point d’accès unique prenant un paramètre d’action plutôt qu’un ensemble de ressources, et 15 actions couvrent tout le catalogue : catégories et flux pour le direct, les films et les séries, le détail par élément, un guide court et une table de données. | n = 15 | 31 août 2026 |
| Les URL de films sont construites avec une extension de conteneur signalée par le fournisseur, contrairement aux URL en direct qui portent toujours un suffixe de flux de transport. Les films sont des fichiers stockés avec de vrais conteneurs, donc un client qui devinerait se tromperait. | n = 2 | 31 août 2026 |
| L’export de playlist est servi par le même serveur du fournisseur sur un autre chemin, donc un export et une session d’API sont deux vues d’un même compte plutôt que deux produits. | n = 1 | 31 août 2026 |
| Treize types d’état de compte se synchronisent vers la console, couvrant les favoris, la liste à voir, les récemment regardés, les groupes personnalisés, les surcharges de chaînes, les correspondances de guide, les préférences de source, les verrous parentaux, les préréglages de multiview, les groupes épinglés, les préférences sport, les définitions de sources agrégées et les affectations de sources par appareil. | n = 13 | 1 sept. 2026 |
| Les préférences par source sont elles-mêmes un état synchronisé, ce qui explique qu’un réglage fait dans un navigateur atteigne une console sans que la console n’offre jamais d’éditeur pour lui. | n = 1 | 1 sept. 2026 |
| La combinaison de plusieurs fournisseurs en une seule liste de chaînes est stockée comme une définition et résolue sur l’appareil, jamais sur le serveur. | n = 1 | 1 sept. 2026 |
| L’enregistrement de chaîne en direct ne porte aucun champ de conteneur, de transport ou de codec, donc rien dans le catalogue ne peut dire à un client ce qu’une chaîne est réellement avant de l’ouvrir. | n = 1 | 23 août 2026 |
| Une panne dans les 15 premières secondes d’une session envoie l’échelle de récupération directement vers un changement de source plutôt qu’un redémarrage, au motif que la source n’a jamais fait ses preuves. | n = 1 | 1 sept. 2026 |
| Le basculement qui fait se chevaucher deux sources coûte une connexion fournisseur supplémentaire pendant la durée du chevauchement, donc le planificateur refuse chaque fois que cette connexion n’est pas démontrablement disponible. | n = 1 | 1 sept. 2026 |
| Les identifiants et les adresses sont acceptés jusqu’à 2048 caractères, donc la longueur est rarement la raison pour laquelle une connexion au fournisseur échoue. | n = 1 | 1 sept. 2026 |
| Une fois appairée, le jeton de la console se trouve dans le stockage sécurisé de la plateforme derrière la même interface que celle du desktop, l’implémentation étant choisie au démarrage. | n = 2 | 1 sept. 2026 |
| Les adresses de rattrapage sont construites par le client à partir d’une chaîne, d’une heure de début et d’une durée plutôt que lues programme par programme depuis le fournisseur, avec le même suffixe de flux de transport que le constructeur en direct. | n = 1 | 23 août 2026 |
| La profondeur à laquelle l’archive est accessible est bornée par la rétention du guide plutôt que par la fenêtre annoncée du fournisseur, parce qu’une entrée de rattrapage est matérialisée à partir d’une ligne de programme. | n = 1 | 1 sept. 2026 |
| La possibilité de parcourir un flux en direct est la conjonction d’un indicateur seekable et d’une longueur positive, et le transport n’entre pas dans cette décision. | n = 1 | 23 août 2026 |
| L’enregistrement copie les flux dans un fichier sans décoder ni ré-encoder, ce qui explique qu’il coûte peu et ne puisse pas faire mieux que la source. | n = 1 | 1 sept. 2026 |
| Le rattrapage a d’abord été livré sur la tête desktop. La page console correspondante est encore listée comme travail en attente, donc l’archive d’un fournisseur est accessible sur Windows avant de l’être sur Xbox. | n = 1 | 31 août 2026 |
| Avant qu’une source de fournisseur se synchronise, le client lit la réponse de connexion du fournisseur et nomme le refus : un compte marqué expiré, désactivé ou banni, une date d’expiration déjà passée et des identifiants refusés sont chacun un type d’échec distinct plutôt qu’une erreur réseau générique. | n = 5 | 9 oct. 2026 |