Как использовать ResolveURL в Kodi, форк URLResolver

ResolveURL — это фоновая зависимость Kodi, а не видеокаталог или автономный плеер. Большинству пользователей следует устанавливать дополнение, которому он нужен, из репозитория, которому они доверяют; после этого Kodi сможет установить ResolveURL в качестве зависимости. Чтобы проверить это, откройте менеджер зависимостей Kodi. Разработчики дополнений могут указать это script.module.resolveurlв своем манифесте и использовать текущий Python API ResolveURL.

ResolveURL — это форк URLResolver. Поддерживаемый проект идентифицирует пакет как script.module.resolveurlи публикует его через отдельный репозиторий Kodi. В индексе проекта указана версия 5.1.212 при проверке 27 октября 2026 года; используйте текущий индекс, поскольку он может измениться. ResolveURL обрабатывает только ссылки, поддерживаемые его кодом, и не выполняет поиск фильмов или сериалов в интернете. Используйте его с контентом, к которому у вас есть права доступа.

Что делает ResolveURL в Kodi

Дополнение Kodi может получать URL-адрес страницы или файлового хоста, который сам по себе не является прямым воспроизводимым потоком. ResolveURL пытается преобразовать поддерживаемые ссылки в URL-адрес потока, который Kodi может открыть. Это общая библиотека, используемая другими дополнениями, поэтому обычно вы взаимодействуете с родительским дополнением, а не открываете ResolveURL с главного экрана Kodi.

ResolveURL и более старая версия URLResolver — это отдельные пакеты дополнений. Создание форка не приводит к автоматической замене всех старых зависимостей или восстановлению дополнения, которое перестало работать. Перед внесением изменений или удалением чего-либо ознакомьтесь с документацией самого дополнения.

Установите его обычным способом.

1. Начните с дополнения, которому это необходимо. В Kodi откройте «Дополнения» , выберите «Установить из репозитория» , выберите издателя дополнения или другой репозиторий, которому вы доверяете, а затем установите совместимое дополнение. Если в его манифесте требуется ResolveURL, и зависимость доступна в установленном репозитории, Kodi выполнит установку зависимости во время установки.
2. Используйте репозиторий разработчика только при необходимости. Если издатель специально указывает на собственный репозиторий ResolveURL, получите ZIP-архив репозитория из ZIP-архива сопровождающего . Откройте папку с ZIP-архивом и выберите текущий repository.resolveurlпакет. ZIP-архив репозитория регистрирует источник обновлений; это не сам модуль ResolveURL.
3. Установите этот ZIP-архив в Kodi. В браузере дополнений выберите «Установить из ZIP-файла» , перейдите к месту, где вы сохранили или скопировали ZIP-архив, и выберите его. Kodi может запросить разрешение на установку из неизвестных источников . Продолжайте только в том случае, если вы доверяете источнику: Kodi предупреждает, что дополнения из неизвестных источников могут получить доступ к личным данным на устройстве. Точная структура меню может различаться в зависимости от версии или темы оформления Kodi.
4. Позвольте зависимому дополнению загрузить модуль, а затем проверьте его. Установите или обновите дополнение, которое объявляет ResolveURL. Чтобы проверить результат, перейдите в Настройки > Система > Дополнения > Управление зависимостями и найдите ResolveURL. Если этот параметр скрыт, измените уровень настроек в левом нижнем углу на «Расширенные» . Наличие включенной зависимости в списке подтверждает, что Kodi установил её; это не гарантирует, что каждая ссылка на хосте будет разрешена.

Браузер дополнений разделяет процесс установки ZIP-архивов и просмотр установленных репозиториев.

Kodi предупреждает, что дополнения из неизвестных источников могут раскрыть персональные данные.

Выберите ZIP-архив репозитория, полученный из архива сопровождающего проекта.

В разделе «Управление зависимостями» можно убедиться, что функция ResolveURL присутствует и включена.

Используйте ResolveURL в дополнении.

Разработчикам рекомендуется добавить ResolveURL в качестве обязательной зависимости в файл `.py` дополнения addon.xml. Атрибут `version` указывает минимальную версию, необходимую вашему коду; сопоставьте её с используемым API и поддерживаемыми версиями Kodi.

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

Затем используйте интерфейс проекта-источника HostedMediaFile, чтобы проверить и определить поддерживаемый URL-адрес источника:

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

Передавайте полученный URL-адрес в процесс воспроизведения Kodi только после проверки его пригодности. Неверный или отсутствующий результат может означать, что хост не поддерживается, срок действия исходного URL-адреса истек, хост изменил свою страницу или запрос не удался. Резолвер не может обеспечить воспроизведение недоступного или несанкционированного контента.

Текущий интерфейс и пример зависимостей описаны в репозитории исходного кода ResolveURL . В руководстве по манифесту дополнений Kodi объясняется автоматическое разрешение зависимостей, а в справочнике по настройкам дополнений описываются разделы «Управление зависимостями» и «Неизвестные источники».

Устранение неполадок без нарушения работы других дополнений.

• «Зависимость недоступна»: обновите репозиторий, предоставляющий родительское дополнение, убедитесь, что Kodi имеет доступ к интернету, и подтвердите, что дополнение поддерживает вашу версию Kodi. Kodi может устанавливать только зависимости, доступные из настроенного репозитория или предоставленные в соответствии с указаниями издателя.
• Функция ResolveURL отсутствует или отключена: проверьте список зависимостей дополнения и сообщение об установке. Обновляйте из того же доверенного репозитория, который предоставил дополнение; избегайте смешивания ZIP-архивов из несвязанных сборок.
• Ссылка по-прежнему не работает: убедитесь, что исходная ссылка действительна и поддерживается, затем проверьте журнал или страницу поддержки родительского дополнения. ResolveURL может перестать работать для конкретного хоста, когда этот хост меняет свои сервисы.
• Удаление старого резолвера: Не удаляйте папки дополнений Kodi вручную. Kodi может запретить удаление зависимости, если другое дополнение её использует. Удаляйте её через Kodi только в том случае, если менеджер зависимостей помечает её как "осиротевшую" или если ни одно дополнение её не требует.

Короче говоря, устанавливайте дополнение, которому нужен ResolveURL, из надежного источника, позвольте Kodi управлять его зависимостью и используйте поддерживаемую документацию проекта, если вы разрабатываете дополнение. Избегайте репозиториев или дополнений, предлагающих потоки, защищенные авторским правом, без разрешения.