Jak utworzyć i używać klucza API bazy danych TV: Wskazówki dla programistów Kodi

Oprogramowanie Kodi jest bezpłatne i open source,co oznacza, że ​​każdy może sprawdzić kod, a nawet wprowadzić zmiany w podstawowych działaniach. Jednak prawdziwą siłą stojącą za Kodi jest społeczność. Oprogramowanie zostało zaprojektowane do współpracy z dodatkami stworzonymi przez użytkowników, które zapewniają ogromną różnorodność treści, których podstawowy zespół Kodi nigdy nie mógłby wdrożyć samodzielnie. Są to tak zwane nieoficjalne dodatki, które są tak łatwe do zrobienia, że ​​możesz je założyć już po południu!

Jedna niezwykle przydatna usługa świadczona na rzecz Kodideweloperzy dodatków to indeksujący bazy danych TV, strony takie jak TheTVDB.com lub Trakt. Oba zasoby usuwają metadane z Internetu i udostępniają informacje opinii publicznej za darmo. Oznacza to, że możesz zbudować dodatek, który wyszukuje różne programy telewizyjne i używać TheTVDB do kategoryzowania, oznaczania i sortowania ich wszystkich. Nie musisz sam pobierać informacji ani tworzyć własnego modułu śledzącego. Po prostu pobierz klucz API z bazy danych TV i podłącz go do swojego dodatku, a potem gotowe. Nasz przewodnik poniżej przeprowadzi Cię przez proces od początku do końca.

Ekskluzywna oferta: Zaoszczędź 49%. Wypróbuj ExpressVPN bez ryzyka!

Zdobądź # 1 ocenione VPN

30-dniowa gwarancja zwrotu pieniędzy

Jak uzyskać DARMOWĄ sieć VPN na 30 dni

Jeśli potrzebujesz na przykład sieci VPN na krótki czas podczas podróży, możesz bezpłatnie otrzymać naszą najwyżej sklasyfikowaną sieć VPN. ExpressVPN obejmuje 30-dniową gwarancję zwrotu pieniędzy. Będziesz musiał zapłacić za subskrypcję, to fakt, ale pozwala pełny dostęp przez 30 dni, a następnie anulujesz w celu uzyskania pełnego zwrotu pieniędzy. Ich polityka anulowania bez zadawania pytań jest zgodna z jej nazwą.

Przypomnienie

Jeśli opracowujesz dodatek do Kodi, to właśnie takdobrze zdaje sobie sprawę z pozycji oprogramowania w oczach opinii publicznej. Sam Kodi jest bezpieczny, a większość jego dodatków również. Dostawcy usług internetowych i twórcy treści często myślą inaczej, co oznacza, że ​​gdy tylko przesyłasz coś strumieniowo na Kodi, Twoje konto może być pod kontrolą. Nie ma znaczenia, czy Twój dodatek jest legalny, czy nie, nadal istnieje ryzyko ograniczenia przepustowości lub śledzenia konta.

Dobrą wiadomością jest to, że wirtualne sieci prywatne sąłatwy sposób na pokonanie tych inwazji prywatności. Dzięki VPN twoje dane zostaną zaszyfrowane, zanim opuści twoje urządzenie, uniemożliwiając każdemu sprawdzenie, jakie strony odwiedzasz lub do których strumieni Kodi masz dostęp. Sieci VPN utrudniają również wykrycie Twojej tożsamości lub lokalizacji, przynosząc pewną anonimowość z powrotem do sieci.

Najlepsza sieć VPN dla Kodi - IPVanish

IPVanish trafia we wszystkie odpowiednie miejsca dla idealnej sieci VPNużywać z Kodi. Jest szybki, oferuje ponad 950 serwerów w 60 różnych krajach, dzięki czemu zawsze możesz uzyskać połączenie o niskim opóźnieniu niezależnie od tego, gdzie mieszkasz. Jest również bezpieczny, zapewnia 256-bitowe szyfrowanie AES, ochronę przed wyciekiem DNS i automatyczny przełącznik zabijania dla wszystkich urządzeń. Skorzystasz również z doskonałej zasady zerowego logowania do ruchu i będziesz mógł pobierać torrenty i zawartość sieci P2P z pełną anonimowością. Dzięki IPVanish wystarczy uruchomić aplikację, a połączenie jest bezpieczne.

Więcej funkcji IPVanish:

• Łatwe w użyciu aplikacje dla systemów Windows, Mac, Linux, Android i iOS.
• Nieograniczona przepustowość bez ograniczeń prędkości i ograniczania przepustowości.
• Pełny, anonimowy dostęp do wszystkich dodatków Kodi.

IPVanish oferuje 7-dniową gwarancję zwrotu pieniędzy, co oznacza, że ​​masz tydzień na przetestowanie go bez ryzyka. Proszę to zanotować Wciągające porady Czytelnicy mogą zaoszczędzić tutaj aż 60% rocznego planu IPVanish, obniżając cenę miesięczną do zaledwie 4,87 USD / mc.

Zanim zaczniesz

Podobnie jak każdy dobry programista, robisz swojebadania przed nurkowaniem w pierwszej kolejności. Przeczytaj poniższe sekcje, aby usunąć wszelkie nieporozumienia, a następnie pobierz interfejs API i rozpocznij testowanie.

Co to jest baza danych telewizji?

Jeśli opracowujesz dodatek Kodi, jest prawdopodobneplanujesz zaindeksować znaczną ilość treści filmowych lub programów telewizyjnych. Witryny, które zawierają większość tych plików, zwykle dostarczają tylko filmy, a nie dane towarzyszące, które pomagają zidentyfikować treść. Nazwa pliku prawdopodobnie zawiera program, sezon i numer odcinka, ale co z aktorami lub faktycznym tytułem odcinka? Właśnie w takim przypadku mają zastosowanie indeksujące bazy danych.

Podłączając dodatek Kodi do dobrej bazy danychmożesz łatwo nazwać i kategoryzować całą zawartość, do której program ma dostęp z sieci. Odcinki będą łatwe do sortowania i wyszukiwania w Twoim dodatku i będą znacznie łatwiejsze dla oczu dzięki metadanym zeskrobanym z usługi indeksowania.

Jakie informacje zawiera baza danych?

Może się to różnić w zależności od usługi, z której korzystasz, ale większość indeksatorów koncentruje się na podstawowym zestawie danych, który obejmuje:

• Pełny tytuł programu i oryginalna data emisji.
• Nazwy i numery odcinków.
• Informacje o gatunku.
• Dane dotyczące aktorów, reżyserów, pisarzy itp.
• Box-art, zarówno stworzony przez fanów, jak i oficjalny.
• Oceny użytkowników i oceny krytyków.
• Metadane przetłumaczone na inne języki.

Skąd pochodzą informacje?

Różnorodne źródła, które mogą Cię zaskoczyć. Ponieważ ważne są dokładne informacje, skrobaki baz danych zbliżają się jak najbliżej źródła. Zazwyczaj oznacza to odsyłanie do oficjalnych witryn, takich jak Amazon lub IMDB, które otrzymują tytuły programów i powiązane informacje z samych studiów. W przeciwnym razie inni indeksatorzy odwołują się do swoich treści z innymi otwartymi modułami śledzącymi lub polegają na danych przesłanych przez użytkownika w celu oznaczenia wersji programu.

Klucze API

API oznacza interfejs programowania aplikacji. Klucze API to małe pliki uprawnień lub ciągi losowych liter i cyfr, które wspierają dostęp programu do określonej usługi. Jeśli na przykład tworzysz aplikację do korzystania z Twittera, potrzebujesz klucza API, aby witryna pozwoliła Twojemu kodowi na interakcję z treściami na Twitterze. Klucze do indeksów baz danych TV działają w podobny sposób. Dodając klucz API do dodatku Kodi, dajesz mu poświadczenia potrzebne do pobrania danych z zewnętrznej witryny i wykorzystania ich w Kodi.

Której bazy danych użyć

Jest więcej niż jedna pływająca baza danych indeksowaniana całym świecie. Niektóre z nich są łatwiejsze w użyciu niż inne, a niektóre są po prostu bardziej aktualne niż konkurencja. W poniższym przewodniku omówimy proces tworzenia interfejsu API dla TheTVDB.com, która jest otwartą bazą danych dla fanów telewizji. Jest to jeden z bardziej kompletnych zasobów i jest łatwy do skonfigurowania i wdrożenia.

Czy indeksy metadanych są legalne?

Z pewnością są. Usługi indeksowania, takie jak baza danych TV, z której będziemy korzystać poniżej, mają dostęp tylko do metadanych otaczających fragment treści, a nie do samego pliku. Nie można ich używać do przesyłania strumieniowego, ani w żaden sposób nie przyczyniają się do piractwa. Są również zwykle licencjonowane na licencji Creative Commons do bezpłatnej dystrybucji. To cyfrowy odpowiednik organizowania kolekcji DVD na półce. Całkowicie bezpieczny i w 100% legalny.

Tworzenie klucza API bazy danych TV

Gdy projekt dodatku Kodi będzie w stanie roboczym, możesz pobrać klucz API i zacząć używać go do testowania.

Krok 1 - Utwórz konto

Odwiedź TheTVDB.com i utwórz konto w serwisie. Aby uzyskać spójność, użyj uchwytu kodowania lub nawet tytułu dodatku. Po zarejestrowaniu musisz się zalogować, a następnie zaakceptować warunki, przewijając w dół i zaznaczając pole u dołu strony.

Krok 2 - Wygeneruj klucz

Po utworzeniu konta przejdź do strony rejestracji klucza API. Na dole musisz podać nazwę projektu wraz z oficjalną stroną internetową. Po zakończeniu kliknij „Pobierz klucz API”.

Krok 3 - Zapisz klucz API

TVDB wyświetli twój kod klucza na osobnymstrona. Skopiuj to w bezpieczne miejsce i nie udostępniaj go nikomu innemu, ponieważ zostało wygenerowane tylko dla Twojej aplikacji. Później powinieneś odwołać się do tego, więc trzymaj się blisko.

Korzystanie z klucza API w dodatku Kodi

Po wygenerowaniu klucza API w TheTVDB lubdowolną inną usługę indeksowania metadanych, czas podłączyć ją do kodu dodatkowego, aby upewnić się, że działa. Ten proces może się różnić w zależności od struktury Twojego dodatku. Będziemy używać Jen Template, szeroko stosowanej metody łączenia modułów śledzących z dodatkami Kodi.

Krok 1 - Pobierz szablon Jen

Odwiedź stronę github Jen Template. Kliknij zielony przycisk w prawym górnym rogu z napisem „klonuj lub pobierz”, a następnie pobierz plik zip na pulpit. Wyodrębnij go do własnego folderu, a następnie przygotuj się do edycji.

Krok 2 - Edytuj plik Addon.xml

Tylko w plugin.video.Po rozpakowaniu folderu jen-master znajdziesz plik o nazwie addon.xml. Otwórz to w edytorze kodu. Musisz wprowadzić kilka zmian w niektórych wierszach, aby dostosować dane, do których odwołuje się szablon. Zacznij od wypełnienia informacji w drugim wierszu pliku, o których mowa poniżej. Pamiętaj, aby używać tylko liter i cyfr, bez spacji i niestandardowych znaków, nie zapomnij też ustawić numeru wersji.

Następnie edytuj wiersze 19 i 21, aby podać nieco więcej informacji o swoim dodatku.

Możesz zobaczyć zduplikowane linie odnoszące się do innych języków. Możesz je zostawić w spokoju lub usunąć według własnego uznania.

Zapisz plik addon.xml, na razie skończyłeś go edytować.

Krok 3 - Edytuj plik Default.py

W tym miejscu zaczynamy wchodzić w klucz APIInformacja. W tym samym folderze najwyższego poziomu wyszukaj plik o nazwie default.py. Otwórz go w edytorze kodu, a następnie przewiń w dół, aż zobaczysz linię, do której odwołuje się poniżej. Powinien być w okolicach linii 25.

Włóż klucz API bazy danych TV, jak wskazano powyżej. Rzeczywista linia będzie miała tylko dwa znaki cudzysłowu bez żadnych pośrednich wartości.

Zapisz default.py i wyjdź na teraz. Twój klucz API został wpisany!

Krok 4 - Edytuj plik Settings.xml

Ostatni plik do edycji, potem wraca do testowania. Wejdź do folderu zasobów znajdującego się w katalogu roboczym wtyczki. Otwórz settings.xml w edytorze kodu, a następnie przewiń w dół do około wiersza 27. Istnieje kilka informacji, które musimy wprowadzić tutaj, aby zakończyć konfigurację szablonu Jen.

Sprawdź następujący wiersz w kodzie pliku. Powinien pojawić się trzy razy w wierszach 27, 31 i 36.

Zobacz, co mówi plugin.video.jen? Zmień to na tę samą nazwę wtyczki, którą podałeś w pliku addon.xml. Jeśli na przykład wprowadziłeś plugin.video.addictivetips, linia wyglądałaby następująco:

Zapisz ten plik i zakończ.

Krok 5 - Zmień nazwę i przetestuj

Teraz, gdy interfejs API i dane dotyczące dostosowywania zostaływszedłeś, jesteś gotowy na podsumowanie. Upewnij się, że wszystkie edytowane pliki są zapisane, a następnie wyjdź z nich i wróć na pulpit. Folder, w którym pracujemy, powinien mieć następującą nazwę:

Zmień to, aby odzwierciedlało nazwę podaną w pliku addon.xml, a następnie numer wersji podany w tej samej sekcji. Korzystając z naszego powyższego przykładu, plik miałby teraz nazwę:

To jest to! Dodałeś teraz dane API TVDB do swojego dodatku i możesz rozpocząć zgarnianie metadanych z Internetu.

Inne dostosowania dodatków

Gdy masz już szablon Jen i telewizorklucz API bazy danych, o który zadbano, dlaczego nie wskoczyć i dodać kilka dodatkowych funkcji dostosowywania, aby pomóc w promowaniu swojej wersji? Są to szybkie i proste kroki, które mogą sprawić, że Twój dodatek będzie bardziej rozpoznawalny.

Dodaj ikonę

Obrazy ikon są wyświetlane w Kodi po lewej stroniez boku ekranu za każdym razem, gdy dodatek jest podświetlany. Dodanie jednego ułatwia wykrycie zawartości bez konieczności czytania tytułów, co może być bardziej przydatne niż myślisz! Aby użyć ikony, wystarczy utworzyć plik PNG 256 × 256, najlepiej bez tekstu lub marki Kodi, a następnie dodać go do najwyższego poziomu folderu o nazwie icon.png. To jest to!

Użyj dzieła sztuki

Podobnie jak w powyższej ikonie, grafika fanów to plusktło, które pojawia się za tekstem zaznaczenia w Kodi, ilekroć użytkownicy podświetlą Twoją treść. Może to być związane z brandingiem Twojej ikony lub może być tematem do zawartości dodatkowej. Na przykład, jeśli wtyczka dostarcza programy telewizyjne, utwórz oryginalny baner artystyczny z postaciami z filmu How I Met Your Mother. Aby dodać to do swojej wersji, po prostu utwórz obraz JPG 1280 × 720, nazwij go fanart.jpg, a następnie umieść w folderze najwyższego poziomu dodatku.

Wniosek

Opracowanie dodatku może być mylące iskomplikowany proces. Społeczność zapewnia mnóstwo pomocnych zasobów, które pomogą ci w drodze. Dodanie klucza API bazy danych TV to tylko jeden przykład treści stworzonej przez użytkownika, która jest gotowa do współpracy z Twoim dodatkiem bez przeskakiwania przez wszelkiego rodzaju obręcze, aby działało. Masz jakieś wskazówki, które pomogą pomóc początkującym programistom Kodi? Podziel się swoją wiedzą w komentarzach poniżej!