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 cualquiera puede consultar el código o incluso contribuir a los cambios en el funcionamiento central. 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 su cuenta. 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 los desarrolladores de complementos de Kodi son los 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.

Recordatorio

Si está desarrollando un complemento para Kodi, está al tanto de la posición que el software mantiene 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 una manera 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 a 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

IPVanishllega a todos los lugares correctos para la VPN perfecta para usar 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 y 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 Consejos adictivos lectores pueden ahorre un masivo 60% aquí sobre el plan anual IPVanish, reduciendo el precio mensual a solo $ 4.87 / mes.

Antes de que empieces

Al igual que cualquier buen desarrollador, haces tu investigación antes de sumergirte de cabeza. 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 de Kodi, es probable que planee 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 a una buena base de datos, puede 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, tanto hecho por fanáticos como 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 de 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 se interconecte 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 flotando en 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 el 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 su 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

Visitar 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 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

La TVDB mostrará su código clave en una página separada. 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 o cualquier otro servicio de indexación de metadatos, es hora de conectarlo a su código adicional 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

Visita el 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 de la carpeta plugin.video.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.

RESUMEN DE ADDON

DESCRIPCIÓN ADICIONAL MÁS LARGA

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 acceder a la información clave de la API. 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.

__builtin __. tvdb_api_key = "PEGAR LA CLAVE API AQUÍ" # tvdb api key

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 aproximadamente la línea 27. Hay algunas informaciones 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.

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

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í:

action = "RunPlugin (plugin: //plugin.video.addictivetips/? mode = ScraperSettings)" />

Guarde este archivo y salga.

Paso 5 - Renombrar y probar

Ahora que se han ingresado los datos de API y personalización, está listo para concluir. 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í:

plugin.video.jen-master

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í:

plugin.video.addictivetips.0.1.zip

¡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 en cuenta la plantilla Jen y la clave API de la base de datos de su TV, ¿por qué no participar y agregar algunas características más de personalización 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 ícono

Las imágenes de iconos se muestran en Kodi en el lado izquierdo 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 que 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

Al igual que el ícono anterior, el fan art es un fondo de bienvenida que aparece detrás del texto de selección en Kodi cada vez que 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 televisión, 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 un proceso confuso y 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!