Conseils pour les développeurs Kodi: Comment créer et implémenter une clé API Trakt pour votre module complémentaire

Kodi a longtemps tenu la position d'être l'un desles meilleures applications de centre des médias open-source autour. La facilité avec laquelle tout le monde peut créer des extensions pour le logiciel le rend encore plus attrayant. Les développeurs de modules complémentaires Kodi peuvent passer de l’idée au prototype testable en un seul après-midi, même s’ils n’ont que peu d’expérience en matière de codage ou de développement d’applications.

Des services comme Trakt offrent aux développeurs des modules complémentairesaccès instantané à une base de données massive d'informations sur les émissions de télévision et les films. Non seulement vous pouvez les utiliser pour extraire des titres d’émission et des informations sur les épisodes, mais Trakt offre une option permettant de récupérer des données d’utilisateur, ce qui signifie que vous pouvez ajouter une section «populaire» ou «évaluée par l’utilisateur» à votre extension en un instant. Mieux encore, la seule chose à faire pour commencer à utiliser Trakt consiste à accrocher une clé d'API et à la coller dans votre projet. Nous vous guiderons tout au long du processus ci-dessous, avec des liens et des exemples.

Restez privé et sécurisé avec un VPN

L’environnement logiciel Kodi est totalement sécuriséet légal à utiliser. Certains des compléments que vous pouvez installer ne sont pas liés par ces mêmes règles, ce qui a entraîné une surveillance accrue au cours des dernières années. Les créateurs de contenu ont désactivé certains modules complémentaires et les fournisseurs de services Internet sont connus pour limiter les utilisateurs Kodi de manière aléatoire. Même si votre extension est tout à fait légitime, dès que vous lancez Kodi, vous courez un risque.

Le meilleur moyen de vous protéger de ces typesdes dangers est d'utiliser un réseau privé virtuel fiable. Les VPN chiffrent les données avant qu’elles ne quittent votre appareil, ce qui rend difficile ou impossible pour quiconque de voir quels sites vous visitez ou quels flux Kodi vous téléchargez. Les VPN masquent également votre identité et votre emplacement, rétablissant la confidentialité et l'anonymat de votre expérience en ligne, et aidant à surmonter les barrières de censure et de restriction des FAI.

Le meilleur VPN pour Kodi - IPVanish

IPVanish a toutes les bonnes caractéristiques pour en faire l’un desmeilleurs VPN à utiliser avec Kodi. Pour commencer, il s’agit d’un service incroyablement rapide, offrant plus de 950 serveurs dans 60 pays différents pour des connexions rapides et à faible délai dans le monde entier. Vous bénéficiez également d'une sécurité incroyable avec un cryptage AES 256 bits robuste, une protection contre les fuites DNS et un commutateur d'arrêt automatique pour tous les périphériques. Combinez cela avec une politique de journalisation zéro sur tout le trafic et aucune restriction sur les téléchargements torrent ou le contenu P2P et vous obtenez la recette parfaite pour un VPN fiable et privé pour tous vos besoins en ligne, y compris les flux Kodi!

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

Avant de commencer

Trakt est un service extrêmement utile pour les deuxDéveloppeurs Kodi et streamers occasionnels. Des dizaines d’add-ons utilisent les données qu’il fournit, et il est plus facile d’organiser les choses pour votre propre version que vous ne le pensiez. Avant de vous lancer, toutefois, examinez les informations ci-dessous afin de savoir exactement dans quoi vous vous engagez.

Que fait Trakt?

Trakt.La télévision a une mission simple: collecter de nombreuses informations intéressantes sur les émissions de télévision et les films que les gens regardent. Cela commence par des éléments simples tels que les noms de séries, les runtimes et les détails de genre. En plus de cela, il y a des chiffres relatifs aux notes, à la popularité parmi les utilisateurs, aux scores de la BDIM, et bien plus encore. La plupart des développeurs d’extensions n’utilisent pas tous les éléments de contenu fournis par Trakt. Si vous le faites cependant, vous fournirez de nombreuses données utiles pour rendre votre publication plus utile que jamais.

Certaines statistiques et métadonnées fournies par Trakt comprennent:

• Box art et images splash, faites par des fans et officielles.
• Données sur les acteurs, réalisateurs, scénaristes, producteurs, etc.
• Noms d'épisodes, numéros et informations sur le genre.
• Métadonnées traduites en plusieurs langues.
• Le titre complet et la date originale de l’émission.
• Notes d'utilisateurs et notes critiques.

Que sont les clés API?

API signifie interface de programmation d'application,et les clés sont de simples chaînes de chiffres et de lettres utilisées pour identifier une application tentant d'accéder à un service. Si vous construisez un add-on pour Facebook, par exemple, vous aurez peut-être besoin de clés d'API pour vous aider à identifier l'add-on avec le site externe, sinon aucune donnée ne serait transmise.

Trakt est-il sûr et légal?

Légal et sûr, oui. Trakt ne fournit aucun contenu, juste des métadonnées. Vous pouvez l’utiliser pour obtenir des noms d’émission et des informations sur les épisodes, mais jamais les vidéos elles-mêmes. Une chose à noter est que Trakt garde une trace de vos habitudes de visionnage de vidéos (d'où son nom). Les informations sont soumises anonymement à la base de données du service et ne sont utilisées que pour augmenter la quantité d’informations que Trakt peut offrir. Votre vie privée n’est pas vraiment menacée, pas plus que la vie privée des utilisateurs de votre add-on.

Comment créer une clé API Trakt.tv

Le Trakt.Le service tv est un outil extrêmement utile pour les développeurs Kodi. Son utilisation vous donne un accès instantané à une base de données volumineuse, suffisante pour transformer votre extension en un logiciel réellement utile. La création et l'ajout de la clé API est également un processus étonnamment simple. Suivez le guide ci-dessous et vous déploierez en un rien de temps!

Étape 1 - Inscrivez-vous sur Trakt.tv

Avant même de pouvoir vous inscrire à l'API Traktsite, vous devez créer un compte avec Trakt.tv. L'inscription ne prend que quelques secondes et est totalement gratuite. Veillez à utiliser les détails du compte associés au nom de votre développeur Kodi ou au titre du complément, par souci de cohérence.

Étape 2 - Utilisation de la page API

Avec les détails du compte en main, allez à Trakt.API de tv et connectez-vous. À partir de là, vous serez invité à fournir des informations de base sur votre module complémentaire, du nom à la description, en passant par l’URL du site. Vous pouvez laisser l'icône vide pour l'instant, mais tout le reste doit être pris en charge. Une fois que vous avez terminé, faites défiler la liste et cliquez sur «Enregistrer l’application».

Étape 3 - Sauvegardez vos détails

Une fois que vous avez signé et créé votre applicationpage, Trakt vous dirigera vers une page de méthodes API avec quelques informations essentielles. Celui qui vous intéresse le plus est l’ID client et le secret client, deux chaînes de chiffres et de lettres qui servent de clés d’API. Copiez et enregistrez chacune d’elles dans un endroit sûr, vous devrez saisir les deux clés dans votre application.

Comment utiliser la clé API Trakt dans votre complément Kodi

Une fois que vous avez généré et enregistré votre clé d’API,il est temps de le mettre au travail. Ce processus varie en fonction de vos préférences de développement. Nous décrivons ci-dessous l’une des méthodes les plus simples et les plus courantes pour créer des add-ons Kodi, le modèle Jen. Suivez les instructions pour personnaliser et insérer votre clé d’API et votre code sera opérationnel en un rien de temps.

Étape 1 - Obtenez le modèle Jen

Visitez la page de modèles de Jen sur github, leofficiel du développement en cours du projet. Cliquez sur le bouton vert en haut à droite indiquant «cloner ou télécharger», puis téléchargez le fichier zip. Extrayez-le dans son propre dossier, de préférence sur votre bureau, puis préparez-vous à plonger.

Étape 2 - Modifier Addon.xml

Regardez dans le dossier que vous venez de créer intituléplugin.video.jen-master. Au niveau supérieur, vous verrez un fichier nommé addon.xml. Ouvrez ce fichier en utilisant votre éditeur de code préféré (ou votre bloc-notes). En haut, vous verrez une ligne qui ressemble au texte ci-dessous. Vous devrez apporter quelques modifications à cette ligne. Modifiez uniquement le texte en majuscule et les signes # et veillez à ne pas utiliser d'espaces ni de caractères non standard.

Une fois terminée, la ligne devrait ressembler à ceci, avec vos coordonnées à la place des nôtres, bien sûr:

Maintenant, descendez un peu et cherchez les lignes 19 et 21. Elles marquent le résumé et la description longue des add-ons. Remplacez le texte en majuscules ci-dessous par un texte relatif à votre propre projet.

Il peut y avoir des lignes supplémentaires dans cette section faisant référence à d'autres langues. Vous pouvez les supprimer ou les laisser vides pour l’instant, elles sont destinées aux traductions et ne sont pas nécessaires pour le moment.

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

Étape 3 - Modifier Default.py

Il est maintenant temps d’insérer la clé API actuelle. Recherchez le fichier nommé default.py dans le même répertoire que le fichier addon.xml ci-dessus. Ouvrez-le dans votre éditeur de code, puis faites défiler jusqu'aux lignes 27 et 28. Ils devraient ressembler à ceci:

Insérez le code approprié copié à partir du site Web Trakt entre les guillemets. Par exemple:

Les deux lignes devraient avoir les bonnes clés en place maintenant. Enregistrez vos modifications et quittez le fichier.

Étape 4 - Modifier le fichier Settings.xml

Il est maintenant temps de finir de personnaliser le modèleil reflète donc le design de votre add-on. Dans le dossier jen-master, vous verrez un autre dossier intitulé «ressources». Allez à l'intérieur et cherchez le fichier settings.xml. Ouvrez-le dans votre éditeur, puis faites défiler l'écran jusqu'à la ligne 27. La ligne suivante devrait être répétée plusieurs fois dans cette section:

La partie qui dit plugin.video.jen est celle sur laquelle nous nous concentrons. Modifiez le texte pour refléter le même nom que vous avez ajouté à addon.xml. Par exemple, la nôtre pourrait ressembler à ceci:

Apportez les mêmes modifications aux lignes 27, 31 et 36, puis enregistrez le fichier et quittez.

Étape 5 - Renommez le dossier

Vous avez presque terminé! Une fois la clé API de Trakt insérée et les autres personnalisations nécessaires effectuées, il vous suffit de renommer le dossier et de commencer à tester. Sauvegardez et quittez tous les fichiers que vous étiez en train d’éditer, puis retournez au dossier original que vous avez créé, appelé «plugin.video.jen-master». Modifiez ce nom pour refléter celui que vous avez entré dans addon.xml, suivi du numéro de version. En utilisant notre exemple ci-dessus, le fichier serait maintenant nommé:

Et maintenant vous êtes prêt à partir! Essayez d’installer votre module complémentaire dans Kodi et cela devrait fonctionner correctement.

Plus de personnalisations complémentaires

Le modèle Jen est un cadre fantastique pourà peu près tout add-on Kodi. Connecter la clé API de Trakt n'est qu'une des nombreuses étapes à suivre pour donner vie à votre création. Vous trouverez ci-dessous quelques suggestions supplémentaires pour vous aider à personnaliser votre module et à le personnaliser.

Utiliser une icône personnalisée

En parcourant Kodi, vous remarquerez peut-être une icônequi apparaît en haut à gauche de l'écran. Cela apparaît chaque fois que vous mettez en surbrillance un add-on, et il est facile à inclure dans votre modèle Jen. Créez simplement un fichier PNG 256 × 256, de préférence un fichier sans texte ni marque Kodi, puis copiez-le au niveau supérieur de votre dossier. Name it icon.png et le tour est joué!

Inclure une bannière d'art de fan

Semblable à l’icône ci-dessus, le fan art est unArrière-plan de style éclaboussures qui apparaît derrière le texte de sélection dans Kodi. Cela peut être lié à votre stratégie de marque complémentaire, mais la plupart des créateurs préfèrent créer des bannières associées au contenu de leurs offres complémentaires. Si vous vous concentrez sur les films HD, par exemple, vous pouvez choisir un film populaire et créer des œuvres d'art basées sur ce thème. Pour ajouter des bannières d’art de fan, créez une image au format JPG 1280 × 720, nommez-la fanart.jpg, puis collez-la dans le dossier de niveau supérieur de votre module.

Ajouter des traductions

L'anglais est à peu près la langue par défaut pour la plupart desLe contenu de Kodi est la langue la plus utilisée sur le Web. Cependant, à peu près tout dans la communauté Kodi est conçu avec des traductions. C’est une bonne idée d’ajouter au moins quelques options linguistiques de base à votre projet. Les utilisateurs de Kodi sont impatients de contribuer aux traductions des termes de base et des descriptions.

Le modèle Jen facilite l'ajout de différentslangues. Tout ce que vous avez à faire est de prendre le texte traduit et de le coller dans votre fichier addon.xml en suivant la procédure décrite ci-dessus. Vous verrez des sections marquées avec les phrases “lang = he”, “lang = fr” ou “lang = de”, qui correspondent toutes à des langues que les utilisateurs peuvent sélectionner lors du lancement de Kodi.

Conclusion

Trakt est un outil incroyablement utile à la fois pour Kodiles développeurs add-on et les fans de télévision. Son utilisation signifie un accès instantané à une mine d'informations, bien plus que la plupart des autres services de bases de données télévisées. Cela signifie également que vous contribuez au projet, ce qui le rend meilleur pour tout le monde. L'ajout d'une API Trakt à votre projet est également un processus simple et rapide, sans aucune inscription compliquée ni segment de code à gérer. Avait une bonne expérience en utilisant Trakt.tv dans le passé? Partagez vos commentaires ci-dessous!