Tutoriels KODI

Comment créer et utiliser une clé API de base de données TV : conseils pour les développeurs Kodi

Par Raphael , le 17 juillet 2021 — 9 minutes de lecture
Comment créer et utiliser une clé API de base de données TV : conseils pour les développeurs Kodi

Le logiciel Kodi est gratuit et open source, ce qui signifie qu’il est possible pour n’importe qui de consulter le code ou même d’apporter des modifications au fonctionnement de base. Le vrai pouvoir derrière Kodi est sa communauté, cependant. Le logiciel a été conçu pour s’interfacer avec des modules complémentaires créés par l’utilisateur qui fournissent une grande variété de contenu, ce que l’équipe principale de Kodi ne pourrait jamais mettre en œuvre par elle-même. C’est ce qu’on appelle des modules complémentaires non officiels, et ils sont si faciles à créer que vous pouvez commencer le vôtre en un après-midi !

Un service incroyablement utile fourni aux développeurs de modules complémentaires Kodi sont les indexeurs de bases de données TV, des sites comme TheTVDB.com ou Trakt. Les deux ressources récupèrent les métadonnées du Web et fournissent les informations gratuitement au public. Cela signifie que vous pouvez créer un module complémentaire qui trouve différentes émissions de télévision et utiliser TheTVDB pour les catégoriser, les étiqueter et les trier toutes. Pas besoin de chercher des informations vous-même, et pas besoin de créer votre propre tracker. Prenez simplement une clé API dans une base de données TV et branchez-la à votre module complémentaire, puis vous êtes prêt. Notre guide ci-dessous vous guide tout au long du processus du début à la fin.

Garantie de remboursement de 30 jours

Rappel

Si vous développez un module complémentaire pour Kodi, vous êtes bien conscient de la position que le logiciel occupe aux yeux du public. Kodi lui-même est sûr, et la plupart de ses modules complémentaires le sont également. Les FAI et les créateurs de contenu pensent souvent le contraire, ce qui signifie que dès que vous diffusez quelque chose sur Kodi, votre compte peut être surveillé. Peu importe que votre module complémentaire soit légitime ou non, vous risquez toujours d’être limité ou de voir votre compte suivi.

La bonne nouvelle est que les réseaux privés virtuels sont un moyen facile de vaincre ces atteintes à la vie privée. Avec un VPN, vos données seront cryptées avant qu’elles ne quittent votre appareil, empêchant quiconque de voir les sites que vous visitez ou les flux Kodi auxquels vous accédez. Les VPN rendent également difficile la découverte de votre identité ou de votre emplacement, ramenant une mesure d’anonymat sur le World Wide Web.

Le meilleur VPN pour Kodi – IPVanish

Comment créer et utiliser une clé API de base de données TV - IPVanish

IPVanish frappe tous les bons endroits pour le VPN parfait à utiliser avec Kodi. C’est rapide, offrant plus de 950 serveurs dans 60 pays différents afin que vous puissiez toujours obtenir une connexion à faible latence, peu importe où vous vivez. Il est également sécurisé, offrant un cryptage AES 256 bits, une protection contre les fuites DNS et un kill switch automatique pour tous les appareils. Vous profiterez également d’une excellente politique de zéro journalisation sur le trafic et pourrez télécharger des torrents et du contenu réseau P2P avec un anonymat complet. Avec IPVanish, tout ce que vous avez à faire est d’exécuter l’application et votre connexion est sécurisée.

Plus de fonctionnalités IPVanish :

  • Applications faciles à utiliser pour Windows, Mac, Linux, Android et iOS.
  • Bande passante illimitée sans limitation de vitesse ni limitation.
  • Accès complet et anonyme à tous les modules complémentaires de Kodi.

IPVanish offre une garantie de remboursement de 7 jours, ce qui signifie que vous disposez d’une semaine pour le tester sans risque. Veuillez noter que Les lecteurs de Addictive Tips peuvent économiser jusqu’à 60% ici sur le plan annuel d’IPVanish, ramenant le prix mensuel à seulement 4,87 $/mois.

Avant que tu commences

Comme tout bon développeur, vous faites vos recherches avant de plonger tête la première. Lisez les sections suivantes pour dissiper les idées fausses que vous pourriez avoir, puis n’hésitez pas à saisir votre API et à commencer les tests.

API de base de données TV - Capture de site Web - 1

Qu’est-ce qu’une base de données TV ?

Si vous développez un module complémentaire Kodi, vous prévoyez probablement d’indexer une quantité importante de contenu de films ou d’émissions de télévision. Les sites qui fournissent la plupart de ces fichiers ne proposent généralement que des vidéos, et non des données d’accompagnement permettant d’identifier le contenu. Le nom du fichier contient probablement le numéro de l’émission, de la saison et de l’épisode, mais qu’en est-il des acteurs ou du titre réel de l’épisode ? C’est là qu’interviennent les bases de données d’indexation.

En branchant votre module complémentaire Kodi dans une bonne base de données, vous pouvez facilement nommer et catégoriser tout le contenu auquel votre programme accède à partir du Web. Les épisodes seront faciles à trier et à rechercher sur votre module complémentaire, et ils seront beaucoup plus faciles à regarder grâce aux métadonnées extraites du service d’indexation.

Quelles informations une base de données contient-elle ?

Cela peut varier en fonction du service que vous utilisez, mais la plupart des indexeurs se concentrent sur un ensemble de données de base comprenant les éléments suivants :

  • Le titre complet de l’émission et la date de diffusion originale.
  • Noms et numéros des épisodes.
  • Informations sur les genres.
  • Données sur les acteurs, réalisateurs, scénaristes, etc.
  • Box art, à la fois fan-made et officiel.
  • Notes des utilisateurs et notes des critiques.
  • Métadonnées traduites dans d’autres langues.

D’où vient l’information?

Une variété de sources qui peuvent vous surprendre. Parce que des informations précises sont importantes, les grattoirs de base de données vont aussi près que possible de la source. Cela signifie généralement référencer des sites officiels comme Amazon ou IMDB, qui obtiennent tous deux les titres de leurs émissions et les informations connexes des studios eux-mêmes. À défaut, d’autres indexeurs croisent leur contenu avec d’autres trackers ouverts ou s’appuient sur les données soumises par les utilisateurs pour marquer les versions des émissions.

Clés API

API signifie interface de programmation d’applications. Les clés API sont soit de petits fichiers d’autorisation, soit des chaînes de lettres et de chiffres aléatoires qui permettent à un programme d’accéder à un service spécifique. Si vous créez une application à utiliser avec Twitter, par exemple, vous avez besoin d’une clé API pour que le site Web permette à votre code de s’interfacer avec le contenu de Twitter. Les clés pour les index de base de données TV fonctionnent à peu près de la même manière. En ajoutant une clé API à votre module complémentaire Kodi, vous lui donnez les informations d’identification dont il a besoin pour extraire les données du site Web externe et les utiliser dans Kodi.

Quelle base de données utiliser

Il existe plusieurs bases de données d’indexation flottant sur le World Wide Web. Certains d’entre eux sont plus faciles à utiliser que d’autres, et certains sont simplement plus à jour que leurs concurrents. Pour notre guide ci-dessous, nous couvrirons le processus de création d’API pour TheTVDB.com, qui est une base de données ouverte pour les fans de télévision. C’est l’une des ressources les plus complètes et elle est facile à configurer et à déployer.

Les index de métadonnées sont-ils légaux ?

Ils le sont certainement. Les services d’indexation tels que la base de données TV que nous utiliserons ci-dessous n’accèdent qu’aux métadonnées entourant un élément de contenu, et non au fichier lui-même. Vous ne pouvez pas les utiliser pour diffuser quoi que ce soit, et ils ne contribuent en aucune façon au piratage. Ils sont également généralement sous licence Creative Commons pour une distribution gratuite. C’est l’équivalent numérique de l’organisation de votre collection de DVD sur une étagère. Entièrement sûr et 100% légal.

Création d’une clé API de base de données TV

Une fois que votre projet d’extension Kodi est opérationnel, vous pouvez récupérer une clé API et commencer à l’utiliser pour tester les choses.

API de base de données TV - Création de compte - 2

Étape 1 – Créez un compte

Visite TheTVDB.com et créez un compte avec le service. Utilisez votre code de codage ou même le titre du module complémentaire pour plus de cohérence. Une fois inscrit, vous devrez vous connecter, puis accepter les termes et conditions en faisant défiler vers le bas et en cochant la case en bas de la page.

Étape 2 – Générer la clé

Une fois que vous avez un compte, dirigez-vous vers le Page d’enregistrement de la clé API. En bas, vous devrez entrer le nom de votre projet ainsi que son site officiel. Cliquez sur « Récupérer la clé API » une fois que vous avez terminé.

Étape 3 – Enregistrez la clé API

TheTVDB affichera votre code clé sur une page séparée. Copiez-le dans un endroit sûr et ne le partagez avec personne d’autre, car il a été généré uniquement pour votre application. Vous aurez besoin de vous y référer plus tard, alors gardez-le à portée de main.

Utilisation d’une clé API dans votre module complémentaire Kodi

Une fois que vous avez généré une clé API avec TheTVDB ou tout autre service d’indexation de métadonnées, il est temps de la connecter à votre code complémentaire pour vous assurer qu’elle fonctionne. Ce processus peut varier en fonction de la façon dont vous avez structuré votre module complémentaire. Nous utiliserons le modèle Jen, une méthode largement utilisée pour combiner des trackers avec des modules complémentaires Kodi.

API de base de données TV - téléchargement github - 3

Étape 1 – Téléchargez le modèle Jen

Visiter le La page github de Jen Template. Cliquez sur le bouton vert en haut à droite indiquant « cloner ou télécharger », puis téléchargez le fichier zip sur votre bureau. Extrayez-le dans son propre dossier, puis préparez-vous à faire quelques modifications.

Étape 2 – Modifier Addon.xml

Juste à l’intérieur du dossier plugin.video.jen-master que vous venez de décompresser, vous trouverez un fichier appelé addon.xml. Ouvrez-le dans votre éditeur de code. Vous devrez apporter quelques modifications à certaines des lignes pour personnaliser les données auxquelles le modèle fait référence. Commencez par renseigner les informations dans la deuxième ligne du fichier, référencé ci-dessous. N’oubliez pas d’utiliser uniquement des lettres et des chiffres, pas d’espaces ni de caractères non standard, et n’oubliez pas de définir également le numéro de version.

Ensuite, éditez les lignes 19 et 21 pour donner un peu plus d’informations sur votre module complémentaire.

RÉSUMÉ DU SUPPLÉMENT

DESCRIPTION PLUS LONGUE DE L’AJOUT

Vous pouvez voir des lignes en double faisant référence à d’autres langues. Vous pouvez les laisser seuls ou les supprimer comme bon vous semble.

Enregistrez le fichier addon.xml, vous avez terminé de le modifier pour le moment.

API de base de données TV - Édition Python - 4

Étape 3 – Modifier Default.py

C’est là que nous commençons à entrer dans les informations clés de l’API. Dans le même dossier de niveau supérieur, recherchez le fichier nommé default.py. Ouvrez-le dans votre éditeur de code, puis faites défiler vers le bas jusqu’à ce que vous voyiez la ligne référencée ci-dessous. Il devrait se situer autour de la ligne 25.

__builtin__.tvdb_api_key = « COLLER LA CLÉ API ICI » # clé API tvdb

Insérez votre clé API de base de données TV à l’endroit indiqué ci-dessus. La ligne réelle aura juste deux guillemets sans rien entre les deux.

Enregistrez default.py et quittez pour le moment. Votre clé API a été saisie !

Étape 4 – Modifier Settings.xml

Un dernier fichier à éditer, puis retour aux tests. Entrez le dossier des ressources situé dans le répertoire de travail du plugin. Ouvrez settings.xml dans votre éditeur de code, puis faites défiler jusqu’à environ la ligne 27. Nous devrons saisir quelques informations ici pour terminer la configuration du modèle Jen.

Recherchez la ligne suivante dans le code du fichier. Il doit apparaître trois fois aux lignes 27, 31 et 36.

action=”RunPlugin(plugin://plugin.video.jen/?mode=ScraperSettings)”/>

Voir où il est dit plugin.video.jen? Remplacez-le par le même nom de plug-in que vous avez entré dans le fichier addon.xml. Si vous avez entré plugin.video.levonsys, par exemple, la ligne ressemblerait à ceci :

action=”RunPlugin(plugin://plugin.video.levonsys/?mode=ScraperSettings)”/>

Enregistrez ce fichier et quittez.

Étape 5 – Renommer et tester

Maintenant que l’API et les données de personnalisation ont été saisies, vous êtes prêt à conclure. Assurez-vous que tous les fichiers que vous avez modifiés sont enregistrés, puis quittez-les et revenez à votre bureau. Le dossier dans lequel nous travaillons devrait s’intituler comme ceci :

plugin.video.jen-master

Modifiez-le pour refléter le nom que vous avez entré dans le fichier addon.xml, suivi du numéro de version que vous avez entré dans la même section. En utilisant notre exemple ci-dessus, le fichier s’appellerait maintenant ceci :

plugin.video.levonsys.0.1.zip

C’est ça! Vous avez maintenant ajouté les données de l’API TVDB dans votre module complémentaire et êtes prêt à commencer à extraire les métadonnées du Web.

Autres personnalisations complémentaires

Une fois que vous avez pris en charge le modèle Jen et la clé API de votre base de données TV, pourquoi ne pas vous lancer et ajouter quelques fonctionnalités de personnalisation supplémentaires pour aider à marquer votre version ? Ce sont des étapes simples et rapides qui peuvent grandement contribuer à rendre votre module complémentaire plus reconnaissable.

Ajouter une icône

Les images d’icônes sont affichées dans Kodi sur le côté gauche de l’écran chaque fois que votre module complémentaire est mis en surbrillance. En ajouter un permet de repérer facilement votre contenu sans avoir à lire les titres, ce qui peut être plus utile que vous ne le pensez ! Pour utiliser une icône, il vous suffit de créer un fichier PNG 256 × 256, de préférence sans texte ni marque Kodi, puis de l’ajouter au niveau supérieur de votre dossier nommé icon.png. C’est ça!

Utiliser des fan-arts

Semblable à l’icône ci-dessus, le fan art est un arrière-plan de démarrage qui apparaît derrière le texte de sélection dans Kodi chaque fois que les utilisateurs mettent en évidence votre contenu. Cela peut être lié à la marque de votre icône ou à quelque chose sur le thème de votre contenu complémentaire. Par exemple, si le plugin diffuse des émissions de télévision, créez une bannière fan art originale avec des personnages de How I Met Your Mother. Pour l’ajouter à votre version, créez simplement une image JPG 1280 × 720, nommez-la fanart.jpg, puis collez-la dans le dossier de niveau supérieur de votre module complémentaire.

Conclusion

Développer un module complémentaire peut être un processus déroutant et compliqué. Cependant, la communauté fournit une tonne de ressources utiles pour vous donner un coup de main en cours de route. L’ajout d’une clé API de base de données TV n’est qu’un exemple du contenu créé par l’utilisateur qui est prêt à s’interfacer avec votre module complémentaire sans sauter à travers toutes sortes de cerceaux pour le faire fonctionner. Vous avez des conseils pour aider les développeurs Kodi en herbe ? Partagez vos connaissances dans les commentaires ci-dessous!

Raphael

Partie intégrante de l'équipe Levonsys, je suis chef de rubrique des sections Web et Kodi. Vous retrouverez au travers de mes articles, de nombreux guides sur divers outils Web, mais aussi attelant aux applications mobiles sociales.

Commentaires

Laisser un commentaire

Votre commentaire sera révisé par les administrateurs si besoin.