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 zkontrolovat kód nebo dokonce přispět ke změnám v základních funkcích. Skutečná síla, kterou stojí za Kodi, je však její komunita. Tento software byl navržen tak, aby byl propojen s uživatelsky vyrobenými doplňky, které poskytují obrovské množství 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!

Jednou z neuvěřitelně užitečných služeb poskytovaných vývojářům doplňků Kodi 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.

Připomínka

Pokud vyvíjíte doplněk pro Kodi, jste si dobře vědomi pozice, kterou software zaujímá 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ě jsou snadným způsobem, jak tyto invaze do soukromí porazit. Díky síti VPN budou vaše data před opuštěním zařízení šifrována, takže 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

IPVanishzasáhne všechna správná místa pro perfektní VPN, kterou lze s Kodi použít. 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 škrtení.
• Ú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 Návykové tipy čtenáři mohou Ušetřete zde obrovských 60% o 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 dříve, než se potápíte v hlavě, provedete svůj výzkum. 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 pravděpodobné, že plánujete 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áze můž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 přesné informace jsou důležité, jsou škrabky databáze co nejblíže ke zdroji. To obvykle znamená odkazovat na oficiální stránky, jako je Amazon nebo IMDB, které získají své výstavní tituly a související informace ze studií samotných. Pokud tomu tak není, 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

Po celém světě existuje více než jedna databáze indexování. 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í API pro TheTVDB.com, což je otevřená databáze pro fanoušky televizí. 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

Návštěva 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íč

Až budete mít účet, jděte na Stránka 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é stránce. 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 si to dejte pozor.

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

Jakmile vygenerujete klíč API s TheTVDB nebo jakoukoli jinou službou indexování metadat, je čas jej připojit do vašeho doplňkového kódu, abyste se ujistili, že funguje. Tento proces se může lišit v závislosti na struktuře vašeho doplňku. Použijeme Jen Template, široce používanou metodu kombinování sledovačů s doplňky Kodi.

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

Navštivte Stránka 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

Přímo ve složce plugin.video.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.

PŘIDAT SOUHRN

DÉLKOVÝ POPIS

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 se dostáváme do klíčových informací API. 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.

__builtin __. tvdb_api_key = “PASTE API KEY HERE” # tvdb api key

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. Existuje několik informací, které musíme zadat, abychom dokončili nastavení šablony Jen.

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

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

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:

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

Uložte tento soubor a ukončete.

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

Nyní, když jste zadali data API a přizpůsobení, 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:

plugin.video.jen-master

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:

plugin.video.addictivetips.0.1.zip

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 na starosti Jen šablonu a klíč API vaší televizní databáze, proč nezaskočit a přidat několik dalších funkcí přizpůsobení, které vám pomohou s vydáním 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 na levé straně obrazovky pokaždé, když je zvýrazněn váš doplněk. 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ím pozadím, které se zobrazuje za textem výběru v Kodi, kdykoli uživatelé zvýrazní váš obsah. Může to souviset s vaší značkou ikon 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 filmu Jak jsem potkal vaši matku. Chcete-li to přidat do svého vydání, vytvořte pouze obrázek JPG 1280 × 720 JPG, 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í a komplikovaný 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!