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:

  1. La fonction ”Recherche” de l’addon TMDb-Helper”
  2. Le player qui lui, fait appel a l‘addon vStream.

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👍


Est-ce que ce document a été utile ?

Dans cette catégorie

Besoin d’aide ?

Vous ne trouvez pas la réponse que vous cherchez? Ne vous inquiétez pas, nous sommes là pour vous aider!
Contacter le support