Teleri andmebaasi API võtme loomine ja kasutamine: Kodi arendaja näpunäited

Kodi tarkvara on tasuta ja avatud lähtekoodiga, see tähendab, et kõigil on võimalik koodi vaadata või isegi põhitööpõhimõtteid muuta. Kodi tegelik jõud on selle kogukond. Tarkvara oli loodud liidestamiseks kasutaja loodud lisandmoodulitega, mis pakuvad tohutult mitmekesist sisu - asju, mida Kodi tuumikmeeskond kunagi iseseisvalt rakendada ei saaks. Neid nimetatakse mitteametlikeks lisandmooduliteks ja neid on nii lihtne teha, et saate oma õhtupooliku alustada!

Üks uskumatult kasulik teenus, mida Kodi lisandmoodulite arendajatele osutatakse, on telekanalite andmebaasid, saidid nagu TheTVDB.com või Trakt. Mõlemad ressursid kraapivad metaandmeid kogu veebist ja pakuvad teavet üldsusele tasuta. See tähendab, et saate luua lisandmooduli, mis leiab erinevaid telesaateid, ja kasutada neidTV kategoriseerimiseks, sildistamiseks ja sortimiseks TheTVDB abil. Teil pole vaja teavet ise hankida ega oma jälgijaid üles ehitada. Haarake lihtsalt teleri andmebaasist API-võti ja ühendage see lisandmooduliga. Meie allolev juhend tutvustab teid protsessi algusest lõpuni.

Meeldetuletus

Kui töötate välja Kodi jaoks lisandmooduli, olete hästi kursis tarkvara positsiooniga avalikkuse silmis. Kodi ise on turvaline ja ka enamik selle lisandmoodulitest. Interneti-teenuse pakkujad ja sisuloojad arvavad sageli teisiti, mis tähendab, et kui Kodi kaudu midagi voogesitate, võib teie konto olla kontrollitud. Pole tähtis, kas teie lisandmoodul on seaduslik või mitte, teil on endiselt oht, et teid segatakse või kontot jälgitakse.

Hea uudis on see, et virtuaalsed privaatvõrgud on lihtne viis nende privaatsuse rikkumiste vastu võitlemiseks. VPN-iga krüptitakse teie andmed enne teie seadmest lahkumist, muutes kellelgi võimatuks näha, milliseid saite külastate või milliseid Kodi voogesitusi kasutate. VPN-id raskendavad ka teie identiteedi või asukoha tuvastamist, tuues anonüümsuse mõõdupuu tagasi veebis.

Kodi parim VPN - IPVanish

IPVanishtabab kõik õiged kohad, et täiuslikku VPN-i saaks Kodi abil kasutada. See on kiire, pakkudes üle 950 serveri 60 erinevas riigis, nii et saate alati madala latentsusajaga ühenduse hoolimata oma asukohast. See on ka turvaline, pakkudes kõigi seadmete jaoks 256-bitist AES-krüptimist, DNS-i lekkekaitset ja automaatset tapmislülitit. Samuti saate kasutada liikluse suurt nullimislogimise eeskirja ja saate alla laadida torrente ja P2P-võrgu sisu täieliku anonüümsusega. IPVanishi abil peate vaid käivitama rakenduse ja teie ühendus on turvaline.

Veel IPVanishi funktsioone:

• Lihtne kasutada Windowsi, Maci, Linuxi, Androidi ja iOS-i rakendusi.
• Piiramatu ribalaius ilma kiiruspiirikute ja drosselklapita.
• Täielik ja anonüümne juurdepääs kõigile Kodi pistikprogrammidele.

IPVanish pakub 7-päevast raha tagasi garantii, mis tähendab, et teil on nädal aega riskivaba testimiseks. Pange tähele, et Sõltuvusnäpunäited, mida lugejad saavad säästa siin tohutult 60% IPVanishi aastaplaani kohta, langetades kuuhinna vaid 4,87 dollarini kuus.

Enne alustamist

Nagu iga hea arendaja, teete ka enne sukeldumist oma uurimistööd. Võimalike väärarusaamade selgitamiseks lugege järgmisi jaotisi, seejärel haarake julgelt oma API ja alustage testimist.

Mis on telerite andmebaas?

Kui töötate välja Kodi pistikprogrammi, on tõenäoline, et kavatsete märkimisväärses koguses filmi või telesaate sisu indekseerida. Saidid, mis pakuvad enamikku neist failidest, edastavad tavaliselt ainult videoid, mitte lisaandmeid, mis aitavad sisu tuvastada. Faili nimi sisaldab tõenäoliselt saate, hooaja ja episoodi numbrit, aga kuidas on näitlejate või episoodi tegeliku pealkirjaga? Seal saavad hakkama andmebaaside indekseerimine.

Ühendades Kodi lisandmooduli heasse andmebaasi, saate hõlpsalt nimetada ja kategoriseerida kogu sisu, millele teie programm veebist pääseb. Episoode on teie lisandmoodulil lihtne sorteerida ja otsida ning tänu indekseerimisteenusest kraapitud metaandmetele on need silmis palju lihtsamad.

Millist teavet andmebaas sisaldab?

See võib varieeruda sõltuvalt kasutatavast teenusest, kuid enamik indekseerijaid keskendub põhiandmekogumile, mis sisaldab järgmist:

• Saate täielik pealkiri ja originaalkuupäev.
• Jagude nimed ja numbrid.
• Žanriteave.
• Andmed näitlejate, lavastajate, kirjanike jne kohta
• Karbikunst, nii fännide tehtud kui ka ametlik.
• Kasutajate hinnangud ja kriitikute arvustuste hinded.
• Metaandmed tõlgitud teistesse keeltesse.

Kust teave pärineb?

Erinevad allikad, mis võivad teid üllatada. Kuna täpne teave on oluline, lähevad andmebaasi skreeperid allikale võimalikult lähedale. Tavaliselt tähendab see viitamist ametlikele saitidele nagu Amazon või IMDB, mis mõlemad saavad oma saate pealkirjad ja sellega seotud teabe stuudiotelt endilt. Kui seda ei tehta, viitavad teised indekseerijad oma sisule teiste avatud jälgijatega või loodavad väljalasete sildistamiseks kasutajate esitatud andmetele.

API võtmed

API tähistab rakenduste programmeerimisliidest. API võtmed on kas väikesed loendifailid või juhuslike tähtede ja numbrite jadad, mis suurendavad programmi juurdepääsu konkreetsele teenusele. Kui loote näiteks rakenduse Twitteriga kasutamiseks, vajate API-võtit, nii et veebisait võimaldab teie koodil liituda Twitteri sisuga. Teleri andmebaaside registrite võtmed töötavad enam-vähem samal viisil. Kui lisate oma Kodi lisandmoodulile API-võtme, annate sellele mandaadi, mida ta vajab väliselt veebisaidilt andmete kogumiseks ja Kodi sees kasutamiseks.

Millist andmebaasi kasutada

Internetis hõljub rohkem kui üks indekseerimise andmebaas. Mõnda neist on lihtsamini kasutada kui teisi ja mõned on lihtsalt konkurentsi poolest ajakohasemad. Alloleva juhendi all käsitleme API loomisprotsessi saidil TheTVDB.com, mis on telefännide jaoks avatud andmebaas. See on üks täielikumaid ressursse ning seda on lihtne seadistada ja juurutada.

Kas metaandmete indeksid on seaduslikud?

Nad kindlasti on. Indekseerimisteenused, näiteks teleriandmebaas, mida me allpool kasutame, saavad juurdepääsu ainult sisut ümbritsevatele metaandmetele, mitte failile endale. Te ei saa neid kasutada millegi voogesitamiseks ega ka mingil viisil piraatlusele kaasa aidata. Neil on tavaliselt ka Creative Commonsi tasuta levitamise litsents. See on teie DVD-kollektsiooni riiulil korraldamise digitaalne ekvivalent. Täiesti ohutu ja 100% seaduslik.

Teleriandmebaasi API võtme loomine

Kui olete Kodi lisandmooduli projekti töökorras, saate haarata API-võtme ja hakata seda asjade testimiseks kasutama.

1. samm - looge konto

Külasta TheTVDB.com ja looge teenusega konto. Järjepidevuse tagamiseks kasutage oma kodeerimiskäepidet või isegi lisandmooduli pealkirja. Kui olete registreerunud, peate sisse logima, siis nõustuge tingimustega, kerides alla ja märkides ruutu lehe allosas.

2. samm - genereerige võti

Kui teil on konto, minge aadressile API võtme registreerimise leht. Allosas peate sisestama oma projekti nime koos selle ametliku veebisaidiga. Kui olete lõpetanud, klõpsake nuppu „Tooge API-võti”.

3. samm - salvestage API-võti

TVTV kuvab teie võtmekoodi eraldi lehel. Kopeerige see kuskile turvaliselt ja ärge jagage seda kellegi teisega, kuna see loodi just teie rakenduse jaoks. Peate sellele hiljem viitama, nii et hoidke seda läheduses.

API-võtme kasutamine oma Kodi pistikprogrammis

Kui olete koos TheTVDB või mõne muu metaandmete indekseerimise teenusega API-võtme genereerinud, on aeg see oma lisakoodile ühendada ja veenduda, et see töötab. See protsess võib varieeruda sõltuvalt sellest, kuidas olete oma lisaseadme struktureerinud. Kasutame Jen-malli, mis on laialt levinud meetod jälitajate ühendamiseks Kodi lisandmoodulitega.

1. samm - laadige alla Jeni mall

Külastage Jen Template'i leht. Klõpsake paremas ülanurgas rohelisel nupul, mis ütleb „kloonige või laadige alla“, ja laadige siis ZIP-fail alla oma töölauale. Kaevandage see oma kausta ja tehke siis valmis mõnda redigeerimist tegema.

2. samm - muutke Addon.xml

Lihtsalt lahti pakitud kausta plugin.video.jen-master sees leiate faili nimega addon.xml. Avage see oma koodiredaktoris. Malli viidete andmete kohandamiseks peate mõnda rida muutma. Alustage teabe täitmisega faili teises reas, millele viidatakse allpool. Ärge unustage kasutada ainult tähti ja numbreid, tühikuid ega mittestandardseid tähti ja ärge unustage määrata ka versiooni number.

Järgmisena muutke ridu 19 ja 21, et anda oma lisandmooduli kohta pisut lisateavet.

LISAKOKKUVÕTE

PIKAAJALISE LISANDI KIRJELDUS

Võite näha duplikaate, mis viitavad teistele keeltele. Võite jätta need üksi või eemaldada vastavalt vajadusele.

Salvestage fail addon.xml, nüüd olete selle redigeerimise lõpetanud.

3. samm - muutke vaikimisi.py

Siit hakkame tundma API põhiteavet. Otsige samas tipptasemel kaustas faili nimega default.py. Avage see oma koodiredaktoris ja kerige alla, kuni näete allpool viidatud rida. See peaks olema umbes 25. rida.

__builtin __. tvdb_api_key = “PASTE API KEY HERE” # tvdb api võti

Sisestage teleri andmebaasi API-võti ülaltoodud viisil. Tegelikul real on lihtsalt kaks jutumärki, mille vahel pole midagi.

Salvestage default.py ja väljuge nüüd. Teie API-võti on sisestatud!

4. samm - muutke seadeid.xml

Viimane redigeeritav fail, siis on see tagasi testimise juurde. Sisestage ressursside kaust, mis asub pistikprogrammi töökataloogis. Avage koodiredaktoris settings.xml ja kerige seejärel alla umbes 27. rida. Jeni malli seadistamise lõpuleviimiseks peame siia sisestama mõned andmed.

Kontrollige faili koodis järgmist rida. See peaks ilmuma kolm korda ridadel 27, 31 ja 36.

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

Vaadake, kus see öeldakse plugin.video.jen? Muutke see sama pistikprogrammi nimega, mille sisestasite failis addon.xml. Kui sisestasite näiteks plugin.video.addictivetips, näeks rida välja selline:

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

Salvestage see fail ja väljuge.

5. samm - nimetage ümber ja testige

Nüüd, kui API ja kohandamisandmed on sisestatud, olete valmis asju kokku pakkima. Veenduge, et kõik redigeeritud failid oleks salvestatud, siis väljuge neist ja minge tagasi töölauale. Kaust, milles me töötame, peaks olema pealkirjastatud umbes nii:

plugin.video.jen-master

Muutke seda nii, et see kajastaks faili addon.xml sisestatud nime, millele järgneb samas jaotises sisestatud versiooni number. Meie ülaltoodud näite järgi saaks fail nüüd nimeks see:

plugin.video.addictivetips.0.1.zip

See selleks! Olete nüüd TVDB API andmed lisandmoodulisse lisanud ja olete valmis alustama veebist metaandmete kraapimist.

Muud lisandmoodulite kohandamised

Kui olete Jen-malli ja telerite andmebaasi API-võtme eest hoolitsenud, siis miks mitte hüpata sisse ja lisada veel mõned kohandamisfunktsioonid, mis aitavad teie väljaannet brändida? Need on kiired ja lihtsad toimingud, mille abil saate oma lisandmooduli paremini äratuntavaks teha.

Lisage ikoon

Ikoonipilte kuvatakse Kodis ekraani vasakus servas iga kord, kui teie lisandmoodul esile tõstetakse. Kui lisate ühe, saate sisu hõlpsalt märgata ilma pealkirju lugemata, mis võib olla kasulikum, kui arvate! Ikooni kasutamiseks peate looma vaid 256 × 256 PNG-faili, eelistatavalt ilma teksti või Kodi-brändita, ja seejärel lisage see oma kausta ülatasandile nimega icon.png. See selleks!

Kasutage fännikunsti

Sarnaselt ülaltoodud ikooniga on fännikujundus ka prinditaust, mis kuvatakse Kodis valiku teksti taga alati, kui kasutajad teie sisu esile tõstavad. See võib olla seotud teie ikooni kaubamärgiga või teie pistikprogrammi sisuga. Näiteks kui pistikprogramm edastab telesaateid, looge originaalne fännikunstniku riba, mille peategelased on saidil Kuidas ma kohtasin oma ema. Selle väljalasele lisamiseks tehke lihtsalt 1280 × 720 JPG pilt, pange sellele nimi fanart.jpg ja kleepige see oma lisandmooduli ülemise taseme kausta.

Järeldus

Lisandmooduli väljatöötamine võib olla segane ja keeruline protsess. Kogukond pakub palju kasulikke ressursse, et anda teile siiski võimalus selle saavutamiseks. Teleribaasi andmebaasi API-võtme lisamine on vaid üks näide kasutaja loodud sisust, mis on valmis teie lisandmooduliga liidestama, ilma et peaks hüppama läbi igasuguste kõvade, et see toimiks. Kas teil on näpunäiteid lootustandvate Kodi arendajate abistamiseks? Jagage oma teadmisi allolevates kommentaarides!