Cómo crear y usar una clave de API de base de datos de TV: consejos para desarrolladores de Kodi

El software Kodi es gratuito y de código abierto,lo que significa que es posible que cualquiera pueda revisar el código o incluso contribuir con cambios en el funcionamiento principal. Sin embargo, el verdadero poder detrás de Kodi es su comunidad. El software fue diseñado para interactuar con complementos creados por el usuario que proporcionan una gran variedad de contenido, cosas que el equipo central de Kodi nunca podría implementar por sí solo. Estos se llaman complementos no oficiales, y son tan fáciles de hacer que puede comenzar los suyos en una tarde.

Un servicio increíblemente útil proporcionado a KodiLos desarrolladores de complementos son indexadores de bases de datos de TV, sitios como TheTVDB.com o Trakt. Ambos recursos extraen metadatos de toda la web y proporcionan la información al público de forma gratuita. Esto significa que puede crear un complemento que encuentre diferentes programas de TV y usar TheTVDB para clasificarlos, etiquetarlos y ordenarlos. No es necesario obtener información usted mismo, y no es necesario crear su propio rastreador. Simplemente tome una clave API de una base de datos de TV y conéctela a su complemento, luego estará listo. Nuestra guía a continuación lo guía a través del proceso de principio a fin.

Oferta exclusiva: ahorre 49%. ¡Pruebe ExpressVPN sin riesgos!

Obtenga la VPN clasificada n.º 1

Garantía de devolución de dinero de 30 días.

Cómo obtener una VPN GRATIS por 30 días

Si necesita una VPN por un tiempo breve cuando viaja, por ejemplo, puede obtener nuestra VPN mejor clasificada de forma gratuita. ExpressVPN incluye una garantía de devolución de dinero de 30 días. Tendrá que pagar la suscripción, es un hecho, pero permite acceso completo durante 30 días y luego cancela para obtener un reembolso completo. Su política de cancelación sin preguntas hace honor a su nombre.

Recordatorio

Si estás desarrollando un complemento para Kodi, estásmuy consciente de la posición que el software tiene en el ojo público. Kodi en sí es seguro, y la mayoría de sus complementos también lo son. Los ISP y los creadores de contenido a menudo piensan lo contrario, lo que significa que en el momento en que transmites algo en Kodi, tu cuenta podría estar bajo escrutinio. No importa si su complemento es legítimo o no, aún corre el riesgo de ser estrangulado o rastrear su cuenta.

La buena noticia es que las redes privadas virtuales son unmanera fácil de derrotar estas invasiones de privacidad. Con una VPN, sus datos se cifrarán antes de que salgan de su dispositivo, lo que hace imposible que cualquiera pueda ver qué sitios está visitando o qué transmisiones de Kodi está accediendo. Las VPN también hacen que sea difícil descubrir su identidad o ubicación, lo que devuelve un poco de anonimato a la red mundial.

La mejor VPN para Kodi - IPVanish

IPVanish golpea todos los lugares correctos para la VPN perfecta parausar con Kodi. Es rápido, ofrece más de 950 servidores en 60 países diferentes, por lo que siempre puede obtener una conexión de baja latencia sin importar dónde viva. También es seguro, ofrece cifrado AES de 256 bits, protección contra fugas de DNS y un interruptor de apagado automático para todos los dispositivos. También aprovechará una excelente política de registro cero en el tráfico y podrá descargar torrentes y contenido de red P2P con total anonimato. Con IPVanish, todo lo que tiene que hacer es ejecutar la aplicación y su conexión es segura.

Más características de IPVanish:

• Aplicaciones fáciles de usar para Windows, Mac, Linux, Android e iOS.
• Ancho de banda ilimitado sin límites de velocidad ni limitación.
• Acceso completo y anónimo a todos los complementos 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 consejos adictivos pueden ahorrar un enorme 60% aquí en el plan anual de IPVanish, reduciendo el precio mensual a solo $ 4.87 / mes.

Antes de que empieces

Al igual que cualquier buen desarrollador, haces tuInvestigue antes de sumergirse en la cabeza primero. Lea las siguientes secciones para aclarar cualquier idea errónea que pueda tener, luego no dude en tomar su API y comenzar a probar.

¿Qué es una base de datos de TV?

Si está desarrollando un complemento Kodi, es probableplanea indexar una cantidad significativa de contenido de películas o programas de TV. Los sitios que proporcionan la mayoría de estos archivos generalmente solo entregan videos, no acompañan datos que ayudan a identificar el contenido. El nombre del archivo probablemente contenga el programa, la temporada y el número de episodio, pero ¿qué pasa con los actores o el título real del episodio? Ahí es donde entran en juego las bases de datos de indexación.

Al conectar su complemento Kodi en una buena base de datospuede nombrar y clasificar fácilmente todo el contenido al que accede su programa desde la web. Los episodios serán fáciles de ordenar y buscar en su complemento, y serán mucho más fáciles de ver gracias a los metadatos extraídos del servicio de indexación.

¿Qué información incluye una base de datos?

Esto puede variar según el servicio que utilice, pero la mayoría de los indexadores se centran en un conjunto básico de datos que incluye lo siguiente:

• El título completo del programa y la fecha de emisión original.
• Nombres y números de episodios.
• Información de género.
• Datos sobre actores, directores, escritores, etc.
• Arte de caja, hecho por fanáticos y oficial.
• Calificaciones de usuarios y puntajes de críticas.
• Metadatos traducidos a otros idiomas.

¿De dónde viene la información?

Una variedad de fuentes que pueden sorprenderte. Como la información precisa es importante, los raspadores de bases de datos se acercan lo más posible a la fuente. Esto generalmente significa hacer referencia a sitios oficiales como Amazon o IMDB, los cuales obtienen sus títulos de espectáculos y piezas de información relacionadas de los propios estudios. De lo contrario, otros indexadores hacen referencias cruzadas de su contenido con otros rastreadores abiertos o confían en los datos enviados por los usuarios para etiquetar los lanzamientos de programas.

Claves API

API significa interfaz de programación de aplicaciones. Las claves API son pequeños archivos de permisos o cadenas de letras y números aleatorios que otorgan acceso a un programa a un servicio específico. Si está creando una aplicación para usar con Twitter, por ejemplo, necesita una clave API para que el sitio web permita que su código interactúe con el contenido de Twitter. Las claves para los índices de bases de datos de TV funcionan de la misma manera. Al agregar una clave API a su complemento Kodi, le está dando las credenciales que necesita para extraer datos del sitio web externo y usarlos dentro de Kodi.

Qué base de datos usar

Hay más de una base de datos de indexación flotantealrededor de la red mundial. Algunos de ellos son más fáciles de usar que otros, y algunos simplemente están más actualizados que sus competidores. Para nuestra guía a continuación, cubriremos el proceso de creación de API para TheTVDB.com, que es una base de datos abierta para fanáticos de la televisión. Es uno de los recursos más completos y es fácil de configurar e implementar.

¿Son legales los índices de metadatos?

Ciertamente lo son. Los servicios de indexación como la base de datos de TV que usaremos a continuación solo acceden a los metadatos que rodean un contenido, no al archivo en sí. No puede usarlos para transmitir nada, ni contribuyen a la piratería de ninguna manera. Por lo general, también tienen licencia de Creative Commons para distribución gratuita. Es el equivalente digital de organizar su colección de DVD en el estante. Completamente seguro y 100% legal.

Crear una clave de API de base de datos de TV

Una vez que tenga su proyecto de complemento Kodi en funcionamiento, puede tomar una clave API y comenzar a usarla para probar cosas.

Paso 1 - Crea una cuenta

Visita TheTVDB.com y crea una cuenta con el servicio. Use su identificador de codificación o incluso el título del complemento para mantener la coherencia. Una vez que se registre, deberá iniciar sesión, luego aceptar los términos y condiciones desplazándose hacia abajo y marcando la casilla en la parte inferior de la página.

Paso 2 - Genera la clave

Una vez que tenga una cuenta, diríjase a la página de registro de clave API. En la parte inferior, deberá ingresar el nombre de su proyecto junto con su sitio web oficial. Haga clic en "Recuperar clave de API" una vez que haya terminado.

Paso 3 - Guarde la clave API

TheTVDB mostrará su código clave en unpágina. Copie esto en un lugar seguro y no lo comparta con nadie más, ya que se generó solo para su aplicación. Tendrá que hacer referencia a esto más adelante, así que manténgalo cerca.

Uso de una clave API en su complemento Kodi

Una vez que haya generado una clave API con TheTVDB ocualquier otro servicio de indexación de metadatos, es hora de conectarlo a su código de complemento para asegurarse de que funcione. Este proceso puede variar según cómo haya estructurado su complemento. Utilizaremos la plantilla Jen, un método ampliamente utilizado para combinar rastreadores con complementos de Kodi.

Paso 1: descargue la plantilla Jen

Visite la página de github de Jen Template. Haga clic en el botón verde en la esquina superior derecha que dice "clonar o descargar", luego descargue el archivo zip en su escritorio. Extraerlo en su propia carpeta, luego prepárate para editarlo.

Paso 2 - Editar Addon.xml

Justo dentro del plugin.video.carpeta jen-master que acaba de descomprimir, encontrará un archivo llamado addon.xml. Abre esto en tu editor de código. Deberá realizar algunas modificaciones en algunas de las líneas para personalizar los datos a los que hace referencia la plantilla. Comience por completar la información en la segunda línea del archivo, a la que se hace referencia a continuación. Recuerde usar solo letras y números, sin espacios o caracteres no estándar, y no olvide establecer también el número de versión.

A continuación, edite las líneas 19 y 21 para obtener un poco más de información sobre su complemento.

Puede ver líneas duplicadas que hacen referencia a otros idiomas. Puede dejarlos solos o eliminarlos como mejor le parezca.

Guarde el archivo addon.xml, ya ha terminado de editarlo.

Paso 3 - Editar Default.py

Aquí es donde comenzamos a entrar en la clave APIinformación. En la misma carpeta de nivel superior, busque el archivo llamado default.py. Ábralo en su editor de código, luego desplácese hacia abajo hasta que vea la línea a la que se hace referencia a continuación. Debería estar alrededor de la línea 25.

Inserte la clave API de su base de datos de TV donde se indica arriba. La línea real solo tendrá dos comillas sin nada en el medio.

Guarde default.py y salga por ahora. Su clave API ha sido ingresada!

Paso 4 - Editar configuración.xml

Un último archivo para editar, luego vuelve a las pruebas. Ingrese la carpeta de recursos ubicada en el directorio de trabajo del complemento. Abra settings.xml en su editor de código, luego desplácese hacia abajo hasta la línea 27. Hay algunas piezas de información que necesitaremos ingresar aquí para terminar de configurar la Plantilla Jen.

Verifique la siguiente línea en el código del archivo. Debería aparecer tres veces en las líneas 27, 31 y 36.

Mira donde dice plugin.video.jen? Cambie esto al mismo nombre de complemento que ingresó en el archivo addon.xml. Si ingresó plugin.video.addictivetips, por ejemplo, la línea se vería así:

Guarde este archivo y salga.

Paso 5 - Renombrar y probar

Ahora que la API y los datos de personalización han sidoingresado, estás listo para terminar. Asegúrese de guardar todos los archivos que editó, luego salga de ellos y regrese a su escritorio. La carpeta en la que estamos trabajando debe titularse así:

Cambie esto para reflejar el nombre que ingresó en el archivo addon.xml, seguido del número de versión que ingresó en la misma sección. Usando nuestro ejemplo anterior, el archivo ahora se llamaría así:

¡Eso es! Ahora ha agregado los datos de la API de TVDB en su complemento y está listo para comenzar a eliminar metadatos de la web.

Otras personalizaciones de complementos

Una vez que tenga la plantilla Jen y su televisorClave de la API de la base de datos, ¿por qué no saltar y agregar algunas características de personalización más para ayudar a marcar su lanzamiento? Estos son pasos rápidos y simples que pueden ayudar mucho a que su complemento sea más reconocible.

Agregar un icono

Las imágenes de los iconos se muestran en Kodi a la izquierdalado de la pantalla cada vez que se resalta su complemento. Agregar uno hace que sea fácil detectar su contenido sin tener que leer los títulos, ¡lo cual puede ser más útil de lo que piensa! Para usar un ícono, todo lo que tiene que hacer es crear un archivo PNG de 256 × 256, preferiblemente sin texto o marca Kodi, luego agregarlo al nivel superior de su carpeta llamado icon.png. ¡Eso es!

Use Fan Art

Similar al icono de arriba, el fan art es un toquefondo que aparece detrás del texto de selección en Kodi cuando los usuarios resaltan su contenido. Esto puede estar relacionado con la marca de su icono o puede ser algo relacionado con su contenido adicional. Por ejemplo, si el complemento ofrece programas de TV, cree un banner original de fan art con personajes de Cómo conocí a su madre. Para agregar esto a su lanzamiento, simplemente haga una imagen JPG de 1280 × 720, asígnele el nombre fanart.jpg, luego péguelo en la carpeta de nivel superior de su complemento.

Conclusión

Desarrollar un complemento puede ser confuso yproceso complicado Sin embargo, la comunidad proporciona una tonelada de recursos útiles para ayudarlo en el camino. Agregar una clave API de la base de datos de TV es solo un ejemplo del contenido creado por el usuario que está listo para interactuar con su complemento sin saltar a través de todo tipo de aros para que funcione. ¿Tienes algún consejo para ayudar a los desarrolladores de Kodi? ¡Comparte tu conocimiento en los comentarios a continuación!