Consejos para desarrolladores de Kodi: cómo crear e implementar una clave de API de Trakt para su complemento
Kodi ha mantenido durante mucho tiempo la posición de ser una de las mejores aplicaciones de centro de medios de código abierto. La facilidad con la que cualquiera puede crear extensiones para el software también lo hace aún más atractivo. Los desarrolladores de complementos de Kodi pueden pasar de la idea al prototipo comprobable en una sola tarde, incluso si tienen poca experiencia con la codificación o el desarrollo de aplicaciones.
Los servicios como Trakt brindan a los desarrolladores de complementos acceso instantáneo a una base de datos masiva de información sobre programas de televisión y películas . No solo puede usarlos para obtener títulos de programas e información de episodios, sino que Trakt ofrece una opción para obtener datos del usuario junto con ellos, lo que significa que puede agregar una sección «popular» o «calificada por el usuario» a su extensión en un instante. Lo mejor de todo es que lo único que debe hacer para comenzar con Trakt es enganchar una clave API y pegarla en su proyecto. Lo guiaremos a través de todo el proceso a continuación, con enlaces y ejemplos.
Manténgase privado y seguro con una VPN
El entorno de software de Kodi es completamente seguro y legal de usar. Sin embargo, algunos de los complementos que puede instalar no están sujetos a esas mismas reglas, lo que ha provocado un mayor escrutinio en los últimos años. Los creadores de contenido han cerrado ciertos complementos y se sabe que los ISP controlan a los usuarios de Kodi al azar. Incluso si su complemento es completamente legítimo, en el momento en que inicie Kodi, podría estar en riesgo.
La mejor manera de protegerse de este tipo de peligros es utilizar una red privada virtual confiable. Las VPN cifran los datos antes de que salgan de su dispositivo, lo que dificulta o imposibilita que cualquiera pueda ver qué sitios está visitando o qué transmisiones de Kodi descarga. Las VPN también ocultan su identidad y ubicación, restaurando tanto la privacidad como el anonimato de su experiencia en línea, y ayudando a romper las barreras de los ISP y la censura.
La mejor VPN para Kodi – IPVanish
IPVanish tiene todas las características adecuadas para que sea una de las mejores VPN para usar con Kodi. Es un servicio increíblemente rápido, para empezar, que ofrece más de 950 servidores en 60 países diferentes para conexiones rápidas y de bajo retraso en todo el mundo. También obtiene una increíble cantidad de seguridad con un sólido cifrado AES de 256 bits, protección contra fugas de DNS y un interruptor de apagado automático para todos los dispositivos. Combine eso con una política de registro cero en todo el tráfico y absolutamente ninguna restricción en las descargas de torrents o contenido P2P y obtendrá la receta perfecta para una VPN confiable y privada para todas sus necesidades en línea, ¡incluidas las transmisiones de Kodi!
IPVanish ofrece una garantía de devolución de dinero de 7 días, lo que significa que tiene una semana para probarlo sin riesgos. Tenga en cuenta que los lectores de Addictive Tips pueden ahorrar un enorme 60% aquí en el plan anual de IPVanish , lo que reduce el precio mensual a solo $ 4.87 / mes.
Antes de empezar
Trakt es un servicio increíblemente útil tanto para desarrolladores de Kodi como para streamers ocasionales. Docenas de complementos hacen uso de los datos que proporciona, y configurar las cosas para su propia versión es más fácil de lo que podría esperar. Sin embargo, antes de comenzar, eche un vistazo a la siguiente información para saber exactamente en qué se está metiendo.
¿Qué hace Trakt?
Trakt.tv tiene una misión simple: recopilar mucha información interesante sobre los programas de televisión y las películas que ve la gente. Comienza con cosas simples como nombres de programas, tiempos de ejecución y detalles de género. Además de eso, están los números relacionados con las calificaciones, la popularidad entre los usuarios, las puntuaciones de IMDB y mucho más. La mayoría de los desarrolladores de complementos no utilizan todos los contenidos proporcionados por Trakt . Sin embargo, si lo hace, proporcionará una gran cantidad de datos excelentes para que su lanzamiento sea más útil que nunca.
Algunas de las estadísticas y los raspados de metadatos de Trakt incluyen lo siguiente:
- Imágenes de presentación y arte de caja, tanto oficiales como hechas por fans.
- Datos sobre actores, directores, escritores, productores, etc.
- Nombres de episodios, números e información de género.
- Metadatos traducidos a varios idiomas.
- El título completo del programa y la fecha de emisión original.
- Calificaciones de usuarios y calificaciones de críticas.
¿Qué son las claves API?
API significa interfaz de programación de aplicaciones, y las claves son simples cadenas de números y letras que se utilizan para identificar una aplicación que intenta acceder a un servicio. Si estuviera creando un complemento para Facebook, por ejemplo, es posible que necesite claves API para ayudar a identificar el complemento con el sitio externo; de lo contrario, nunca se transmitirán datos.
¿Es Trakt seguro y legal?
Tanto legal como seguro, sí. Trakt no proporciona ningún contenido, solo metadatos. Puede usarlo para obtener nombres de programas e información de episodios, pero nunca los videos en sí. Una cosa que vale la pena señalar es que Trakt realiza un seguimiento de sus hábitos de visualización de videos (de ahí el nombre). La información se envía a la base de datos del servicio de forma anónima y solo se utiliza para aumentar la cantidad de información que Trakt puede ofrecer. Su privacidad no está realmente en riesgo, ni tampoco la privacidad de los usuarios de su complemento.
Cómo crear una clave de API de Trakt.tv
El servicio Trakt.tv es una herramienta increíblemente útil para los desarrolladores de Kodi. Usarlo le brinda acceso instantáneo a una enorme base de datos de información, suficiente para convertir su complemento en una pieza de software realmente útil. La creación y adición de la clave API también es un proceso sorprendentemente simple. ¡Siga la guía a continuación y estará implementando en poco tiempo!
Paso 1 – Regístrese en Trakt.tv
Antes de que pueda registrarse en el sitio de la API de Trakt, deberá crear una cuenta en Trakt.tv . Registrarse solo toma unos segundos y es completamente gratis. Asegúrese de utilizar los detalles de la cuenta asociados con el nombre de su desarrollador de Kodi o el título del complemento, para mantener la coherencia.
Paso 2: uso de la página de la API
Con los detalles de la cuenta en la mano, vaya a la página de la aplicación API de Trakt.tv e inicie sesión. Desde aquí se le pedirá que complete información básica sobre su complemento, desde el nombre hasta una breve descripción y la URL del sitio. Puede dejar el icono en blanco por ahora, pero todo lo demás debe solucionarse. Una vez que haya terminado, desplácese hacia abajo y haga clic en «guardar aplicación».
Paso 3: guarde sus datos
Una vez que se haya registrado y haya creado la página de su aplicación, Trakt lo dirigirá a una página de métodos de API con algunos datos clave. El que más le preocupará es el ID de cliente y el secreto del cliente, dos cadenas de números y letras que sirven como claves de API. Copie y guarde cada uno en un lugar seguro, deberá ingresar ambas claves en su aplicación.
Cómo utilizar la clave de API de Trakt en su complemento de Kodi
Una vez que haya generado y guardado su clave API, es hora de ponerla en funcionamiento. Este proceso variará según sus preferencias de desarrollo. A continuación, describimos uno de los métodos más fáciles y comunes para crear complementos de Kodi, la plantilla Jen. Siga las instrucciones para personalizar e insertar su clave API y su código estará listo y funcionando en poco tiempo.
Paso 1: obtenga la plantilla de Jen
Visite la página de Jen Template en github, el hogar oficial del desarrollo continuo del proyecto. Haga clic en el botón verde en la parte superior derecha que dice «clonar o descargar», luego descargue el archivo zip. Extraerlo en su propia carpeta, preferiblemente en su escritorio, luego prepárese para sumergirse.
Paso 2: editar Addon.xml
Mire dentro de la carpeta que acaba de crear titulada plugin.video.jen-master. En el nivel superior verá un archivo llamado addon.xml. Abra este archivo con su editor de código favorito (o bloc de notas, en caso de necesidad). En la parte superior, verá una línea similar al texto de abajo. Deberá realizar algunas modificaciones en esta línea. Solo cambie el texto en mayúsculas y los signos #, y asegúrese de evitar el uso de espacios y caracteres no estándar.
<addon id = ”plugin.video.YOUR ADDON AQUÍ” name = ”YOUR ADDON’S NAME” version = ”#. #. #” provider-name = ”NOMBRE DEL DESARROLLADOR”>
Cuando esté completa, la línea debería verse así, con sus datos en lugar de los nuestros, por supuesto:
<addon id = ”plugin.video.addictivetips” name = ”AddictiveTips” version = ”1.4 ″ provider-name =” addictivetipscreator ”>
Ahora desplácese hacia abajo un poco y busque las líneas 19 y 21. Marcan el resumen de complementos y la descripción larga. Reemplace el texto en mayúsculas a continuación con texto relacionado con su propio proyecto.
<summary lang = ”en”> AGREGAR RESUMEN </summary>
<description lang = ”en”> DESCRIPCIÓN LARGA PARA AGREGAR </description>
Puede haber líneas adicionales en esta sección que se refieran a otros idiomas. Puede eliminarlos o dejarlos en blanco por ahora, están destinados a traducciones y no son necesarios por el momento.
Guarde el archivo addon.xml, ya ha terminado de editarlo.
Paso 3: editar Default.py
Ahora es el momento de insertar la clave API real. Busque el archivo llamado default.py en el mismo directorio que el archivo addon.xml anterior. Ábralo en su editor de código, luego desplácese hacia abajo hasta las líneas 27 y 28. Deberían verse así:
__builtin __. trakt_client_id = “” # id de cliente de trakt
__builtin __. trakt_client_secret = “” # secreto de cliente de trakt
Inserte el código apropiado copiado del sitio web de Trakt entre las comillas. Por ejemplo:
__builtin __. trakt_client_id = “123456789012345678901234567890” # id de cliente de trakt
Ambas líneas deberían tener las claves correctas en su lugar ahora. Guarde sus cambios y salga del archivo.
Paso 4: editar Settings.xml
Ahora es el momento de terminar de personalizar la plantilla para que refleje el diseño de su complemento. Dentro de la carpeta jen-master verá otra carpeta con la etiqueta «recursos». Entra y busca el archivo settings.xml. Ábralo en su editor, luego desplácese hacia abajo hasta la línea 27. Debería ver la siguiente línea repetida varias veces en esta sección:
action = ”RunPlugin (plugin: //plugin.video.jen/? mode = ScraperSettings)” />
La parte que dice plugin.video.jen es donde nos enfocamos. Cambie el texto para reflejar el mismo nombre que agregó a addon.xml. Por ejemplo, el nuestro podría verse así:
action = ”RunPlugin (complemento: //plugin.video.addictivetips/? mode = ScraperSettings)” />
Realice los mismos cambios en las líneas 27, 31 y 36, luego guarde el archivo y salga.
Paso 5: cambie el nombre de la carpeta
¡Ya casi has terminado! Con la clave API de Trakt insertada y las otras personalizaciones necesarias realizadas, todo lo que necesita hacer es cambiar el nombre de la carpeta y estará listo para probar las cosas. Guarde y salga de todos los archivos que estaba editando, luego vuelva a la carpeta original que creó llamada «plugin.video.jen-master». Cambie este nombre para reflejar el que ingresó en addon.xml, seguido del número de versión. Usando nuestro ejemplo anterior, el archivo ahora se llamaría:
plugin.video.addictivetips.1.4.zip
¡Y ahora estás listo para empezar! Intente instalar su complemento en Kodi y debería funcionar bien.
Más personalizaciones de complementos
Jen Template es un marco fantástico para casi cualquier complemento de Kodi. Conectar la clave API de Trakt es solo uno de los muchos pasos que puede seguir para darle vida a su creación. A continuación, se muestran algunas sugerencias más a seguir para ayudar a calificar su complemento y hacerlo suyo.
Utilice un icono personalizado
Al navegar por Kodi, es posible que observe un icono que aparece en la parte superior izquierda de la pantalla. Esto aparece cada vez que resalta un complemento y es fácil de incluir con su plantilla Jen. Simplemente cree un archivo PNG de 256 × 256, preferiblemente uno sin texto o marca Kodi, luego cópielo en el nivel superior de su carpeta. ¡Nómbralo icon.png y listo!
Incluir un banner de fan art
Similar al ícono de arriba, el fan art es un fondo de estilo splash que aparece detrás del texto de selección en Kodi. Puede estar relacionado con la marca de su complemento, pero la mayoría de los creadores prefieren lanzar banners relacionados con el contenido que ofrecen sus complementos. Si se está enfocando en películas HD, por ejemplo, puede elegir una película popular y crear algunas ilustraciones basadas en ese tema. Para agregar pancartas de fan art, simplemente cree una imagen JPG de 1280 × 720, asígnele el nombre fanart.jpg y péguela en la carpeta de nivel superior de su complemento.
Agregar traducciones
El inglés es prácticamente el predeterminado para la mayor parte del contenido de Kodi, ya que es el idioma más utilizado en la web. Sin embargo, casi todo en la comunidad de Kodi está diseñado teniendo en cuenta las traducciones. Es una buena idea agregar al menos algunas opciones básicas de idioma en su proyecto. Los usuarios de Kodi están ansiosos por contribuir con traducciones de términos y descripciones básicos.
Jen Template facilita la adición de diferentes idiomas. Todo lo que tiene que hacer es tomar el texto traducido y pegarlo en su archivo addon.xml usando el mismo proceso descrito anteriormente. Verá secciones marcadas con frases «lang = he», «lang = fr» o «lang = de», todas las cuales apuntan a los idiomas que los usuarios pueden seleccionar al iniciar Kodi.
Conclusión
Trakt es una herramienta increíblemente útil tanto para los desarrolladores de complementos de Kodi como para los fanáticos de la televisión. Usarlo significa acceso instantáneo a una gran cantidad de información, mucho más que la mayoría de los otros servicios de bases de datos de TV. También significa que estás contribuyendo al proyecto, lo que lo hace mejor para todos. Agregar una API de Trakt a su proyecto también es un proceso rápido y sencillo, sin registros complicados o segmentos de código que manejar. ¿Tuviste una buena experiencia usando Trakt.tv en el pasado? ¡Comparte tus comentarios a continuación!