KodiでURLResolverフォークであるResolveURLを使用する方法

ResolveURLはKodiのバックグラウンド依存関係であり、ビデオカタログやスタンドアロンプ​​レーヤーではありません。ほとんどのユーザーは、信頼できるリポジトリから必要なアドオンをインストールする必要があります。そうすれば、KodiはResolveURLを依存関係としてインストールできます。確認するには、Kodiの依存関係マネージャーを開いてください。アドオン開発者は、script.module.resolveurlマニフェストで宣言し、ResolveURLの現在のPython APIを使用できます。

ResolveURLはURLResolverのフォークです。メンテナンスされているプロジェクトでは、パッケージをとして識別しscript.module.resolveurl、別のKodiリポジトリを通じて公開しています。プロジェクトインデックスは2026年10月27日に確認したところバージョン5.1.212をリストしていました。最新バージョンは変更される可能性があるため、ライブインデックスを使用してください。ResolveURLはコードでサポートされているリンクのみを処理し、映画や番組をウェブで検索しません。アクセス権限のあるコンテンツで使用してください。

ResolveURLがKodiで何をするか

Kodiアドオンは、直接再生可能なストリームではないページまたはファイルホストのURLを受け取る場合があります。ResolveURLは、サポートされているリンクをKodiが開くことができるストリームURLに変換しようとします。これは他のアドオンも使用する共有ライブラリであるため、通常はKodiのホーム画面からResolveURLを開くのではなく、親アドオンを操作することになります。

ResolveURLと旧バージョンのURLResolverは、それぞれ別のアドオンパッケージです。フォークしても、古い依存関係がすべて自動的に置き換えられたり、動作しなくなったアドオンが修復されたりするわけではありません。変更や削除を行う前に、必ずアドオンのドキュメントを確認してください。

通常の方法でインストールしてください

1. まず、必要なアドオンから始めましょう。Kodiで「アドオン」を開き、 「リポジトリからインストール」を選択します。アドオンの発行元、または信頼できる別のリポジトリを選択し、互換性のあるアドオンをインストールします。マニフェストにResolveURLが必要で、依存関係がインストール済みのリポジトリに存在する場合、Kodiはセットアップ中に依存関係のインストールを処理します。
2. 開発者のリポジトリは必要な場合にのみ使用してください。発行元がResolveURL独自のリポジトリを明示的に指定している場合は、メンテナーのZIPリポジトリからリポジトリZIPを取得してください。ZIPアーカイブフォルダを開き、現在のrepository.resolveurlパッケージを選択します。リポジトリZIPは更新ソースを登録するものであり、ResolveURLモジュール自体ではありません。
3. KodiにそのZIPファイルをインストールします。アドオンブラウザで「ZIPファイルからインストール」を選択し、ZIPファイルを保存またはコピーした場所に移動して選択します。Kodiは「不明なソース」を有効にするよう求める場合があります。ソースを信頼できる場合のみ続行してください。Kodiは、不明なソースからのアドオンはデバイス上の個人データにアクセスできる可能性があると警告します。正確なメニューレイアウトは、Kodiのバージョンまたはスキンによって異なる場合があります。
4. 依存アドオンがモジュールを取得したら、それを検証します。ResolveURLを宣言しているアドオンをインストールまたは更新します。結果を確認するには、[設定] > [システム] > [アドオン] > [依存関係の管理]に移動し、ResolveURL を探します。その設定が非表示になっている場合は、左下の [設定レベル] を[詳細設定]に変更します。リストに表示され、有効になっている依存関係は、Kodi にインストールされていることを示しますが、すべてのホスト リンクが解決されることを保証するものではありません。

アドオンブラウザは、ZIPファイルのインストールとインストール済みリポジトリの閲覧を分離します。

Kodiは、出所不明のアドオンを使用すると個人データが漏洩する可能性があると警告しています。

メンテナーのアーカイブから入手したリポジトリのZIPファイルを選択してください。

依存関係の管理画面で、ResolveURLが存在し、有効になっていることを確認できます。

アドオンでResolveURLを使用する

開発者の方は、アドオンの.pyファイルにResolveURLを必須依存関係として追加してください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に依存関係の管理を任せ、アドオンを開発する場合は、メンテナンスされているプロジェクトのドキュメントを参照してください。著作権で保護されたストリームを無断で提供するリポジトリやアドオンは避けてください。