Notes complémentaires

À PROPOS:
Pour en savoir plus sur les particularités du player

Mise en contexte

Lorsque nous utilisons le player que nous venons de créer, nous faison appel, dans l’ordre, aux éléments suivants:

Donc: le résultat obtenu est dépendant uniquement de l’addon vStream et la façon dont ce dernier est conçu.

Il y a un ”BUG” inévitable qui sera rencontré lorsque vous utiliserez un player TMDb-Helper avec la source Pastebin de vStream.

Voici la situation impossible a gérer:

Situation problématique

📌Un événement preçu par certains comme étant une recherche en double sera constaté dans la situation suivante:

• Lorsque dans Pastebin, une série a été ”Tagué” manuellement par un contributeur pour indiquer la résolution.

Ce ”doublon” de recherche que nous pouvons rencontrer se produit lorsque:

1. Nous appuyons sur un épisode depuis l’addon TMDb-Heper
2. Le player par défaut trouve la SÉRIE dans la source Pastebin
3. Le player par défaut trouve ensuite la SAISON qui est en lien avec l’épisode demandé
4. Le player par défaut entre dans le premier dossier saison qu’il trouve
5. Le premier dossier (la saison) ne contient pas l’épisode demandé à la base
6. Un signal est donné à TMDb-Helper qui utilise alors son repli, soit le player ”Fallback” que nous avons configuré plus haut.
7. Le player de secours effectue une recherche générale au niveau de la série depuis l’addon vStream
8. Une fois la série trouvée dans vstream: son rôle est fini. L’utilisateur doit prendre la relève pour se rendre à l’épisode voulu, tout comme il l’a fait au début, en appuyant sur cette même série depuis l’addon TMDb-Helper.

L’étape 6, soit l’appel automatique au player de secours, nous permet de refaire tout le processus depuis le début, en nous pésentant le dossier ”Série” mais cette fois, à l’intérieur de l’addon vStream: Ceci est exactement son rôle.

• Cela évite de terminer la requête sur ”aucun résultat” avec notre player par défaut en nous offrant une 2e option lorsque rien n’a été trouvé.

Ainsi, lorsque l’appel au player de secours est requis, un effet ”doublon” de recherche est perçu par certains…

Exemple

Bon, tout ce qui a été expliqué ci-haut peut sembler compliqué alors voici un exemple concret:

Disons que depuis l’addon TMDb-Helper, je désire visionner l’épisode 1 de la saison 1.

• J’effectue alors une recherche pour la série ”She Hulk”:

• J’obtiens donc le résultat de ma recherche et TMDb-Helper me présente la pochette de la série ”She Hulk”:

Ici, je suis toujours à l’intérieur de l’addon TMDb-Helper.

J’entre dans le dossier de la série pour retrouver la saison (ou la liste de saisons si lieu, pour d’autres séries qui en contiennent plusieurs).

• Et je clique sur ”Saison 1”:

Ici aussi, je suis toujours à l’intérieur de l’addon TMDb-Helper

À l’intérieur du dossier de la saison 1, je retrouve la liste des épisodes qui la compose.

• Je clique sur l”épisode 1:

Tout ce qui a été exécuté jusqu’ici, sont des actions effectuée depuis l’addon TMDb-Helper.

📌Et souvenez-vous: TMDb-Helper n’est pas un addon de streaming mais un addon de métadonnées.

• Il présente seulement les informations du média recherché
• C’est grâce au player que nous avons réglé dans ce tuto que nous pouvons accéder a des liens pour visionner ce contenu.

Explications

Dès le moment ou nous cliquons sur l’épisode recherché à l’intérieur de l’addon TMDb-Helper, l’action posée fait appel au player que nous avons configuré plus haut dans ce tuto.

Nous n’avons donc plus recours à l’addon TMDb-Helper mais plutôt a celui utilisé pour créer le player.

• Dans notre cas: l’addon vStream.

La logique

Nous l’avons vu précédemment, toute recherche est effectuée sur le site themoviedb.org et doit donc respecter la logique de ce site.

Alors logiquement, le player s’attends à passer par le chemin suivant (à l’intérieur de la source Pastebin), afin de pointer les liens qui vont démarrer l’épisode 1 – de la saison 1 – de la série ”She Hulk”:

• 1 dossier série
• 1 dossier saison
• 1 liste d’épisodes

Lorsqu’il aura atteint la liste d’épisodes, il doit nous offrir celle que nous avons demandé: Soit S01E01.

Toute cette étape est fait à l’intérieur de l’addon vStream. Ceci débute dès l’instant ou vous avez cliqué sur un épisode depuis TMDb-Helper. Cela est très rapide et s’exécute pendant que vous attendez le résultat de la requête.

Ce qui arrive dans les faits

La source Pastebin en est une particulière et n’a donc pas le même fonctionnement que les autres sources de vStream.

Celle-ci est basée sur les contributions de divers contributeurs et c’est grâce à ce fait qu’elle existe et peut offrir un contenu aussi riche et apprécié.❤️

• Or, la résolution n’apparaît pas automatiquement, par défaut, pour les séries télé. (seulement pour les films)
• Le contributeur doit inscrire manuellement la résolution afin que l’utilisateur puisse choisir le lien qui lui convient, selon la résolution souhaitée.
• Si le contributeur n’inscrit pas manuellement la résolution, celle-ci ne sera pas visible. (C’est pourquoi certaines séries ne l’affiche pas)

📌De par ce fait, un résultat qui ne respecte pas la logique attendue se produit…

Lorsque le player effectue son parcours pour trouver l’épisode recherché, le chemin suivant est parcouru à l’intérieur de la source Pastebin de vStream:

• 1 dossier série
• plusieurs dossiers de la même saison
• 1 liste d’épisodes trouvé à l’intérieur du premier dossier saison trouvé par le player.

Effectivement, lorsque les résolutions sont inscrites pour une séries, elles sont indiquées au niveau du dossier de la saison et non au niveau du lien.

• Ceci présente donc des doublons pour chaque saison ayant l’aspect suivant dans la source Pastebin:

Selon la logique attendu, 1 seul dossier pour la saison 1 devrait être présent. Pas 3…

Alors il est normal que notre player entre à l’intérieur du premier dossier rencontré car logiquement, aucun autre dossier n’est supposé exister pour une saison donnée.

• Voici ce qui est attendu, tel que présenté un peu plus haut, lorsque la recherche a été fait depuis l’addon TMDb-Helper:

Bug rencontré

• Premièrement, il faut bien comprendre que:
• La fonction première d’un player est d’exécuter l’action ”PLAY” non pas ”Rechercher”.
• L’action ”PLAY” ne peut être appliquée que sur un lien.
• Pour être en mesure d’arriver à l’action ”PLAY”, il faut donc entrer à l’intérieur d’un dossier afin de trouver des liens.

Les points ci-haut représentent donc le processus effectué par notre player par défaut afin d’en arriver a son but ultime: Pointer un / des lien(s) permettant l’action ”PLAY”.

• Notre player par défaut a été conçu pour être précis. Il fait donc tout ce qu’il peut afin de mener directement à l’action ”PLAY”.

Par contre, notre player ”Fallback”, celui qui prend la relève si notre player par défaut n’a rien trouvé, utilise seulement la fonction ”Rechercher”.

• Et c’est normal!

Puisque ”Play” n’a rien trouvé, ”Rechercher” sera utilisé. Cette recherche est alors plus efficace car elle offre plus de chances d’obtenir un résultat. Mais elle sera moins précise puisqu’elle se posera uniquement sur le dossier de la série. Ceci dans le but de vous permettre d’explorer d’autres dossiers de cette saison. Ainsi, vous avez une 2e chance pour trouver un lien qui pourra démarrer l’épisode demandé.

Pour illustrer le bug, revenons-en a notre exemple pour la série ”She Hulk”.

• Le player par défaut est entré dans le dossier portant le nom de la série
• Il est ensuite entré dans le premier dossier de saison qu’il a rencontré.

Si

le premier dossier rencontré par notre player par défaut

en est un qui ne possède pas de tag manuel indiquant la résolution:

• Tout va bien👍

Car à l’intérieur de ce doissier nommé sans tag, nous pouvons retrouver tous les liens avec toutes les résolutions disponibles.

• MAIS:

Si le premier dossier de saison que notre player par défaut rencontre est:

• Saion 1 avec le tag (1080p):

• Et qu’à l’intérieur de ce dossier, l’épisode 1 est MANQUANT:

L’épisode 1 est probablement présent dans les autres dossiers de cette même saison. Mais il ne figure pas dans le premier dossier dans lequel le player est entré. Il n’y a pas de lien S01E01 ”tagué” avec la résolution 1080p.

• Notre player par défaut ne peut pas accomplir sa fonction qui est d’exécuter l’action ”PLAY”.

📌C’est à ce moment que l’effet perçu comme un ”double” de recherche est observé

Puisque nous avons réglé un ”Fallback” qui doit s’exécuter lorsqu’aucun résultat n’a été trouvé par notre player par défaut, TMDb-Helper fera donc appel à cette solution de repli afin de nous permettre d’effectuer une recherche supplémentaire. Nous avons donc droit à un 2e tour👍

• Le ”Fallback” (ou player de secours) est la solution de repli utilisée lorsqu’un lien n’a pas été trouvé pour exécuter l’action ”PLAY”

Au lieu de vous ramener dans l’addon TMDb-Helper, on vous laisse à l’intérieur de l’addon vStream pour effectuer cette étape.

Normal: puisque notre Fallback est le fichier ”vStream.json” que nous avons installé au début de ce tuto.

Puisque ce player de secours fait appel à la recherche globale de vStream, tout le processus est repris à la base, et effectue une recherche globalement, parmis toutes les sources actives à l’intérieur de l’addon vStream. Et parmis ces sources actives figure aussi la source Pastebin!

Ce player reçoit la directive suivante: ”Effectue une recherche de la série She Hulk parmis toutes les sources actives de vStream”. Mais il n’a aucune idée de quelles sont les sources que vous avez activées.

• Vous aurez l’impression de devoir effectuer une 2e fois la recherche.
• Vous retrouverez sans doute l’épisode voulu à l’intérieur de la source Pastebin mais dans un dossier différent de celui qui a été ouvert la première fois, avec le player par défaut.

En résumé, le player ”Fallback” (vstream.json) fait appel à la recherche globale de l’addon vStream.

📌NOTEZ BIEN Ce phénomène perçu comme étant une double recherche sera observé chaque fois que notre player par défaut ne pourra pas accomplir sa tâche ou qu’il n’obtiendra aucun résultat.

La recherche globale de vStream est un clone de la recherche TMDb-Helper. L’action est simplement effectuée depuis vStream au lieu de l’être depuis TMDb-Helper.

• Cette recherche de 2e chance ne tente pas de trouver un épisode précis mais plutôt le titre de la série dans laquelle figure l’épisode demandée.

Alors voilà:

Tout ceci se produit en quelques secondes, de façon automatique, pendant que vous attendez le résultat du premier ”clic” fait sur S01E01 depuis TMDb-Helper. Et ce, malgré tout le temps et tous les mots que j’ai utilisé pour vous l’expliquer😝

Vous avez donc l’impression que vous effectuez 2 fois la même chose mais ce n’est pas le cas. Dans les faits, le player a effectué exactement ce que nous lui avons demandé:

1. 1.Il a d’abord utilisé le player par défaut mais n’a trouvé aucun résultat.
2. 2.Il a ensuite utilisé la solution de repli en invoquant le player de secours (vStream.json) qui a fait son travail.
3. 3.Vous avez obtenu une deuxième chance de trouver votre épisode de façon manuelle directement depuis vStream même si à la base, vous étiez à l’intérieur de l’addon TMDb-Helper.

Conclusion

Tel que mentionné sur le message d’avertissement en début de tuto, bien que nous avons utilisé la source Pastebin de vStream comme exemple, cet outil peut aussi créer d’autres players avec des addons différents.

Par contre, la méthode et les options peuvent être différents d’un addon à l’autre. Vaut mieux s’informer auprès du développeur de l’addon que vous utilisez si vous éprouver des difficultés à le faire fonctionner. Habituellement, vous pourrez retrouver de l’information sur le Github officiel de l’addon dont il est question.

Amusez-vous bien👍

---