Sådan oprettes og bruges en API-nøgle til tv-database: Kodi Developer Tips

Indholdsfortegnelse:

Sådan oprettes og bruges en API-nøgle til tv-database: Kodi Developer Tips
Sådan oprettes og bruges en API-nøgle til tv-database: Kodi Developer Tips
Anonim

Kodi-softwaren er fri og åben kilde, hvilket betyder, at det er muligt for alle at tjekke koden eller endda bidrage med ændringer i kerneoperationerne. Den virkelige magt bag Kodi er imidlertid dens samfund. Softwaren blev designet til at interfere med brugerdefinerede tilføjelser, der giver et stort udvalg af indhold, som Kodi's kerneteam aldrig kunne implementere på egen hånd. Disse kaldes uofficielle add-ons, og de er så nemme at lave, du kan starte din egen om eftermiddagen!

En utrolig nyttig tjeneste, der leveres til Kodi add-on udviklere, er tv-database indeksere, websteder som TheTVDB.com eller Trakt. Begge ressourcer skraber metadata fra hele internettet og giver gratis information til offentligheden. Det betyder, at du kan opbygge en tilføjelse, der finder forskellige tv-shows og bruge TheTVDB til at kategorisere, mærke og sortere dem alle. Du behøver ikke hente information selv, og du behøver ikke at bygge din egen tracker. Du skal blot gribe en API-nøgle fra en tv-database og sætte den i din tilføjelse, så er du indstillet. Vores guide nedenfor går igennem processen fra start til slut.
En utrolig nyttig tjeneste, der leveres til Kodi add-on udviklere, er tv-database indeksere, websteder som TheTVDB.com eller Trakt. Begge ressourcer skraber metadata fra hele internettet og giver gratis information til offentligheden. Det betyder, at du kan opbygge en tilføjelse, der finder forskellige tv-shows og bruge TheTVDB til at kategorisere, mærke og sortere dem alle. Du behøver ikke hente information selv, og du behøver ikke at bygge din egen tracker. Du skal blot gribe en API-nøgle fra en tv-database og sætte den i din tilføjelse, så er du indstillet. Vores guide nedenfor går igennem processen fra start til slut.

Påmindelse

Hvis du udvikler et tilføjelsesprogram til Kodi, er du meget opmærksom på den placering, som softwaren har i offentlighedens øjne. Kodi selv er sikkert, og de fleste af dens tilføjelser er også. Internetudbydere og indholdsskabere tænker ofte ellers, hvilket betyder, at det øjeblik du streamer noget på Kodi, kan din konto være under kontrol. Det er ligegyldigt, om din tilføjelse er legitim eller ej, du er stadig i fare for at blive spredt eller have din konto sporet.

Den gode nyhed er virtuelle private netværk er en nem måde at besejre disse invasioner af privatlivets fred. Med en VPN bliver dine data krypteret, inden den forlader din enhed, hvilket gør det umuligt for nogen at se, hvilke websteder du besøger, eller hvilke Kodi streams du har adgang til. VPN'er gør det også svært at opdage din identitet eller placering, hvilket giver en vis anonymitet tilbage til World Wide Web.

Den bedste VPN til Kodi - IPVanish

Image
Image

IPVanish rammer alle de rigtige pletter for den perfekte VPN at bruge sammen med Kodi. Det er hurtigt og tilbyder over 950 servere i 60 forskellige lande, så du kan altid nab en lav latency forbindelse uanset hvor du bor. Det er også sikkert, der leverer 256-bit AES-kryptering, DNS-lækagebeskyttelse og en automatisk kill-switch for alle enheder. Du vil også udnytte en stor nulloggningspolitik på trafik og være i stand til at downloade torrenter og P2P-netværksindhold med fuld anonymitet. Med IPVanish er alt du skal gøre, køre appen, og din forbindelse er sikker.

Flere IPVanish funktioner:

  • Nem at bruge apps til Windows, Mac, Linux, Android og iOS.
  • Ubegrænset båndbredde uden hastighedsdæksler eller gasregulering.
  • Fuld anonym tilgang til alle Kodis tilføjelser.

IPVanish tilbyder en 7-dages penge tilbage garanti, hvilket betyder at du har en uge til at teste det uden risiko. Bemærk, at Addictive Tips læsere kan gemme en massiv 60% her på IPVanish årlige plan, tager den månedlige pris ned til kun $ 4,87 / mo.

Før du begynder

Ligesom enhver god udvikler gør du din forskning inden du først dyker i hovedet. Læs følgende afsnit for at rydde op for eventuelle misforståelser, du måtte have, så tag det fri for at få fat i din API og start testningen.

Image
Image

Hvad er en tv-database?

Hvis du udvikler en Kodi-tilføjelse, er det sandsynligvis du planlægger at indeksere en betydelig mængde film eller tv-indhold. De websteder, der leverer de fleste af disse filer, leverer normalt kun videoer, der ikke ledsager data, der hjælper med at identificere indholdet. Filnavnet indeholder sandsynligvis show-, sæson- og episode nummer, men hvad med skuespillerne eller episodens faktiske titel? Det er her, hvor indekseringsdatabaser kommer i spil.

Ved at tilslutte din Kodi add-on til en god database kan du nemt navngive og kategorisere alt det indhold, dit program får adgang til fra internettet. Afsnit er lette at sortere og søge på din tilføjelse, og de bliver meget lettere på øjnene takket være metadataene, der er skrabet fra indekseringstjenesten.

Hvilke oplysninger indeholder en database?

Dette kan variere afhængigt af den service, du bruger, men de fleste indeksører fokuserer på et kernesæt af data, der indeholder følgende:

  • Visets komplette titel og originale luftdato.
  • Episode navne og numre.
  • Genre information.
  • Data om skuespillere, direktører, forfattere mv.
  • Box kunst, både fan-made og officielle.
  • Bruger ratings og kritik score scoringer.
  • Metadata oversat til andre sprog.

Hvor kommer oplysningerne fra?

En række forskellige kilder, der kan overraske dig. Da nøjagtige oplysninger er vigtige, går databaseskrabere så tæt på kilden som muligt. Det betyder normalt at referere til officielle websteder som Amazon eller IMDB, der begge får deres udstillings titler og relaterede stykker information fra studierne selv. Hvis dette ikke er tilfældet, refererer andre indeksere deres indhold med andre åbne trackers eller stole på brugerindleverede data til tagging af udgivelser.

API nøgler

API står for applikationsprogrammeringsinterface. API-nøgler er enten små tilladelsesfiler eller strenge af randomiserede bogstaver og tal, der giver et program adgang til en bestemt tjeneste. Hvis du bygger en app til brug sammen med Twitter, har du brug for en API-nøgle, så hjemmesiden gør det muligt for din kode at interfere med kvinders indhold. Taster til tv-database indeks arbejder på samme måde. Ved at tilføje en API-nøgle til din Kodi-tilføjelse giver du det de legitimationsoplysninger, der er nødvendige for at trække data fra den eksterne hjemmeside og bruge den inden for Kodi.

Hvilken database skal du bruge

Der er mere end én indeksdatabase, der flyder rundt om i verden. Nogle af dem er nemmere at bruge end andre, og nogle er simpelthen mere opdaterede end deres konkurrence. I vores guide nedenfor dækker vi API-oprettelsesprocessen for TheTVDB.com, som er en åben database til tv-fans. Det er en af de mere komplette ressourcer og er let at konfigurere og implementere.

Er metadataindekser juridiske?

De er bestemt. Indeksering af tjenester som den tv-database, vi bruger nedenfor, giver kun adgang til metadataene omkring et indhold, ikke selve filen. Du kan ikke bruge dem til at streame noget, og de bidrager heller ikke til piratkopiering på nogen måde. De er også normalt licenseret under Creative Commons til gratis distribution. Det er den digitale tilsvarende til at organisere din DVD-samling på hylden. Helt sikkert og 100% lovligt.

Oprettelse af en API-nøgle til tv-databasen

Når du har fået dit Kodi add-on-projekt i en fungerende tilstand, kan du gribe en API-nøgle og begynde at bruge den til at teste tingene ud.

Image
Image

Trin 1 - Opret en konto

Besøg TheTVDB.com og opret en konto med tjenesten. Brug dit kodende håndtag eller endda tilføjelsens titel for konsistens. Når du har registreret dig, skal du logge ind og acceptere vilkårene ved at rulle ned og tjekke boksen nederst på siden.

Trin 2 - Generer nøglen

Når du har en konto, skal du gå til API-nøgles registreringsside. I bunden skal du indtaste dit projekt navn sammen med dets officielle hjemmeside. Klik på "Hent API-nøgle", når du er færdig.

Trin 3 - Gem API-nøglen

TheTVDB vil vise din nøglekode på en separat side. Kopier dette et eller andet sted sikkert, og del det ikke med andre, da det blev genereret kun til din ansøgning. Du skal referere til dette senere, så hold det tæt ved.

Brug en API nøgle i din Kodi Add-on

Når du har genereret en API-nøgle med TheTVDB eller en anden metadataindekseringstjeneste, er det tid til at sætte det i din tillægskode for at sikre, at det fungerer. Denne proces kan variere afhængigt af, hvordan du har struktureret dit tilføjelsesprogram. Vi bruger Jen Template, en udbredt metode til at kombinere trackers med Kodi add-ons.

Image
Image

Trin 1 - Download Jen Template

Besøg Jen Template's github-side. Klik på den grønne knap øverst til højre, der siger "klon eller download", og download derefter zip-filen til dit skrivebord. Udpak det i sin egen mappe, og gør dig klar til at lave nogle redigeringer.

Trin 2 - Rediger Addon.xml

Lige inde i mappen plugin.video.jen-master, du lige har pakket ud, finder du en fil med navnet addon.xml. Åbn dette i din kode editor. Du skal foretage nogle få redigeringer til nogle af linjerne for at tilpasse de data, som skabelonen refererer til. Start med at udfylde oplysningerne i den anden linje af filen, som refereres nedenfor. Husk at bruge kun bogstaver og tal, intet mellemrum eller ikke-standardtegn, og glem ikke at indstille versionsnummeret.

Dernæst rediger linjerne 19 og 21 for at give lidt mere information om din tilføjelse.

TILFØJ SAMMENFATNINGLANGERE ADDON BESKRIVELSE

Du kan se dubletter, der refererer til andre sprog. Du kan lade dem være alene eller fjerne dem, som du finder passende.

Gem filen addon.xml, du er færdig med at redigere det for nu.

Image
Image

Trin 3 - Rediger Default.py

Det er her, vi begynder at komme ind i API-nøgleoplysningerne. I den samme øverste mappe mappe skal du kigge efter filen med navnet default.py. Åbn den i din kodeditor, og rul derefter ned, indtil du ser linjen, der er refereret nedenfor. Det skulle være omkring linje 25.

__builtin __. tvdb_api_key = "PASTE API KEY HERE" # tvdb api nøgle

Indsæt din API-nøgle til tv-databasen, som angivet ovenfor. Den aktuelle linje vil kun have to citatmærker med intet imellem.

Gem default.py og afslut for nu. Din API-nøgle er blevet indtastet!

Trin 4 - Rediger Settings.xml

En sidste fil til redigering, så er den tilbage til test. Indtast ressourcemappen placeret i pluginets arbejdsmappe. Åbn settings.xml i din kodeditor, og rul ned til om linje 27. Der er et par stykker information, vi skal indtaste her for at afslutte opsætningen af Jen-skabelonen.

Se efter følgende linje i filens kode. Det skal vises tre gange i linjerne 27, 31 og 36.

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

Se hvor det står plugin.video.jen? Skift dette til det samme pluginnavn, du indtastede i filen addon.xml. Hvis du har indtastet plugin.video.addictivetips, ser linjen sådan ud:

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

Gem denne fil og afslut.

Trin 5 - Omdøb og test

Nu hvor API og tilpasningsdata er indtastet, er du klar til at pakke op. Sørg for, at alle de filer, du redigerede, gemmes, og afslut dem og gå tilbage til dit skrivebord. Den mappe, vi arbejder i, skal have titlen noget som dette:

plugin.video.jen-mester

Skift dette for at afspejle det navn, du indtastede i filen addon.xml, efterfulgt af det versionsnummer, du indtastede i samme afsnit. Ved hjælp af vores eksempel ovenfor bliver filen nu navngivet:

plugin.video.addictivetips.0.1.zip

Det er det! Du har nu tilføjet TVDB API-dataene i din tilføjelse og er klar til at begynde at skrabe metadata fra internettet.

Andre tilpasningstilpasninger

Når du har fået Jen Template og din TV-database API-nøgle taget sig af, hvorfor ikke springe ind og tilføj et par ekstra tilpasningsfunktioner for at hjælpe med at mærke din udgivelse? Disse er hurtige og enkle trin, der kan gå langt for at gøre din add-on mere genkendelig.

Tilføj et ikon

Ikonbilleder vises i Kodi på venstre side af skærmen, hver gang din tilføjelse er fremhævet. Tilføjelse gør det nemt at se dit indhold uden at skulle læse titlerne, hvilket kan være mere nyttigt end du tror! For at bruge et ikon er alt du skal gøre, oprette en 256 × 256 PNG-fil, helst uden tekst eller Kodi-branding, og tilføj det derefter til det øverste niveau i din mappe med navnet icon.png. Det er det!

Brug Fan Art

Ligesom ikonet ovenfor er fan art en splash baggrund, der vises bag valgtekst i Kodi, når brugere fremhæver dit indhold. Dette kan relateres til din ikon branding, eller det kan være noget tema for dit add-on indhold. Hvis f.eks. Plugin'et leverer tv-shows, skal du oprette et originalt fan art-banner med tegn fra Hvordan jeg mødte din mor. For at tilføje dette til din udgivelse skal du bare lave et 1280 × 720 JPG-billede, navngive det fanart.jpg, og sæt det derefter i øverste niveau mappe på din tilføjelse.

Konklusion

Udvikling af en add-on kan være en forvirrende og kompliceret proces. Fællesskabet giver et væld af nyttige ressourcer til at give dig en hånd undervejs. Tilføjelse af en API-nøgle til tv-databasen er blot et eksempel på det brugerdefinerede indhold, der er klar til at interfere med din tilføjelse uden at hoppe gennem alle former for hoops for at få det til at fungere. Har du fået nogle tips til at hjælpe med spirende Kodi-udviklere? Del din viden i kommentarerne nedenfor!

Populært emne.