Jak vytvořit a používat klíč TV Database API: Tipy pro vývojáře Kodi

Software Kodi je bezplatný a open-source,což znamená, že si každý může prohlédnout kód nebo dokonce přispět ke změnám v základních funkcích. Skutečnou silou, která stojí za Kodi, je její komunita. Tento software byl navržen tak, aby byl propojen s uživatelskými doplňky, které poskytují obrovskou škálu obsahu, což by hlavní tým společnosti Kodi nikdy nemohl implementovat sám. Tyto doplňky se nazývají neoficiální doplňky a jejich výroba je tak snadná, můžete začít svůj vlastní odpoledne!

Jedna neuvěřitelně užitečná služba poskytovaná společnosti Kodivývojáři doplňků jsou indexátory televizních databází, weby jako TheTVDB.com nebo Trakt. Oba zdroje škrábají metadata z celého webu a poskytují informace veřejnosti zdarma. To znamená, že můžete vytvořit doplněk, který najde různé televizní pořady a použít TheTVDB k jejich kategorizaci, označení a třídění. Není třeba získávat informace sami a není třeba vytvářet si vlastní tracker. Jednoduše uchopte klíč API z televizní databáze a zapojte jej do svého doplňku, poté je nastaveno. Náš průvodce níže vás provede procesem od začátku do konce.

Exkluzivní nabídka: Ušetřete 49%. Vyzkoušejte ExpressVPN bez rizika!

Získejte VPN s hodnocením # 1

30denní záruka vrácení peněz

How to get a FREE VPN for 30 days

Pokud potřebujete VPN pro krátkou chvíli při cestování například, můžete získat naše top zařadil VPN zdarma. ExpressVPN obsahuje 30denní záruku vrácení peněz. Budete muset zaplatit za předplatné, to je fakt, ale to umožňuje plný přístup po dobu 30 dnů a pak zrušíte pro plnou náhradu. Jejich ne-otázky-kladené Storno politika žije až do svého jména.

Připomínka

Pokud vyvíjíte doplněk pro Kodi, jstedobře si uvědomují pozici softwaru v očích veřejnosti. Samotný Kodi je bezpečný a většina jeho doplňků je také. Poskytovatelé internetových služeb a tvůrci obsahu často myslí jinak, což znamená, že v okamžiku, kdy něco přenesete na Kodi, může být váš účet pod kontrolou. Nezáleží na tom, zda je váš doplněk legitimní nebo ne, stále vám hrozí škrtnutí nebo sledování vašeho účtu.

Dobrou zprávou je, že virtuální soukromé sítě jsousnadný způsob, jak porazit tyto invaze do soukromí. Díky síti VPN budou vaše data před opuštěním zařízení šifrována, takže nikomu nebude možné zjistit, které weby navštěvujete nebo ke kterým streamům Kodi přistupujete. Sítě VPN také ztěžují odhalení vaší identity nebo umístění, čímž se do celosvětového webu vrátí míra anonymity.

Nejlepší VPN pro Kodi - IPVanish

IPVanish zasáhne všechna správná místa pro perfektní VPNpoužít s Kodi. Je to rychlé a nabízí více než 950 serverů v 60 různých zemích, takže můžete vždy nabít připojení s nízkou latencí bez ohledu na to, kde žijete. Je také bezpečný a poskytuje 256bitové šifrování AES, ochranu proti úniku DNS a automatický přepínač zabíjení pro všechna zařízení. Využijete také skvělou politiku nulování protokolování provozu a budete moci stahovat torrenty a síťový obsah P2P s plnou anonymitou. S IPVanish vše, co musíte udělat, je spustit aplikaci a vaše připojení je zabezpečené.

Další funkce IPVanish:

• Snadno použitelné aplikace pro Windows, Mac, Linux, Android a iOS.
• Neomezená šířka pásma bez omezení rychlosti nebo škrcení.
• Úplný anonymní přístup ke všem doplňkům společnosti Kodi.

IPVanish nabízí 7denní záruku vrácení peněz, což znamená, že máte týden na testování bez rizika. Vezměte prosím na vědomí, že Čtenáři Návykových tipů mohou ušetřit až 60% zde na ročním plánu IPVanish, přičemž měsíční cena klesla na pouhých 4,87 $ / měsíc.

Než začnete

Stejně jako každý dobrý vývojář i vyvýzkum před potápěním v hlavě první. Přečtěte si následující oddíly, abyste vyjasnili všechny mylné představy, které byste mohli mít, a pak neváhejte popadnout své API a zahájit testování.

Co je to televizní databáze?

Pokud vyvíjíte doplněk Kodi, je to pravděpodobnémáte v plánu indexovat značné množství obsahu filmu nebo televizního pořadu. Weby, které poskytují většinu těchto souborů, obvykle dodávají pouze videa, nikoli doprovodná data, která pomáhají identifikovat obsah. Název souboru pravděpodobně obsahuje pořad, sezónu a číslo epizody, ale co herci nebo skutečný název epizody? To je místo, kde začínají hrát indexovací databáze.

Připojením doplňku Kodi do dobré databázemůžete snadno pojmenovat a roztřídit veškerý obsah, ke kterému program přistupuje z webu. Epizody bude možné snadno třídit a vyhledávat ve vašem doplňku a díky metadatům vyškrtnutým z indexovací služby budou na očích mnohem snazší.

Jaké informace obsahuje databáze?

To se může lišit v závislosti na službě, kterou používáte, ale většina indexátorů se zaměřuje na základní sadu dat, která zahrnují následující:

• Kompletní název show a původní datum vysílání.
• Názvy a čísla epizod.
• Žánrové informace.
• Údaje o hercích, režisérech, spisovatelích atd.
• Box art, jak fanoušek, tak i oficiální.
• Hodnocení uživatelů a hodnocení kritiků.
• Metadata přeložena do jiných jazyků.

Odkud pocházejí informace?

Různé zdroje, které vás mohou překvapit. Protože jsou důležité přesné informace, jsou škrabky databáze co nejblíže ke zdroji. To obvykle znamená odkazovat na oficiální weby, jako je Amazon nebo IMDB, které získají své výstavní tituly a související informace ze studií samotných. V opačném případě ostatní indexátoři kříží svůj obsah s jinými otevřenými sledovacími zařízeními nebo spoléhají na data odeslaná uživatelem při vydávání značkových show.

API Keys

API znamená rozhraní pro programování aplikací. Klíče API jsou buď malé soubory oprávnění, nebo řetězce náhodných písmen a čísel, které určují přístup programu ke konkrétní službě. Pokud například sestavujete aplikaci, kterou chcete používat se službou Twitter, potřebujete klíč API, aby web umožnil rozhraní vašeho kódu s obsahem Twitteru. Klávesy pro indexy televizních databází fungují téměř stejným způsobem. Přidáním klíče API do svého doplňku Kodi udělujete pověření, které potřebuje k načtení dat z externího webu a použití v Kodi.

Kterou databázi použít

Existuje více než jedna databáze indexování plovoucípo celém světě. Některé z nich se snadněji používají než jiné a některé jsou prostě aktuálnější než jejich konkurence. V níže uvedeném průvodci se budeme zabývat procesem vytváření rozhraní API pro TheTVDB.com, což je otevřená databáze pro televizní fanoušky. Je to jeden z úplnějších zdrojů a lze jej snadno nastavit a nasadit.

Jsou indexy metadat legální?

Určitě ano. Indexovací služby, jako je televizní databáze, kterou budeme používat níže, mají přístup pouze k metadatům obklopujícím určitý obsah, nikoli k samotnému souboru. Nemůžete je použít k ničemu streamování, ani nijak nepřispívají k pirátství. Obvykle jsou také licencovány podle Creative Commons pro bezplatnou distribuci. Je to digitální ekvivalent organizace vaší sbírky DVD na polici. Zcela bezpečné a 100% legální.

Vytvoření klíče TV Database API

Jakmile váš doplněk Kodi uvedete do funkčního stavu, můžete chytit klíč API a začít jej používat k testování věcí.

Krok 1 - Vytvořte si účet

Navštivte TheTVDB.com a vytvořte si účet se službou. Pro zajištění konzistence použijte popisovač kódu nebo dokonce název doplňku. Jakmile se zaregistrujete, budete se muset přihlásit a poté souhlasit s podmínkami posouváním dolů a zaškrtnutím políčka v dolní části stránky.

Krok 2 - Vygenerujte klíč

Jakmile máte účet, přejděte na stránku registrace klíče API. V dolní části musíte zadat název projektu spolu s oficiálním webem. Až budete hotovi, klikněte na „Získat klíč API“.

Krok 3 - Uložte klíč API

TheTVDB zobrazí váš kód klíče na samostatnémstránka. Zkopírujte to někde bezpečně a nesdílejte to s nikým jiným, protože bylo vygenerováno pouze pro vaši aplikaci. Budete se o tom muset později zmínit, takže mějte na dosah.

Použití klíče API v doplňku Kodi

Jakmile vygenerujete klíč API s TheTVDB nebojakékoli jiné služby indexování metadat, je čas ji připojit do doplňkového kódu, aby se zajistilo, že funguje. Tento proces se může lišit v závislosti na struktuře vašeho doplňku. Budeme používat Jen šablonu, široce používanou metodu kombinování sledovačů s doplňky Kodi.

Krok 1 - Stáhněte si Jen šablonu

Navštivte stránku githubu Jen Template. Klikněte na zelené tlačítko v pravém horním rohu s nápisem „klonovat nebo stáhnout“ a stáhněte si soubor zip na plochu. Rozbalte jej do své vlastní složky a poté se připravte na úpravy.

Krok 2 - Upravit Addon.xml

Jen uvnitř pluginu.video.složka jen-master, kterou jste právě rozbalili, najdete soubor s názvem addon.xml. Otevřete to v editoru kódu. Chcete-li přizpůsobit údaje, na které odkazuje šablona, ​​musíte provést několik úprav na některých řádcích. Začněte vyplněním informací do druhého řádku souboru, na který se odkazuje níže. Nezapomeňte použít pouze písmena a číslice, žádné mezery nebo nestandardní znaky a nezapomeňte také nastavit číslo verze.

Dále upravte řádky 19 a 21 a poskytněte trochu více informací o vašem doplňku.

Můžete vidět duplicitní řádky odkazující na jiné jazyky. Můžete je nechat na pokoji nebo je odstranit, jak uznáte za vhodné.

Uložte soubor addon.xml, dokončili jste úpravy.

Krok 3 - Upravit Default.py

Zde začínáme vstupovat do klíče APIinformace. Ve stejné složce nejvyšší úrovně vyhledejte soubor s názvem default.py. Otevřete jej v editoru kódu a poté přejděte dolů, dokud neuvidíte řádek uvedený níže. Mělo by to být kolem řádku 25.

Vložte klíč API vaší televizní databáze tam, kde je uvedeno výše. Skutečný řádek bude mít pouze dvě uvozovky bez meziprostoru.

Uložte default.py a ukončete prozatím. Váš klíč API byl zadán!

Krok 4 - Upravit nastavení.xml

Jeden poslední soubor, který chcete upravit, je zpět k testování. Zadejte složku prostředků umístěnou v pracovním adresáři pluginu. Otevřete settings.xml v editoru kódu a poté přejděte dolů na řádek 27. K dokončení nastavení Jen šablony je třeba zadat několik informací, abychom sem dokončili nastavení.

V kódu souboru zkontrolujte následující řádek. Měl by se objevit třikrát na řádcích 27, 31 a 36.

Podívejte se, kde to říká plugin.video.jen? Změňte to na stejný název pluginu, který jste zadali v souboru addon.xml. Pokud například zadáte plugin.video.addictivetips, bude řádek vypadat takto:

Uložte tento soubor a ukončete.

Krok 5 - Přejmenování a testování

Nyní, když API a data přizpůsobení bylazadáno, jste připraveni zabalit věci. Ujistěte se, že jsou uloženy všechny editované soubory, poté je ukončete a vraťte se zpět na plochu. Složka, ve které pracujeme, by měla mít název takto:

Změňte to tak, aby odráželo název, který jste zadali v souboru addon.xml, a poté číslo verze, které jste zadali ve stejné sekci. Na našem příkladu výše bude soubor nyní pojmenován takto:

A je to! Nyní jste do svého doplňku přidali data rozhraní TVDB API a jste připraveni začít seškrabávání metadat z webu.

Další přizpůsobení doplňků

Až budete mít Jen šablonu a váš televizorpostaráno se o klíč API databáze API, proč nezaskočit a přidat několik dalších funkcí přizpůsobení, které vám pomohou při vydávání značky? Jedná se o rychlé a jednoduché kroky, které mohou vést k tomu, že váš doplněk bude lépe rozpoznatelný.

Přidejte ikonu

Obrázky ikon jsou zobrazeny v Kodi vlevopokaždé, když je váš doplněk zvýrazněn. Přidání jednoho usnadňuje vyhledání obsahu bez nutnosti číst tituly, což může být užitečnější, než si myslíte! Chcete-li použít ikonu, vše, co musíte udělat, je vytvořit soubor PNG 256 × 256, nejlépe bez textu nebo značky Kodi, a poté jej přidat do nejvyšší úrovně složky s názvem icon.png. A je to!

Použijte Fan Art

Podobně jako u výše uvedené ikony je umění fanoušků úvodnípozadí, které se zobrazí za textem výběru v Kodi, kdykoli uživatelé zvýrazní váš obsah. Může to souviset s brandingem vaší ikony nebo s tématem vašeho doplňkového obsahu. Pokud například plugin poskytuje televizní pořady, vytvořte originální banner s fanouškem se znaky z Jak jsem potkal vaši matku. Chcete-li to přidat do svého vydání, vytvořte pouze obrázek JPG 1280 × 720, pojmenujte ho fanart.jpg a poté ho vložte do složky nejvyšší úrovně vašeho doplňku.

Závěr

Vývoj doplňku může být matoucí akomplikovaný proces. Komunita však poskytuje spoustu užitečných zdrojů, které vám na této cestě pomohou. Přidání klíče API televizní databáze je pouze jedním z příkladů obsahu vytvořeného uživatelem, který je připraven k propojení s vaším doplňkem, aniž by přeskočil všechny druhy obručí, aby to fungovalo. Máte nějaké tipy, jak pomoci začínajícím vývojářům Kodi? Podělte se o své znalosti v komentářích níže!