Jak używać ResolveURL w Kodi, rozwidleniu URLResolver

ResolveURL to zależność w tle Kodi, a nie katalog wideo ani samodzielny odtwarzacz. Większość użytkowników powinna zainstalować dodatek, który jej potrzebuje, z zaufanego repozytorium; Kodi może wtedy zainstalować ResolveURL jako zależność. Aby to sprawdzić, należy otworzyć menedżera zależności Kodi. Twórcy dodatków mogą zadeklarować tę zależność script.module.resolveurlw swoim manifeście i korzystać z aktualnego API Pythona dla ResolveURL.

ResolveURL to rozwidlenie URLResolver. Utrzymywany projekt identyfikuje pakiet jako script.module.resolveurli publikuje go w oddzielnym repozytorium Kodi. Indeks projektu wskazywał wersję 5.1.212 podczas sprawdzania 27 października 2026 r.; należy używać aktywnego indeksu dla bieżącej wersji, ponieważ może się ona zmieniać. ResolveURL obsługuje tylko linki obsługiwane przez swój kod i nie przeszukuje internetu w poszukiwaniu filmów ani programów. Używaj go z treściami, do których masz prawo dostępu.

Co ResolveURL robi w Kodi

Dodatek Kodi może otrzymać adres URL strony lub hosta pliku, który sam w sobie nie jest bezpośrednio odtwarzalnym strumieniem. ResolveURL próbuje przekształcić obsługiwane linki w adres URL strumienia, który Kodi może otworzyć. Jest to biblioteka współdzielona używana przez inne dodatki, więc zazwyczaj wchodzi się w interakcję z dodatkiem nadrzędnym, zamiast otwierać ResolveURL z ekranu głównego Kodi.

ResolveURL i starszy URLResolver to oddzielne pakiety dodatków. Fork nie zastępuje automatycznie wszystkich starszych zależności ani nie naprawia dodatku, który przestał działać. Przed zmianą lub usunięciem czegokolwiek należy zapoznać się z dokumentacją danego dodatku.

Zainstaluj w normalny sposób

1. Zacznij od dodatku, który go wymaga. W Kodi otwórz Dodatki , wybierz Zainstaluj z repozytorium , wybierz wydawcę dodatku lub inne zaufane repozytorium, a następnie zainstaluj kompatybilny dodatek. Jeśli jego manifest wymaga ResolveURL, a zależność jest dostępna w zainstalowanym repozytorium, Kodi zajmie się instalacją zależności podczas konfiguracji.
2. Korzystaj z repozytorium dewelopera tylko wtedy, gdy jest to konieczne. Jeśli wydawca wyraźnie przekieruje Cię do repozytorium ResolveURL, pobierz plik ZIP repozytorium z repozytorium ZIP osoby zarządzającej . Otwórz folder archiwum ZIP i wybierz bieżący repository.resolveurlpakiet. Plik ZIP repozytorium rejestruje źródło aktualizacji; nie jest to sam moduł ResolveURL.
3. Zainstaluj ten plik ZIP w Kodi. W przeglądarce dodatków wybierz opcję „Zainstaluj z pliku ZIP” , przejdź do miejsca, w którym zapisałeś lub skopiowałeś plik ZIP i zaznacz go. Kodi może poprosić o włączenie opcji „Nieznane źródła” . Kontynuuj tylko wtedy, gdy ufasz źródłu: Kodi ostrzega, że ​​dodatki z nieznanych źródeł mogą uzyskać dostęp do danych osobowych na urządzeniu. Dokładny układ menu może się różnić w zależności od wersji lub skórki Kodi.
4. Pozwól, aby zależny dodatek pobrał moduł, a następnie go zweryfikuj. Zainstaluj lub zaktualizuj dodatek, który deklaruje ResolveURL. Aby sprawdzić wynik, przejdź do Ustawienia > System > Dodatki > Zarządzaj zależnościami i poszukaj ResolveURL. Jeśli to ustawienie jest ukryte, zmień poziom ustawień w lewym dolnym rogu na Zaawansowane . Wymieniona, włączona zależność potwierdza, że ​​jest zainstalowana w Kodi; nie gwarantuje to jednak, że każde łącze do hosta zostanie rozwiązane.

Przeglądarka dodatków oddziela instalację ZIP od przeglądania zainstalowanych repozytoriów.

Kodi ostrzega, że ​​dodatki z nieznanych źródeł mogą ujawniać dane osobowe.

Wybierz archiwum ZIP repozytorium, które pobrałeś z archiwum osoby utrzymującej.

W sekcji Zarządzanie zależnościami możesz sprawdzić, czy opcja ResolveURL jest obecna i włączona.

Użyj ResolveURL w dodatku

Deweloperzy powinni dodać ResolveURL jako wymaganą zależność w pliku dodatku addon.xml. Atrybut version to minimalna wersja, której potrzebuje Twój kod; dopasuj go do używanego interfejsu API i obsługiwanych wersji Kodi.

<requires>
  <import addon="script.module.resolveurl" version="5.1.0" />
</requires>

HostedMediaFileNastępnie należy sprawdzić i rozwiązać obsługiwany adres URL źródłowy za pomocą interfejsu projektu nadrzędnego :

import resolveurl

hosted_file = resolveurl.HostedMediaFile(source_url)
playable_url = hosted_file.resolve() if hosted_file else None

if not playable_url:
    # Report an unsupported or unavailable source to the user.
    pass

Przekaż wynikowy adres URL do przepływu odtwarzania w Kodi dopiero po sprawdzeniu, czy wynik jest użyteczny. Fałszywy lub brakujący wynik może oznaczać, że host nie jest obsługiwany, adres URL źródłowy wygasł, host zmienił swoją stronę lub żądanie nie powiodło się. Rozwiązujący nie może udostępnić do odtwarzania niedostępnej lub nieautoryzowanej zawartości.

Aktualny interfejs i przykład zależności są udokumentowane w repozytorium źródłowym ResolveURL . Przewodnik po manifeście dodatków Kodi wyjaśnia automatyczne rozwiązywanie zależności, a w dokumencie „Ustawienia dodatków” opisano zarządzanie zależnościami i nieznane źródła.

Rozwiązywanie problemów bez zakłócania działania innych dodatków

• „Zależność niedostępna”: Odśwież lub zaktualizuj repozytorium, które udostępnia dodatek nadrzędny, sprawdź, czy Kodi ma dostęp do internetu i potwierdź, że dodatek obsługuje Twoją wersję Kodi. Kodi może instalować tylko zależności dostępne w skonfigurowanym repozytorium lub dostarczone zgodnie z instrukcjami wydawcy.
• Brakuje ResolveURL lub jest wyłączony: Sprawdź listę zależności dodatku i komunikat o instalacji. Aktualizuj z tego samego zaufanego repozytorium, z którego pochodzi dodatek; unikaj mieszania plików ZIP z niepowiązanych kompilacji.
• Link nadal nie działa: sprawdź, czy link źródłowy jest prawidłowy i obsługiwany, a następnie sprawdź dziennik lub stronę pomocy dodatku nadrzędnego. ResolveURL może przestać działać dla konkretnego hosta, gdy ten zmieni swoją usługę.
• Usuwanie starego resolvera: Nie usuwaj ręcznie folderów dodatków Kodi. Kodi może uniemożliwić odinstalowanie zależności, gdy inny dodatek z niej korzysta. Usuń ją za pośrednictwem Kodi tylko wtedy, gdy menedżer zależności oznaczy ją jako porzuconą lub żaden dodatek jej nie wymaga.

Krótko mówiąc, zainstaluj dodatek, który wymaga ResolveURL, z zaufanego źródła, pozwól Kodi zarządzać jego zależnościami i korzystaj z aktualizowanej dokumentacji projektu, jeśli tworzysz dodatek. Unikaj repozytoriów i dodatków, które oferują strumienie chronione prawem autorskim bez autoryzacji.