Kā izveidot un izmantot TV datu bāzes API atslēgu: Kodi izstrādātāju padomi

Kodi programmatūra ir bezmaksas un atvērtā pirmkoda, kas nozīmē, ka ikviens var pārbaudīt kodu vai pat piedalīties izmaiņās pamatdarbā. Tomēr patiesā Kodi vara ir tās kopiena. Programmatūra tika izstrādāta, lai saskarotos ar lietotāju izveidotiem papildinājumiem, kas nodrošina ļoti daudzveidīgu saturu - lietas, kuras Kodi galvenā komanda nekad nevarētu realizēt viena pati. Tos sauc par neoficiāliem papildinājumiem, un tos ir tik vienkārši izgatavot, ka pēcpusdienā varat sākt pats!

Viens neticami noderīgs pakalpojums, kas tiek sniegts Kodi papildinājumu izstrādātājiem, ir TV datu bāzu indeksētāji, tādas vietnes kā TheTVDB.com vai Trakt. Abi resursi tīmeklī nokasa metadatus un sniedz informāciju sabiedrībai bez maksas. Tas nozīmē, ka varat izveidot papildinājumu, kas atrod dažādus TV šovus, un izmantot TheTVDB, lai tos visus klasificētu, marķētu un kārtotu. Jums nav pašam jāiegūst informācija un nav jāveido savs izsekotājs. Vienkārši paņemiet API atslēgu no TV datu bāzes un pievienojiet to savam papildinājumam, tad tas ir iestatīts. Tālāk sniegtais ceļvedis sniedz informāciju par procesu no sākuma līdz beigām.

Atgādinājums

Ja jūs izstrādājat Kodi papildinājumu, jūs labi zināt, kāda ir programmatūras nostāja sabiedrības acīs. Pats Kodi ir drošs, un tāpat ir arī vairums tā papildinājumu. Interneta pakalpojumu sniedzēji un satura veidotāji bieži domā citādi, kas nozīmē, ka pēc minūtes, kad kaut ko straumējat Kodi, jūsu konts varētu tikt pārbaudīts. Nav svarīgi, vai jūsu pievienojumprogramma ir likumīga vai nē, jūs joprojām riskējat tikt drāzts vai izsekot savam kontam.

Labās ziņas ir tas, ka virtuālie privātie tīkli ir vienkāršs veids, kā novērst šos privātuma pārkāpumus. Izmantojot VPN, jūsu dati tiks šifrēti, pirms tie tiek atstāti no jūsu ierīces, padarot nevienu neiespējamu redzēt, kuras vietnes jūs apmeklējat vai kurām Kodi straumēm jūs piekļūstat. VPN arī apgrūtina jūsu identitātes vai atrašanās vietas atklāšanu, anonimitātes pakāpi atjaunojot tīmeklī.

Labākais Kodi VPN - IPVanish

IPVanishatrod visas pareizās vietas, lai perfektu VPN varētu izmantot kopā ar Kodi. Tas ir ātrs, piedāvājot vairāk nekā 950 serverus 60 dažādās valstīs, lai jūs vienmēr varētu izmantot zema latentuma savienojumu neatkarīgi no dzīvesvietas. Tas ir arī drošs, nodrošinot 256 bitu AES šifrēšanu, DNS noplūdes aizsardzību un automātisku iznīcināšanas slēdzi visām ierīcēm. Jūs arī izmantosit lielisko trafika nulles reģistrēšanas politiku un varēsit lejupielādēt torrentus un P2P tīkla saturu ar pilnu anonimitāti. Izmantojot IPVanish, viss, kas jums jādara, ir palaist lietotni un savienojums ir drošs.

Citas IPVanish iespējas:

• Viegli lietojamas lietotnes operētājsistēmai Windows, Mac, Linux, Android un iOS.
• Neierobežots joslas platums, bez ātruma ierobežojumiem un droseļvārsta.
• Pilnīga, anonīma piekļuve visiem Kodi papildinājumiem.

IPVanish piedāvā 7 dienu naudu atpakaļ garantiju, kas nozīmē, ka jums ir nedēļa, lai to pārbaudītu bez riska. Lūdzu, ņemiet vērā, ka Atkarību padomi, ko lasītāji var ietaupiet milzīgus 60% šeit par IPVanish gada plānu, mēneša cenu samazinot līdz tikai USD 4,87 mēnesī.

Pirms tu sāc

Tāpat kā jebkurš labs izstrādātājs, jūs vispirms veicat pētījumu pirms ieniršanas galvā. Izlasiet šīs sadaļas, lai noskaidrotu iespējamos nepareizos priekšstatus, tad jūtieties brīvi satvert savu API un sākt testēšanu.

Kas ir TV datu bāze?

Ja jūs izstrādājat Kodi papildinājumu, iespējams, plānojat indeksēt ievērojamu daudzumu filmu vai TV šovu satura. Vietnes, kas nodrošina lielāko daļu šo failu, parasti piegādā tikai videoklipus, nevis pievienotos datus, kas palīdz identificēt saturu. Faila nosaukums, iespējams, satur seansu, sezonu un epizodes numuru, bet kā ir ar aktieriem vai epizodes faktisko nosaukumu? Šeit darbojas datu bāzu indeksēšana.

Pieslēdzot savu Kodi papildinājumu labā datu bāzē, jūs varat viegli nosaukt un klasificēt visu saturu, kam jūsu programma piekļūst no tīmekļa. Epizodes būs viegli kārtot un meklēt jūsu papildinājumā, un tās būs daudz vieglāk acīs, pateicoties metadatiem, kas nokasīti no indeksēšanas pakalpojuma.

Kādu informāciju iekļauj datu bāze?

Tas var atšķirties atkarībā no jūsu izmantotā pakalpojuma, taču lielākā daļa indeksētāju koncentrējas uz galveno datu kopu, kurā ietilpst:

• Izrādes pilns nosaukums un oriģinālais datums.
• Epizodu nosaukumi un numuri.
• Informācija par žanru.
• Dati par aktieriem, režisoriem, rakstniekiem utt.
• Boksa māksla, gan fanu veidota, gan oficiāla.
• Lietotāju vērtējumi un kritiķu atsauksmes.
• Metadati tulkoti citās valodās.

No kurienes nāk šī informācija?

Dažādi avoti, kas varētu jūs pārsteigt. Tā kā svarīga ir precīza informācija, datu bāzes skrāpji nonāk pēc iespējas tuvāk avotam. Tas parasti nozīmē atsauces uz oficiālajām vietnēm, piemēram, Amazon vai IMDB, kuras abas iegūst savus šovu nosaukumus un saistīto informāciju no pašām studijām. Ja tas neizdodas, citi indeksētāji salīdzina savu saturu ar citiem atvērtiem izsekotājiem vai paļaujas uz lietotāju iesniegtajiem datiem, lai tagus parādītu izlaidumos.

API atslēgas

API nozīmē lietojumprogrammu programmēšanas saskarni. API atslēgas ir vai nu mazas atļauju datnes, vai arī nejauši izvēlētu burtu un ciparu virknes, kas piešķir programmai piekļuvi noteiktam pakalpojumam. Ja veidojat lietotni, piemēram, ar čivināt, jums ir nepieciešama API atslēga, lai vietne ļautu jūsu kodam saskarties ar Twitter saturu. TV datu bāzu indeksu atslēgas darbojas vienādi. Pievienojot Kodi papildinājumam API atslēgu, jūs piešķirat tai nepieciešamos akreditācijas datus, lai iegūtu datus no ārējās vietnes un izmantotu tos Kodi ietvaros.

Kādu datu bāzi izmantot

Visā tīmeklī ir vairāk nekā viena indeksēšanas datu bāze. Dažus no tiem ir vieglāk izmantot nekā citus, un citi ir vienkārši modernāki nekā viņu konkurence. Turpmāk sniegtajā rokasgrāmatā mēs aplūkosim API izveides procesu vietnei TheTVDB.com, kas ir atvērta datu bāze televīzijas faniem. Tas ir viens no pilnīgākajiem resursiem, un to ir viegli uzstādīt un izvietot.

Vai metadatu indeksi ir likumīgi?

Tie noteikti ir. Indeksēšanas pakalpojumi, piemēram, TV datu bāze, kuru mēs izmantosim zemāk, piekļūst tikai metadatiem, kas ieskauj satura daļu, nevis pašam failam. Jūs tos nevarat izmantot, lai straumētu neko, kā arī viņi nekādā veidā neveicina pirātismu. Parasti tie tiek licencēti saskaņā ar Creative Commons bezmaksas izplatīšanai. Tas ir digitālais ekvivalents DVD kolekcijas organizēšanai plauktā. Pilnīgi drošs un 100% likumīgs.

TV datu bāzes API atslēgas izveidošana

Kad esat ieguvis savu Kodi papildprojektu darba stāvoklī, varat paķert API atslēgu un sākt to izmantot, lai pārbaudītu lietas.

1. solis - izveidojiet kontu

Apmeklējums Vietne TheTVDB.com un izveidojiet kontu pakalpojumā. Izmantojiet kodēšanas rokturi vai pat papildinājuma virsrakstu, lai nodrošinātu konsekvenci. Kad esat reģistrējies, jums būs jāpiesakās, tad piekrītiet noteikumiem un nosacījumiem, ritinot uz leju un atzīmējot rūtiņu lapas apakšā.

2. solis - ģenerējiet atslēgu

Kad jums ir konts, dodieties uz API atslēgas reģistrācijas lapa. Apakšā jums būs jāievada projekta nosaukums kopā ar tā oficiālo vietni. Kad esat pabeidzis, noklikšķiniet uz “Izgūt API atslēgu”.

3. solis - saglabājiet API atslēgu

TVTV parādīs jūsu atslēgas kodu atsevišķā lapā. Kopējiet to kaut kur drošā vietā un nedaliet to nevienam citam, jo ​​tas tika izveidots tikai jūsu lietojumprogrammai. Par to jums vajadzēs atsaukties vēlāk, tāpēc turiet to tuvumā.

API atslēgas izmantošana jūsu Kodi papildinājumā

Kad esat ģenerējis API atslēgu ar TheTVDB vai jebkuru citu metadatu indeksēšanas pakalpojumu, ir pienācis laiks to iespraust papildinājuma kodā, lai pārliecinātos, ka tas darbojas. Šis process var atšķirties atkarībā no tā, kā esat strukturējis savu papildinājumu. Mēs izmantosim Jen veidni, plaši izmantotu metodi, lai apvienotu izsekotājus ar Kodi papildinājumiem.

1. solis - lejupielādējiet Jen veidni

Apmeklējiet vietni Džena veidnes vietne. Noklikšķiniet uz zaļās pogas augšējā labajā stūrī, kas saka “klonēt vai lejupielādēt”, un pēc tam lejupielādējiet zip failu uz darbvirsmas. Izvelciet to savā mapē, pēc tam sagatavojieties rediģēšanai.

2. solis - rediģēt Addon.xml

Tieši mapē plugin.video.jen-master, kuru tikko esat izspraužis, atradīsit failu ar nosaukumu addon.xml. Atveriet to koda redaktorā. Lai pielāgotu datus, uz kuriem attiecas veidnes, jums būs jāveic daži labojumi dažās rindās. Sākumā aizpildiet informāciju faila otrajā rindā, kas norādīta zemāk. Atcerieties izmantot tikai burtus un ciparus, bez atstarpēm vai nestandarta rakstzīmēm un neaizmirstiet iestatīt arī versijas numuru.

Pēc tam rediģējiet 19. un 21. rindu, lai sniegtu nedaudz vairāk informācijas par savu papildinājumu.

PAPILDINĀJUMA KOPSAVILKUMS

ILGĀKAS PAPILDINĀJUMA APRAKSTS

Var tikt parādītas rindu dublikāti, kas atsaucas uz citām valodām. Jūs varat atstāt tos vienus vai noņemt tos pēc saviem ieskatiem.

Saglabājiet failu addon.xml, un jūs to jau esat rediģējis.

3. solis - rediģēt noklusējuma.py

Šeit mēs sākam iedziļināties API galvenajā informācijā. Tajā pašā augšējā līmeņa mapē atrodiet failu ar nosaukumu default.py. Atveriet to koda redaktorā, pēc tam ritiniet uz leju, līdz redzat zemāk norādīto līniju. Tam vajadzētu būt ap 25. līniju.

__builtin __. tvdb_api_key = “PASTE API KEY HERE” # tvdb api taustiņš

Ievietojiet TV datu bāzes API atslēgu, kur norādīts iepriekš. Faktiskajā rindā būs tikai divas pēdiņas, starp kurām nav nekā.

Saglabājiet default.py un izejiet pagaidām. Jūsu API atslēga ir ievadīta.

4. solis - rediģējiet iestatījumus.xml

Pēdējais rediģējamais fails tiks atjaunots testēšanai. Ievadiet resursu mapi, kas atrodas spraudņa darba direktorijā. Kodu redaktorā atveriet settings.xml un pēc tam ritiniet uz leju līdz apmēram 27. rindai. Ir daži informācijas veidi, kas mums šeit būs jāievada, lai pabeigtu Jen veidnes iestatīšanu.

Pārbaudiet, vai faila kodā ir šāda rinda. Tam vajadzētu parādīties trīs reizes 27., 31. un 36. rindā.

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

Skatiet, kur teikts spraudnis.video.jen? Mainiet to uz to pašu spraudņa nosaukumu, kuru ievadījāt failā addon.xml. Ja, piemēram, ievadījāt spraudni.video.addictivetips, rinda izskatās šādi:

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

Saglabājiet šo failu un izejiet.

5. solis - pārdēvēt un pārbaudīt

Tagad, kad ir ievadīti API un pielāgošanas dati, jūs esat gatavs visu apkopot. Pārliecinieties, vai visi rediģētie faili ir saglabāti, pēc tam izejiet no tiem un dodieties atpakaļ uz darbvirsmu. Mapei, kurā mēs strādājam, vajadzētu būt nosauktai apmēram šādi:

spraudnis.video.jen-meistars

Mainiet to, lai atspoguļotu vārdu, kuru ievadījāt failā addon.xml, kam seko versijas numurs, kuru ievadījāt tajā pašā sadaļā. Izmantojot mūsu iepriekš minēto piemēru, fails tagad tiks nosaukts šādi:

spraudnis.video.addictivetips.0.1.zip

Tieši tā! Jūs tagad pievienojāt TVDB API datus papildinājumam un esat gatavs sākt nokasīt metadatus no tīmekļa.

Citi papildinājumu pielāgojumi

Kad esat parūpējies par Jen veidni un TV datu bāzes API atslēgu, kāpēc gan neiedziļināties un pievienot vēl dažas pielāgošanas funkcijas, lai palīdzētu jūsu izlaiduma zīmēšanai? Šīs ir ātras un vienkāršas darbības, kuras var veikt tālu, lai papildinājumu padarītu atpazīstamāku.

Pievienojiet ikonu

Ikonu attēli tiek parādīti Kodi ekrāna kreisajā pusē katru reizi, kad tiek uzsvērts jūsu papildinājums. Pievienojot to, ir viegli pamanīt savu saturu, nelasot nosaukumus, un tas var būt noderīgāk, nekā jūs domājat! Lai izmantotu ikonu, viss, kas jums jādara, ir izveidot 256 × 256 PNG failu, vēlams, bez teksta vai Kodi zīmola, pēc tam pievienojiet to mapes augšējā līmenī ar nosaukumu icon.png. Tieši tā!

Izmantojiet Fan Art

Līdzīgi kā iepriekš redzamajā ikonā, fanu māksla ir fona attēls, kas parādās aiz atlases teksta Kodi ikreiz, kad lietotāji izceļ jūsu saturu. Tas var būt saistīts ar jūsu ikonas zīmolu vai arī tas var būt saistīts ar jūsu papildinājuma saturu. Piemēram, ja spraudnis nodrošina TV šovus, izveidojiet oriģinālu fanu mākslas reklāmkarogu ar varoņiem no filmas How I Met Your Mother. Lai to pievienotu savai izlaišanai, vienkārši izveidojiet 1280 × 720 JPG attēlu, nosauciet to fanart.jpg un pēc tam pielīmējiet to papildinājuma augšējā līmeņa mapē.

Secinājums

Papildinājuma izstrāde var būt mulsinošs un sarežģīts process. Kopiena tomēr sniedz ļoti daudz noderīgu resursu, lai jūs varētu sniegt visu nepieciešamo. Televīzijas datu bāzes API atslēgas pievienošana ir tikai viens piemērs lietotāju veidotam saturam, kas ir gatavs saskarnei ar jūsu papildinājumu, neizlecot cauri visa veida stīpām, lai tā darbotos. Vai jums ir kādi padomi, kā palīdzēt Kodi izstrādātājiem? Dalieties savās zināšanās zemāk esošajos komentāros!