TV-tietokannan API-avaimen luominen ja käyttö: Kodi-kehittäjävinkit

Kodi-ohjelmisto on ilmainen ja avoimen lähdekoodin,eli kuka tahansa voi tarkistaa koodin tai jopa osallistua muutoksiin ydintoiminnoissa. Kodin todellinen voima on kuitenkin sen yhteisö. Ohjelmisto on suunniteltu liittymään käyttäjän valmistamien lisäosien kanssa, jotka tarjoavat valtavan määrän sisältöä, mitä Kodin ydinjoukkue ei koskaan pystynyt toteuttamaan yksinään. Niitä kutsutaan epävirallisiksi lisäosiksi, ja ne on niin helppo tehdä, että voit aloittaa omat iltapäivällä!

Yksi uskomattoman hyödyllinen palvelu Kodillelisäosakehittäjät ovat TV-tietokantaindeksereitä, sivustoja, kuten TheTVDB.com tai Trakt. Molemmat resurssit kaappaavat metatiedot verkosta ja toimittavat tiedot yleisölle ilmaiseksi. Tämä tarkoittaa, että voit rakentaa lisäosan, joka löytää erilaisia ​​televisio-ohjelmia, ja käyttää TheTVDB: tä luokittelemaan, nimeämään ja lajittelemaan ne kaikki. Sinun ei tarvitse hakea tietoja itse eikä sinun tarvitse rakentaa omaa seurantaa. Tartu vain API-avaimeen TV-tietokannasta ja kytke se lisäosaan, niin olet valmis. Alla oleva opas opastaa sinut prosessin alusta loppuun.

Eksklusiivinen tarjous: Säästä 49%. Kokeile ExpressVPN-riskiä!

Hanki # 1: n arvioitu VPN

30 päivän rahat takaisin -takuu

Kuinka saada ILMAINEN VPN 30 päiväksi

Jos tarvitset VPN: n hetkeksi esimerkiksi matkustessasi, voit saada korkeimmalle luokitellulle VPN: lle ilmaiseksi. ExpressVPN sisältää 30 päivän rahat takaisin -takuun. Sinun on maksettava tilauksesta, se on tosiasia, mutta se sallii täysi käyttöoikeus 30 päiväksi ja peruutat sitten täyden hyvityksen. Heidän ei-kysytyt peruutuskäytännöt täyttävät sen nimen.

Muistutus

Jos olet kehittämässä lisäosaa Kodille, olethyvin tietoinen ohjelmiston asemasta yleisön silmissä. Kodi itsessään on turvallinen, ja suurin osa sen lisäosista on myös. Internet-palveluntarjoajat ja sisällöntuottajat ajattelevat usein toisin, mikä tarkoittaa hetkestä, kun lähetät jotain Kodissa, tilisi voi olla tarkastuksessa. Ei ole väliä onko lisäosa laillinen vai ei, olet silti vaarassa, että sinut kuristetaan tai tiliäsi seurataan.

Hyvä uutinen on, että virtuaaliset yksityiset verkot ovathelppo tapa voittaa nämä yksityisyyden loukkaukset. VPN: n avulla tietosi salataan ennen kuin ne poistuvat laitteestasi, jolloin kukaan ei voi nähdä millä sivustoilla olet käymässäsi tai mihin Kodi-streamiin käytät. VPN-verkot vaikeuttavat myös henkilöllisyytesi tai sijaintisi löytämistä ja tuovat nimettömyysasteen takaisin verkkoon.

Paras VPN Kodille - IPVanish

IPVanish löytää kaikki oikeat paikat täydelliselle VPN: llekäytä Kodin kanssa. Se on nopea, sillä se tarjoaa yli 950 palvelinta 60 eri maassa, joten voit napata pienen viiveen yhteyden riippumatta siitä, missä asut. Se on myös turvallinen, ja se tarjoaa 256-bittisen AES-salauksen, DNS-vuodonsuojauksen ja automaattisen tappikytkimen kaikille laitteille. Voit myös hyödyntää suurta nollakirjauskäytäntöä liikenteessä ja pystyä lataamaan torrenteja ja P2P-verkon sisältöä täysin nimettömästi. IPVanishin avulla sinun tarvitsee vain suorittaa sovellus ja yhteys on suojattu.

Lisää IPVanish-ominaisuuksia:

• Helppo käyttää Windows-, Mac-, Linux-, Android- ja iOS-sovelluksia.
• Rajoittamaton kaistanleveys ilman nopeusrajoja tai kuristinta.
• Täydellinen, tuntematon käyttöoikeus kaikkiin Kodin lisäosiin.

IPVanish tarjoaa 7 päivän rahat takaisin -takuun, mikä tarkoittaa, että sinulla on viikko testata sitä riskittömästi. Huomatkaa että Addictive Tips -lukijat voivat säästää 60% täällä IPVanish-vuosisuunnitelmassa, laskemalla kuukausittainen hinta vain 4,87 dollariin kuukaudessa.

Ennen kuin aloitat

Aivan kuten mikä tahansa hyvä kehittäjä, teetkintutkimus ennen sukellusta päähän ensin. Lue seuraavat kohdat selvittääksesi mahdolliset väärinkäsitykset, tartu sitten vapaasti sovellusliittymään ja aloita testaus.

Mikä on TV-tietokanta?

Jos olet kehittämässä Kodi-lisäosaa, se on todennäköistäaiot indeksoida merkittävän määrän elokuvien tai TV-ohjelmien sisältöä. Sivustot, jotka tarjoavat suurimman osan näistä tiedostoista, toimittavat yleensä vain videoita, eivät mukana tietoja, jotka auttavat tunnistamaan sisällön. Tiedoston nimi sisältää todennäköisesti ohjelman, kauden ja jakson numeron, mutta entä näyttelijät tai jakson todellinen otsikko? Siinä hakemistotietokannat tulevat peliin.

Kytkemällä Kodi-lisäosa hyvään tietokantaanvoit nimetä ja luokitella helposti kaiken sisällön, jota ohjelmasi käyttää Webistä. Jaksot on helppo lajitella ja etsiä lisäosistasi, ja ne ovat paljon helpompia silmissä indeksointipalvelusta kaapattujen metatietojen ansiosta.

Mitä tietoja tietokanta sisältää?

Tämä voi vaihdella käyttämästäsi palvelusta riippuen, mutta suurin osa hakemistoista keskittyy ydintietojoukkoon, joka sisältää seuraavat:

• Ohjelman koko nimi ja alkuperäinen päivämäärä.
• Jaksojen nimet ja numerot.
• Tyylilajitiedot.
• Tiedot näyttelijöistä, ohjaajista, kirjoittajista jne.
• Box-art, sekä tuulettimien että virallinen.
• Käyttäjien arviot ja arvosteluarvostelut.
• Metatiedot käännetty muille kielille.

Mistä tiedot ovat peräisin?

Erilaisia ​​lähteitä, jotka voivat yllättää. Koska tarkat tiedot ovat tärkeitä, tietokannan kaapimet menevät mahdollisimman lähelle lähdettä. Tämä tarkoittaa yleensä viittaamista virallisiin sivustoihin, kuten Amazon tai IMDB, jotka molemmat saavat näyttelyn otsikot ja niihin liittyvät tiedot itse studioilta. Jos tämä ei onnistu, muut indeksoijat viittaavat sisältöön muiden avoimien seurantalaitteiden kanssa tai luottavat käyttäjien lähettämiin tietoihin julkaisutiedotteiden merkitsemiseksi.

API-avaimet

API on sovellusohjelmointirajapinta. API-avaimet ovat joko pieniä luvatiedostoja tai satunnaistettuja kirjaimia ja numeroita, jotka ohjaavat ohjelman pääsyä tiettyyn palveluun. Jos rakennat sovellusta, jota käytetään esimerkiksi Twitterin kanssa, tarvitset sovellusliittymäavaimen, jotta verkkosivusto antaa sinun koodisi liittyä Twitterin sisältöön. TV-tietokantahakemistojen näppäimet toimivat samalla tavalla. Lisäämällä sovellusliittymäavaimen Kodi-lisäosaan, annat sille tarvittavat käyttöoikeustiedot, jotta se voi vetää tietoja ulkoisesta verkkosivustosta ja käyttää sitä Kodissa.

Mitä tietokantaa käytetään

Indeksointitietokantaa on kelluva useampi kuin yksiympäri maailmaa. Jotkut niistä ovat helpompi käyttää kuin toiset, ja jotkut ovat yksinkertaisesti ajan tasalla kuin kilpailunsa. Alla olevassa oppaassa käsittelemme TheTVDB.com-sovellusliittymän luomisprosessia, joka on avoin tietokanta televisio-faneille. Se on yksi täydellisimmistä resursseista, ja se on helppo asentaa ja ottaa käyttöön.

Ovatko metatietohakemistot laillisia?

He varmasti ovat. Indeksointipalvelut, kuten alla oleva TV-tietokanta, käyttävät vain sisällön sisällönkuvaustietoja, eivät itse tiedostoa. Et voi käyttää niitä minkäänlaiseen suoratoistoon, eivätkä ne millään tavoin edistä piratismia. Heillä on myös yleensä Creative Commons-lisenssi ilmaiseksi jakelua varten. Se on digitaalinen vastine DVD-kokoelmasi järjestämiselle hyllylle. Täysin turvallinen ja 100% laillinen.

TV-tietokannan API-avaimen luominen

Kun olet saanut Kodi-lisäosaprojektisi toimivaan tilaan, voit tarttua API-avaimeen ja alkaa käyttää sitä testaamaan asioita.

Vaihe 1 - Luo tili

Käy TheTVDB: ssä.com ja luo tili palvelulla. Käytä koodauskahvaa tai jopa lisäosan otsikkoa johdonmukaisuuden vuoksi. Kun olet rekisteröitynyt, sinun on kirjauduttava sisään, ja hyväksytä ehdot ja ehdot vierittämällä alas ja napsauttamalla ruutua sivun alaosassa.

Vaihe 2 - Luo avain

Kun sinulla on tili, siirry API-avaimen rekisteröintisivulle. Alaosassa sinun on annettava projektisi nimi yhdessä sen virallisen verkkosivuston kanssa. Napsauta ”Hae API-avain”, kun olet valmis.

Vaihe 3 - Tallenna API-avain

TVTV näyttää avainkoodisi erillisenäsivu. Kopioi tämä turvalliseen paikkaan älä jaa sitä kenellekään muulle, koska se on luotu vain sovelluksellesi. Sinun on viitattava tähän myöhemmin, joten pidä se lähellä.

API-avaimen käyttäminen Kodi-lisäosassa

Kun olet luonut API-avaimen TheTVDB: n taimikä tahansa muu metatietojen indeksointipalvelu, on aika kytkeä se lisäkoodiin varmistaaksesi, että se toimii. Tämä prosessi voi vaihdella riippuen siitä, kuinka olet järjestänyt lisäosan. Käytämme Jen-mallia, laajalti käytettyä menetelmää, jolla yhdistetään jäljittäjät Kodi-lisäosiin.

Vaihe 1 - Lataa Jen-malli

Käy Jen Templaten github -sivulla. Napsauta oikeassa yläkulmassa olevaa vihreää painiketta “klooni tai lataa” ja lataa sitten zip-tiedosto työpöydällesi. Pura se omaan kansioonsa ja valmistaudu sitten muokkaamaan.

Vaihe 2 - Muokkaa Addon.xml-tiedostoa

Vain plugin.videon sisällä.jen-master-kansion, jonka juuri puret., löydät tiedoston nimeltä addon.xml. Avaa tämä koodieditorissa. Sinun on tehtävä muutama muokkaus joihinkin riveihin mukauttaaksesi tietoja mallipohjaan. Aloita täyttämällä tiedoston toisella rivillä olevat tiedot, joihin viitataan alla. Muista käyttää vain kirjaimia ja numeroita, ei välilyöntejä tai epätyypillisiä merkkejä, älä unohda myös asettaa versionumero.

Muokkaa seuraavaksi rivejä 19 ja 21, jotta saat hieman lisätietoja lisäosasta.

Saatat nähdä kaksoisrivejä, jotka viittaavat muihin kieliin. Voit jättää ne yksin tai poistaa ne haluamallasi tavalla.

Tallenna addon.xml-tiedosto, olet muokannut sitä nyt.

Vaihe 3 - Muokkaa Default.py

Tässä aloitamme pääsyn API-avaimeentiedot. Etsi samasta ylimmän tason kansiosta tiedosto nimeltä default.py. Avaa se koodieditorissa ja vieritä sitten alaspäin, kunnes näet alla olevan viivan. Sen pitäisi olla linjan 25 ympärillä.

Aseta TV-tietokannan sovellusliittymäavain yllä osoitettuun kohtaan. Oikealla rivillä on vain kaksi lainausmerkkiä ilman mitään väliin.

Tallenna default.py ja poistu nyt. API-avaimesi on annettu!

Vaihe 4 - Muokkaa asetuksia.xml

Viimeinen muokattava tiedosto, sitten se on palannut testaukseen. Kirjoita resurssikansio, joka sijaitsee laajennuksen työhakemistossa. Avaa koodieditorissa asetukset.xml ja vieritä sitten alaspäin noin riville 27. On muutamia tietoja, jotka meidän on syötettävä tähän, jotta Jen-malli voidaan määrittää loppuun.

Tarkista seuraava rivi tiedoston koodista. Sen tulee näkyä kolme kertaa riveillä 27, 31 ja 36.

Katso missä se sanoo plugin.video.jen? Vaihda tämä samaan laajennuksen nimeen, jonka kirjoitit addon.xml-tiedostoon. Jos kirjoitit esimerkiksi plugin.video.addictivetips, rivi näyttää tältä:

Tallenna tämä tiedosto ja poistu.

Vaihe 5 - Nimeä uudelleen ja testaa

Nyt, kun sovellusliittymä ja mukautustiedot ovat olleetkirjoittaessasi olet valmis kääntämään asiat. Varmista, että kaikki muokkaamasi tiedostot on tallennettu, poistu niistä ja mene takaisin työpöydälle. Kansiolle, jossa työskentelemme, pitäisi olla otsikko jotain tällaista:

Vaihda tämä heijastamaan nimeä, jonka kirjoitit addon.xml-tiedostoon, jota seuraa samaan kohtaan kirjoittamasi versionumero. Yllä olevan esimerkin avulla tiedostolle annetaan nyt nimi:

Se siitä! Olet nyt lisännyt TVDB-sovellusliittymän tiedot lisäosaan ja olet valmis aloittamaan kaavailun metatiedot verkosta.

Muut lisäosien mukautukset

Kun sinulla on Jen-malli ja televisiotietokannan sovellusliittymäavaimesta huolehdittu, miksi et hyppää sisään ja lisää muutama lisää mukauttamisominaisuuksia, jotka auttavat tuotemerkin julkaisemista? Nämä ovat nopeita ja yksinkertaisia ​​vaiheita, jotka voivat viedä paljon matkalla lisäosien tunnistamiseksi entistä paremmin.

Lisää kuvake

Kuvakekuvat näkyvät Kodissa vasemmallanäytön puolella joka kerta, kun lisäosa korostetaan. Yhden lisääminen on helppoa havaita sisältöäsi joutumatta lukemaan otsikoita, mikä voi olla hyödyllisempää kuin luulet! Kuvakkeen käyttämiseksi sinun tarvitsee vain luoda 256 × 256 PNG-tiedosto, mieluiten ilman tekstiä tai Kodi-tuotemerkkiä, ja lisätä se sitten kansioon ylin taso nimeltä icon.png. Se siitä!

Käytä tuulettimen taidetta

Samanlainen kuin yllä oleva kuvake, tuuletintaite on roisketausta, joka näkyy valintitekstin takana Kodissa, kun käyttäjät korostavat sisältöäsi. Tämä voi liittyä kuvakkeesi brändäykseen tai se voi olla jotain teemaa lisäosa-sisältöösi. Jos lisäosa esimerkiksi tuottaa televisio-ohjelmia, luo alkuperäinen faneja kuvaava banneri, jolla on merkkejä How I Met Your Mother. Lisää tämä julkaisuosi tekemällä vain 1280 × 720 JPG-kuva, nimeä se fanart.jpg ja kiinnitä se sitten lisäosan ylimmän tason kansioon.

johtopäätös

Lisäosan kehittäminen voi olla hämmentävä jamonimutkainen prosessi. Yhteisö tarjoaa kuitenkin paljon hyödyllisiä resursseja antaaksesi sinulle käden matkalla. TV-tietokannan sovellusliittymäavaimen lisääminen on vain yksi esimerkki käyttäjän luomasta sisällöstä, joka on valmis liittymään lisäosaasi hyppäämättä läpi kaikenlaisia ​​vanteita, jotta se toimisi. Onko sinulla vinkkejä odovien Kodi-kehittäjien auttamiseen? Jaa tietosi alla olevissa kommenteissa!