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

Comparte Con Tus Amigos

Artículos De Autor: Kenneth Douglas

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 hechos por el usuario que proporcionan una variedad masiva 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, ¡puede comenzar su propio 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 eliminan los 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 clasificar, etiquetar y clasificarlos todos. No es necesario obtener información por su cuenta, y no es necesario crear su propio rastreador. Simplemente toma una clave API de una base de datos de TV y conéctala a tu complemento, entonces ya está 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 tiene el software ante la opinión pública. Kodi en sí es seguro, y la mayoría de sus complementos también lo son. Los proveedores de servicios de Internet y los creadores de contenido a menudo piensan lo contrario, lo que significa que en el momento en que transmite algo a Kodi, su cuenta podría estar bajo escrutinio. No importa si su complemento es legítimo o no, todavía corre el riesgo de ser estrangulado o de que se haga un seguimiento de su cuenta.

La buena noticia es que las redes privadas virtuales son una forma fácil de vencer estas invasiones de privacidad. Con una VPN, sus datos se cifrarán antes de que salga de su dispositivo, por lo que es imposible que alguien vea qué sitios está visitando o a qué Kodi Streams está accediendo. Las VPN también dificultan el descubrimiento de su identidad o ubicación, lo que hace que el anonimato vuelva a la web.

La mejor VPN para Kodi - IPVanish

IPVanish llega a todos los lugares correctos para que la VPN perfecta se use con Kodi. Es rápido y ofrece más de 950 servidores en 60 países diferentes, por lo que siempre puede capturar 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 automático para todos los dispositivos. También aprovechará una excelente política de cero registro en el tráfico y podrá descargar torrents 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 y iOS.
  • Ancho de banda ilimitado sin límites de velocidad ni aceleració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 queLos lectores de Consejos adictivos pueden ahorrar un 60% en el plan anual de IPVanish, bajando el precio mensual a solo $ 4.87 / mes.

Antes de que empieces

Al igual que cualquier buen desarrollador, investigas antes de sumergirte en la cabeza. Lea las siguientes secciones para aclarar cualquier idea errónea que pueda tener, luego siéntase libre de tomar su API y comenzar a probar.

¿Qué es una base de datos de televisión?

Si está desarrollando un complemento Kodi, es probable que planee indexar una cantidad significativa de contenido de películas o programas de televisión. Los sitios que proporcionan la mayoría de estos archivos generalmente solo entregan videos, no datos que acompañan a los que ayudan a identificar el contenido. El nombre del archivo probablemente contiene el programa, la temporada y el número del 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 datos, puede nombrar y clasificar fácilmente todo el contenido al que su programa accede 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 usar 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 de datos principales 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.
  • Box art, tanto hecho por fans como oficial.
  • Calificaciones de usuarios y puntuaciones de crítica crítica.
  • Metadatos traducidos a otros idiomas.

¿De dónde viene la información?

Una variedad de fuentes que pueden sorprenderte. Debido a que la información precisa es importante, los raspadores de bases de datos se acercan lo más posible a la fuente. Por lo general, esto significa hacer referencia a sitios oficiales como Amazon o IMDB, los cuales obtienen los títulos de sus programas y la información relacionada de los propios estudios. Si esto falla, otros indizadores cruzan su contenido con otros rastreadores abiertos o confían en los datos enviados por el usuario 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 permiten a un programa acceder 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 manera muy similar. Al agregar una clave de 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 utilizar

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 los fanáticos de la televisión. Es uno de los recursos más completos y es fácil de configurar y desplegar.

¿Los índices de metadatos son legales?

Ciertamente lo son. Los servicios de indexación como la base de datos de TV que usaremos a continuación solo accederán a los metadatos que rodean una parte del contenido, no al archivo en sí. No puedes usarlos para transmitir nada, ni contribuyen a la piratería de ninguna manera. También suelen tener 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.

Creación de una clave API de base de datos de TV

Una vez que tenga su proyecto Kodi add-on en un estado de trabajo, puede tomar una clave API y comenzar a usarla para probar cosas.

Paso 1 - Crear una cuenta

Visite TheTVDB.com y cree una cuenta con el servicio. Use el controlador de codificación o incluso el título del complemento para mantener la coherencia. Una vez que se registre, deberá iniciar sesión y 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 - Generar 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 - Guardar la clave de la API

TheTVDB 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. Necesitará hacer referencia a esto más adelante, así que manténgalo cerca.

Usando 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 en su código de complemento para asegurarse de que funciona. Este proceso puede variar según la forma en que haya estructurado su complemento. Utilizaremos la plantilla Jen, un método ampliamente utilizado para combinar rastreadores con complementos Kodi.

Paso 1 - Descargar la Plantilla Jen

Visita la página de github de la Plantilla Jen. Haga clic en el botón verde en la parte superior derecha que dice "clonar o descargar", luego descargue el archivo zip en su escritorio. Extráigalo en su propia carpeta, luego prepárese para editar.

Paso 2 - Editar Addon.xml

Justo dentro de la carpeta plugin.video.jen-master que acabas de descomprimir, encontrarás 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 se refiere 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 configurar el número de versión, también.

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

Sumario sumarioDESCRIPCIÓN ADICIONAL MÁS LARGA

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

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

Paso 3 - Editar Default.py

Aquí es donde empezamos a entrar en la información clave de la API. En la misma carpeta de nivel superior, busque el archivo denominado default.py. Ábralo en su editor de código, luego desplácese hacia abajo hasta que vea la línea que se menciona a continuación. Debe estar alrededor de la línea 25.

__builtin __. tvdb_api_key = "PEGAR LA CLAVE DE LA API AQUÍ" # clave de api de tvdb

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. Tu clave API ha sido ingresada!

Paso 4 - Editar ajustes.xml

Un último archivo para editar, luego está de vuelta a prueba. Ingrese a 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 algunos datos que debemos ingresar aquí para finalizar la configuración de la Plantilla Jen.

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

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

Ver 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 ha ingresado la API y los datos de personalización, está listo para resumir las cosas. Asegúrese de que todos los archivos que edite estén guardados, salga de ellos y vuelva a su escritorio. La carpeta en la que estamos trabajando debería 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 rascar los metadatos de la web.

Otras personalizaciones adicionales

Una vez que hayas resuelto la plantilla de Jen y la clave API de tu base de datos de TV, ¿por qué no saltar y agregar algunas funciones de personalización más para ayudar a marcar tu lanzamiento? Estos son pasos rápidos y simples que pueden hacer mucho para que su complemento sea más reconocible.

Añadir un icono

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

Usa Fan Art

Al igual que en el ícono de arriba, fan art es un fondo de presentación que se muestra 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 el contenido de su complemento. Por ejemplo, si el complemento ofrece programas de televisión, crea un banner original de fan art con personajes de Cómo conocí a tu madre. Para agregar esto a su lanzamiento, solo cree una imagen JPG de 1280 × 720, nómbrela fanart.jpg y luego péguela 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 darle una mano en el camino. Agregar una clave API de 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 todo tipo de problemas para que funcione. ¿Tienes algún consejo para ayudar a los desarrolladores de Kodi en ciernes? ¡Comparte tu conocimiento en los comentarios a continuación!

Deja un comentario

Comparte Con Tus Amigos

Sus Comentarios