Come creare e utilizzare una chiave API per il database TV: suggerimenti per gli sviluppatori Kodi

Il software Kodi è gratuito e open source, il che significa che chiunque può verificarne il codice o persino apportare modifiche al suo funzionamento principale. Il vero punto di forza di Kodi, tuttavia, è la sua community. Il software è stato progettato per interfacciarsi con componenti aggiuntivi creati dagli utenti che offrono un'enorme varietà di contenuti, elementi che il team principale di Kodi non avrebbe mai potuto implementare da solo. Questi componenti aggiuntivi sono chiamati "non ufficiali" e sono così facili da realizzare che puoi crearne uno in un pomeriggio!

Un servizio incredibilmente utile offerto agli sviluppatori di componenti aggiuntivi per Kodi sono gli indicizzatori di database TV, siti come TheTVDB.com o Trakt. Entrambe le risorse estraggono metadati dal web e forniscono le informazioni al pubblico gratuitamente. Questo significa che è possibile creare un componente aggiuntivo che trovi diversi programmi TV e utilizzare TheTVDB per categorizzarli, etichettarli e ordinarli. Non è necessario recuperare le informazioni autonomamente, né creare un proprio tracker. Basta prendere una chiave API da un database TV e inserirla nel componente aggiuntivo, e il gioco è fatto. La nostra guida qui sotto vi guiderà attraverso il processo dall'inizio alla fine.

Ottieni la VPN n. 1

68% DI SCONTO + 3 MESI GRATIS

Promemoria

Se stai sviluppando un componente aggiuntivo per Kodi, sei ben consapevole della posizione che il software occupa agli occhi del pubblico. Kodi in sé è sicuro, e lo sono anche la maggior parte dei suoi componenti aggiuntivi. ISP e creatori di contenuti spesso la pensano diversamente, il che significa che nel momento in cui trasmetti qualcosa in streaming su Kodi, il tuo account potrebbe essere sotto esame. Non importa se il tuo componente aggiuntivo sia legittimo o meno, corri comunque il rischio di essere limitato o che il tuo account venga tracciato.

La buona notizia è che le reti private virtuali (VPN) rappresentano un modo semplice per contrastare queste violazioni della privacy. Con una VPN, i tuoi dati verranno crittografati prima di lasciare il tuo dispositivo, rendendo impossibile per chiunque vedere quali siti stai visitando o a quali streaming Kodi stai accedendo. Le VPN rendono inoltre difficile scoprire la tua identità o posizione, restituendo un certo grado di anonimato al World Wide Web.

La migliore VPN per Kodi – IPVanish

IPVanish è la VPN perfetta da usare con Kodi. È veloce, con oltre 950 server in 60 paesi diversi, così puoi sempre ottenere una connessione a bassa latenza, indipendentemente da dove vivi. È anche sicuro, con crittografia AES a 256 bit, protezione da perdite DNS e kill switch automatico per tutti i dispositivi. Potrai inoltre usufruire di un'eccellente politica di zero-log sul traffico e scaricare torrent e contenuti di rete P2P in completo anonimato. Con IPVanish, tutto ciò che devi fare è eseguire l'app e la tua connessione è sicura.

Altre funzionalità di IPVanish:

  • Applicazioni facili da usare per Windows, Mac, Linux, Android e iOS.
  • Larghezza di banda illimitata senza limiti di velocità o limitazioni.
  • Accesso completo e anonimo a tutti i componenti aggiuntivi di Kodi.

IPVanish offre una garanzia di rimborso di 7 giorni, il che significa che hai una settimana per provarlo senza rischi. Si prega di notare che  i lettori di WebTech360 Tips possono  risparmiare ben il 60%  sul piano annuale di IPVanish , riducendo il prezzo mensile a soli $ 4,87 al mese.

Prima di iniziare

Come ogni bravo sviluppatore, fai le tue ricerche prima di buttarti a capofitto. Leggi le sezioni seguenti per chiarire eventuali dubbi, poi sentiti libero di scaricare la tua API e iniziare a testarla.

Come creare e utilizzare una chiave API per il database TV: suggerimenti per gli sviluppatori Kodi

Che cos'è un database televisivo?

Se stai sviluppando un componente aggiuntivo per Kodi, è probabile che tu intenda indicizzare una quantità significativa di contenuti di film o serie TV. I siti che forniscono la maggior parte di questi file di solito forniscono solo video, senza dati di accompagnamento che aiutino a identificare il contenuto. Il nome del file probabilmente contiene il nome della serie, la stagione e il numero dell'episodio, ma che dire degli attori o del titolo effettivo dell'episodio? È qui che entrano in gioco i database di indicizzazione.

Collegando il tuo componente aggiuntivo Kodi a un buon database, puoi facilmente denominare e categorizzare tutti i contenuti a cui il tuo programma accede dal web. Gli episodi saranno facili da ordinare e cercare sul tuo componente aggiuntivo e saranno molto più facili da visualizzare grazie ai metadati estratti dal servizio di indicizzazione.

Quali informazioni contiene un database?

Questo può variare a seconda del servizio utilizzato, ma la maggior parte degli indicizzatori si concentra su un set di dati di base che include quanto segue:

  • Titolo completo dello show e data di messa in onda originale.
  • Nomi e numeri degli episodi.
  • Informazioni sul genere.
  • Dati su attori, registi, scrittori, ecc.
  • Cofanetto, sia realizzato dai fan che ufficiale.
  • Valutazioni degli utenti e punteggi delle recensioni dei critici.
  • Metadati tradotti in altre lingue.

Da dove provengono le informazioni?

Una varietà di fonti che potrebbero sorprendervi. Poiché l'accuratezza delle informazioni è importante, gli scraper di database si avvicinano il più possibile alla fonte. Questo di solito significa fare riferimento a siti ufficiali come Amazon o IMDB, entrambi i quali ottengono i titoli delle serie e le relative informazioni dagli studi stessi. In caso contrario, altri indicizzatori incrociano i propri contenuti con altri tracker aperti o si affidano ai dati inviati dagli utenti per taggare le uscite delle serie.

Chiavi API

API sta per Application Programming Interface (interfaccia di programmazione di un'applicazione). Le chiavi API sono piccoli file di autorizzazione o stringhe di lettere e numeri casuali che garantiscono a un programma l'accesso a un servizio specifico. Se stai sviluppando un'app da utilizzare con Twitter, ad esempio, hai bisogno di una chiave API affinché il sito web consenta al tuo codice di interfacciarsi con i contenuti di Twitter. Le chiavi per gli indici dei database TV funzionano più o meno allo stesso modo. Aggiungendo una chiave API al tuo componente aggiuntivo per Kodi, gli fornisci le credenziali necessarie per estrarre i dati dal sito web esterno e utilizzarli all'interno di Kodi.

Quale database utilizzare

Esistono più database di indicizzazione sul World Wide Web. Alcuni sono più facili da usare di altri, e alcuni sono semplicemente più aggiornati rispetto alla concorrenza. Nella nostra guida qui sotto, tratteremo il processo di creazione dell'API per TheTVDB.com, un database aperto per gli appassionati di televisione. È una delle risorse più complete ed è facile da configurare e implementare.

Gli indici di metadati sono legali?

Certamente. I servizi di indicizzazione come il database TV che useremo di seguito accedono solo ai metadati relativi a un contenuto, non al file stesso. Non è possibile utilizzarli per lo streaming, né contribuiscono in alcun modo alla pirateria. Di solito sono concessi in licenza Creative Commons per la distribuzione gratuita. È l'equivalente digitale dell'organizzazione della propria collezione di DVD sullo scaffale. Completamente sicuri e legali al 100%.

Creazione di una chiave API per il database TV

Una volta che il tuo progetto aggiuntivo Kodi è funzionante, puoi procurarti una chiave API e iniziare a usarla per testare il tutto.

Come creare e utilizzare una chiave API per il database TV: suggerimenti per gli sviluppatori Kodi

Passaggio 1: creare un account

Visita TheTVDB.com e crea un account per il servizio. Usa il tuo handle di programmazione o anche il titolo del componente aggiuntivo per coerenza. Una volta registrato, dovrai effettuare l'accesso e accettare i termini e le condizioni scorrendo verso il basso e spuntando la casella in fondo alla pagina.

Passaggio 2: generare la chiave

Una volta creato un account, vai alla pagina di registrazione della chiave API . In basso dovrai inserire il nome del tuo progetto e il suo sito web ufficiale. Al termine, clicca su "Recupera chiave API".

Passaggio 3: salva la chiave API

TheTVDB mostrerà il tuo codice chiave su una pagina separata. Copialo in un luogo sicuro e non condividerlo con nessuno, poiché è stato generato appositamente per la tua applicazione. Ti servirà come riferimento in seguito, quindi tienilo a portata di mano.

Utilizzo di una chiave API nel componente aggiuntivo Kodi

Una volta generata una chiave API con TheTVDB o qualsiasi altro servizio di indicizzazione dei metadati, è il momento di inserirla nel codice del componente aggiuntivo per assicurarti che funzioni. Questo processo può variare a seconda di come hai strutturato il componente aggiuntivo. Useremo il Jen Template, un metodo ampiamente utilizzato per combinare tracker con componenti aggiuntivi Kodi.

Come creare e utilizzare una chiave API per il database TV: suggerimenti per gli sviluppatori Kodi

Passaggio 1: scarica il modello Jen

Visita la pagina GitHub del Jen Template . Clicca sul pulsante verde in alto a destra che dice "clona o scarica", quindi scarica il file zip sul desktop. Estrailo in una cartella dedicata e preparati a fare qualche modifica.

Passaggio 2: modifica Addon.xml

All'interno della cartella plugin.video.jen-master che hai appena decompresso, troverai un file chiamato addon.xml. Aprilo nel tuo editor di codice. Dovrai apportare alcune modifiche ad alcune righe per personalizzare i dati a cui fa riferimento il modello. Inizia compilando le informazioni nella seconda riga del file, come indicato di seguito. Ricorda di utilizzare solo lettere e numeri, senza spazi o caratteri non standard, e non dimenticare di impostare anche il numero di versione.

Successivamente, modifica le righe 19 e 21 per fornire maggiori informazioni sul tuo componente aggiuntivo.

RIEPILOGO AGGIUNTIVO


DESCRIZIONE AGGIUNTIVA PIÙ LUNGA

Potresti trovare righe duplicate che fanno riferimento ad altre lingue. Puoi lasciarle così come sono o rimuoverle come preferisci.

Salva il file addon.xml, per ora hai finito di modificarlo.

Come creare e utilizzare una chiave API per il database TV: suggerimenti per gli sviluppatori Kodi

Passaggio 3: modifica Default.py

È qui che iniziamo ad analizzare le informazioni sulla chiave API. Nella stessa cartella di primo livello, cerca il file denominato default.py. Aprilo nell'editor di codice, quindi scorri verso il basso fino a visualizzare la riga indicata di seguito. Dovrebbe essere intorno alla riga 25.

__builtin__.tvdb_api_key = “INCOLLA LA CHIAVE API QUI” # chiave API tvdb

Inserisci la chiave API del tuo database TV dove indicato sopra. La riga effettiva avrà solo due virgolette, senza alcun elemento intermedio.

Salva default.py ed esci per ora. La tua chiave API è stata inserita!

Passaggio 4: modifica Settings.xml

Un ultimo file da modificare, poi si torna al test. Accedi alla cartella resources che si trova nella directory di lavoro del plugin. Apri settings.xml nell'editor di codice, quindi scorri verso il basso fino alla riga 27 circa. Ci sono alcune informazioni che dovremo inserire qui per completare la configurazione del modello Jen.

Controlla la seguente riga nel codice del file. Dovrebbe comparire tre volte, alle righe 27, 31 e 36.

azione=”EseguiPlugin(plugin://plugin.video.jen/?mode=ScraperSettings)”/>

Vedi dove c'è scritto plugin.video.jen ? Sostituiscilo con lo stesso nome del plugin che hai inserito nel file addon.xml. Se hai inserito plugin.video.addictivetips, ad esempio, la riga apparirà così:

azione=”EseguiPlugin(plugin://plugin.video.addictivetips/?mode=ScraperSettings)”/>

Salvare il file ed uscire.

Passaggio 5: rinomina e testa

Ora che hai inserito i dati API e di personalizzazione, sei pronto per concludere. Assicurati che tutti i file modificati siano salvati, quindi esci e torna al desktop. La cartella in cui stiamo lavorando dovrebbe avere un nome simile a questo:

plugin.video.jen-master

Modificalo in modo che rifletta il nome inserito nel file addon.xml, seguito dal numero di versione inserito nella stessa sezione. Utilizzando l'esempio precedente, il file ora si chiamerebbe così:

plugin.video.addictivetips.0.1.zip

Ecco fatto! Ora hai aggiunto i dati dell'API TVDB al tuo componente aggiuntivo e sei pronto per iniziare a estrarre i metadati dal web.

Altre personalizzazioni aggiuntive

Una volta che hai creato il modello Jen e la chiave API del database TV, perché non aggiungere altre funzionalità di personalizzazione per dare un tocco di branding alla tua release? Si tratta di passaggi rapidi e semplici che possono contribuire notevolmente a rendere il tuo componente aggiuntivo più riconoscibile.

Aggiungi un'icona

Le immagini delle icone vengono visualizzate in Kodi sul lato sinistro dello schermo ogni volta che il componente aggiuntivo è evidenziato. Aggiungerne una semplifica l'individuazione dei contenuti senza dover leggere i titoli, il che può essere più utile di quanto si pensi! Per utilizzare un'icona, tutto ciò che devi fare è creare un file PNG 256×256, preferibilmente senza testo o marchio Kodi, quindi aggiungerlo al livello superiore della cartella denominata icon.png. Tutto qui!

Usa Fan Art

Simile all'icona qui sopra, la fan art è uno sfondo splash che appare dietro il testo di selezione in Kodi ogni volta che gli utenti evidenziano il tuo contenuto. Questo può essere correlato al branding della tua icona o può essere qualcosa a tema con il contenuto del tuo componente aggiuntivo. Ad esempio, se il plugin offre programmi TV, crea un banner fan art originale con i personaggi di How I Met Your Mother. Per aggiungerlo alla tua release, crea un'immagine JPG 1280×720, chiamala fanart.jpg e inseriscila nella cartella di primo livello del tuo componente aggiuntivo.

Conclusione

Sviluppare un componente aggiuntivo può essere un processo complicato e confuso. Tuttavia, la community offre moltissime risorse utili per darti una mano. Aggiungere una chiave API per un database TV è solo un esempio dei contenuti creati dagli utenti, pronti per interfacciarsi con il tuo componente aggiuntivo senza dover passare attraverso tutti i tipi di ostacoli per farlo funzionare. Hai qualche consiglio per aiutare gli sviluppatori Kodi in erba? Condividi le tue conoscenze nei commenti qui sotto!

Leave a Comment

Come abilitare RTMP su Kodi per lo streaming live

Come abilitare RTMP su Kodi per lo streaming live

Se utilizzi ancora Kodi Krypton, potresti aver notato che gli streaming live possono essere problematici. Ma abilitando RTMP, puoi facilmente risolvere il problema più comune.

Come guardare Marvels Runaways online e con Kodi

Come guardare Marvels Runaways online e con Kodi

Uno dei sorprendenti successi televisivi della fine del 2017 è stato Marvels Runaways, uno show che racconta la storia di un gruppo di giovani insoliti che scoprono che

Come trasferire Kodi su Amazon Fire Stick e altri dispositivi

Come trasferire Kodi su Amazon Fire Stick e altri dispositivi

Scopri come trasferire facilmente la tua build Kodi su un altro dispositivo, risparmiando tempo e fatica nell'impostazione delle tue personalizzazioni preferite.

I migliori programmi di installazione di componenti aggiuntivi per Kodi: quali sono i migliori programmi di installazione per Kodi?

I migliori programmi di installazione di componenti aggiuntivi per Kodi: quali sono i migliori programmi di installazione per Kodi?

Kodi è un software incredibilmente utile. È gratuito e open source, funziona su laptop, tablet e smartphone ed è altamente personalizzabile.

Guida allinstallazione delladdon Abraxas Kodi - Guarda documentari in streaming online

Guida allinstallazione delladdon Abraxas Kodi - Guarda documentari in streaming online

Esistono alcuni componenti aggiuntivi dedicati ai documentari disponibili per Kodi, ma la maggior parte di essi tende a concentrarsi su un genere o un'area specifica. Abraxas è diverso.

Come installare Selfless su Kodi – Add-on IPTV Kodi

Come installare Selfless su Kodi – Add-on IPTV Kodi

Cercare un buon componente aggiuntivo IPTV per la tua installazione Kodi può essere frustrante. Il componente aggiuntivo Selfless è il proverbiale ago nel pagliaio, e si è dimostrato...

Come guardare film indiani su Kodi + Il miglior componente aggiuntivo Kodi per i film hindi 2025

Come guardare film indiani su Kodi + Il miglior componente aggiuntivo Kodi per i film hindi 2025

Il nostro ultimo elenco dei migliori componenti aggiuntivi ufficiali e non ufficiali per Kodi per guardare film di Bollywood, hindi e altri contenuti indiani su Kodi.

FightTube Kodi Addon: un fantastico componente aggiuntivo per gli sport da combattimento

FightTube Kodi Addon: un fantastico componente aggiuntivo per gli sport da combattimento

Se ti piacciono le MMA, la boxe, il wrestling o le arti marziali, probabilmente sei alla ricerca da tempo di un componente aggiuntivo dedicato agli sport da combattimento. Su

Project Cypher per Kodi: come installare il componente aggiuntivo Project Cypher per Kodi

Project Cypher per Kodi: come installare il componente aggiuntivo Project Cypher per Kodi

La maggior parte degli utenti Kodi è alla ricerca di un componente aggiuntivo IPTV affidabile e Project Cypher è sicuramente un forte contendente. È sulla scena Kodi da un

Come eseguire il jailbreak di Roku e installare Kodi (tutorial completo)

Come eseguire il jailbreak di Roku e installare Kodi (tutorial completo)

Scopri se puoi effettuare il jailbreak di un Roku e sbloccare film gratuiti! Segui la nostra semplice guida passo passo per trasferire le app e migliorare la tua esperienza di streaming.