如何在 Kodi 中使用 ResolveURL(URLResolver 的一個分支)

ResolveURL 是 Kodi 的一個後台依賴項,它並非視訊目錄或獨立播放器。大多數用戶應該從他們信任的軟體倉庫安裝需要 ResolveURL 的插件;Kodi 隨後會將 ResolveURL 作為依賴項安裝。若要檢查依賴項,請開啟 Kodi 的依賴項管理員。插件開發者可以script.module.resolveurl在其清單檔案中聲明並使用 ResolveURL 目前的 Python API。

ResolveURL 是 URLResolver 的一個分支。維護該專案的開發者將其軟體包標識為 URLResolver script.module.resolveurl,並透過一個獨立的 Kodi 軟體倉庫發布。項目索引在 2026 年 10 月 27 日的檢查中顯示版本為 5.1.212;由於版本可能會更改,請使用即時索引查看最新版本。 ResolveURL 僅處理其代碼支援的鏈接,不會在網路上搜尋電影或電視節目。請確保您擁有存取權限的內容。

ResolveURL 在 Kodi 的作用

Kodi 外掛程式可能會收到一個頁面或文件託管 URL,但該 URL 本身並非可直接播放的串流媒體。 ResolveURL 會嘗試將支援的連結轉換為 Kodi 可以開啟的串流 URL。它是一個與其他插件共享的庫,因此通常情況下,您需要與父插件交互,而不是從 Kodi 的主畫面打開 ResolveURL。

ResolveURL 和舊版 URLResolver 是兩個獨立的插件包。建立分支並不會自動取代所有舊依賴項,也不會修復已停止工作的插件。在更改或刪除任何內容之前,請務必查看插件本身的文件。

按正常方式安裝

  1. 首先,找到需要 ResolveURL 的插件。在 Kodi 中,開啟“插件”,選擇“從庫安裝”,選擇插件的發布者或其他您信任的庫,然後安裝相容的插件。如果插件的清單檔案需要 ResolveURL,且該依賴項存在於已安裝的程式庫中,Kodi 會在安裝過程中自動安裝該依賴項。
  2. 僅在必要時使用開發者程式碼庫。如果發布者明確指示您使用 ResolveURL 自己的程式碼庫,請從維護者的 ZIP 程式碼庫中取得程式碼庫 ZIP 檔案。打開其ZIP 壓縮包資料夾並選擇目前repository.resolveurl軟體包。程式碼庫 ZIP 檔案註冊的是更新來源,而不是 ResolveURL 模組本身。
  3. 將該 ZIP 檔案安裝到 Kodi 中。在外掛程式瀏覽器中,選擇「從 ZIP 文件安裝」,找到您儲存或複製的 ZIP 文件,然後選擇它。 Kodi 可能會要求您啟用「未知來源」。請僅在您信任該來源的情況下繼續:Kodi 會警告您,來自未知來源的插件可以存取裝置上的個人資料。具體的選單佈局可能因 Kodi 版本或皮膚而異。
  4. 讓依賴的插件拉取該模組,然後進行驗證。安裝或更新聲明了 ResolveURL 的插件。若要檢查結果,請前往「設定」>「系統」>「外掛程式」>「管理依賴項」,然後尋找 ResolveURL。如果該設定處於隱藏狀態,請將左下角的設定等級變更為「進階」。清單中顯示已啟用的依賴項表示 Kodi 已安裝該模組;但這並不保證每個主機連結都能解析。
Kodi插件瀏覽器顯示「從zip檔案安裝」和「從儲存庫安裝」選項

插件瀏覽器將 ZIP 安裝與瀏覽已安裝的儲存庫分開。

Kodi 未知來源警告,並提供「是」和「否」選項

Kodi警告稱,來自未知來源的插件可能會洩露個人資料。

Kodi ZIP 檔案選擇器,已在「下載」中選擇 repository.resolveurl-1.0.0.zip。

選擇您從維護者存檔中取得的儲存庫 ZIP 檔案。

Kodi 管理相依性畫面中,ResolveURL 顯示為已啟用

在「管理依賴項」中,可以確認 ResolveURL 是否存在並已啟用。

在插件中使用 ResolveURL

對於開發者,請在插件中新增 ResolveURL 作為必需依賴項addon.xml。版本屬性指定程式碼所需的最低版本;請將其與您使用的 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 管理其依賴項,如果您正在開發插件,請使用維護良好的專案文件。避免使用未經授權提供受版權保護串流媒體的儲存庫或外掛程式。

留下評論

Crackle Kodi 附加组件:如何在 Kodi 上观看索尼电影

Crackle Kodi 附加组件:如何在 Kodi 上观看索尼电影

了解 Crackle Kodi 附加组件的安装入口、版本兼容与常见故障排查,并核实 Sony 官方关于 Crackle 服务结束的说明。本文解释插件仍可见为何不代表影片仍能播放,以及安全检查步骤,并区分服务终止、地区限制与版本不兼容,避免误把旧教程当作当前可行方案,并确认安全来源。

如何使用 Kodi 全局搜索插件查找媒体内容

如何使用 Kodi 全局搜索插件查找媒体内容

了解如何在 Kodi 中安装并使用 Global Search 全局搜索插件,快速查找电影、电视剧、剧集、音乐视频、艺人、专辑和歌曲。本文说明官方仓库安装路径、搜索步骤,以及资料库未扫描、类别未启用或插件异常时的排查方法,并解释它与在线服务搜索的区别,帮助你核对结果并安全更新插件。

如何正確解除安裝 Kodi 軟體來源

如何正確解除安裝 Kodi 軟體來源

了解如何安全地卸載 Kodi 儲存庫,單獨刪除其儲存的來源 URL,並檢查您仍需要哪些已安裝的外掛程式或相依性。

在 Kodi 上觀看網球直播:最佳插件和合法觀看方式

在 Kodi 上觀看網球直播:最佳插件和合法觀看方式

找到使用 Kodi 觀看網球直播的最安全方法:了解 iPlayer WWW 可以播放哪些內容、如何找到授權的轉播以及應該避免使用哪些插件。

如何在 Kodi 上觀看電影:完整新手教程

如何在 Kodi 上觀看電影:完整新手教程

學習如何透過 Kodi 從電腦、USB或 NAS 觀看電影,添加線上視訊服務,並透過清晰的設定步驟修復缺少的影片。

如何在 Kodi 上合法可靠地觀看拳擊付費直播

如何在 Kodi 上合法可靠地觀看拳擊付費直播

找到您所在國家/地區的授權串流媒體,檢查其提供者是否支援 Kodi,然後在您的電視上觀看拳擊付費直播,而無需依賴過時的插件。

5款最佳Kodi皮膚以及如何在幾分鐘內改變Kodi的外觀

5款最佳Kodi皮膚以及如何在幾分鐘內改變Kodi的外觀

在官方 Omega 目錄中比較五款 Kodi 皮膚,然後按照當前設定路徑安裝其中一款、自訂它或切換回去。

如何開啟 Kodi 家長監護功能並鎖定兒童帳戶

如何開啟 Kodi 家長監護功能並鎖定兒童帳戶

設定 Kodi 主鎖 PIN 碼,保護選定的選單,並建立單獨的兒童個人資料,其中包含您選擇的媒體來源。

1Channel Kodi插件:現在還能安裝它來觀看電影和電視節目嗎?

1Channel Kodi插件:現在還能安裝它來觀看電影和電視節目嗎?

正在尋找 1Channel Kodi 插件?了解為什麼舊的 PrimeWire 安裝指南不可靠,以及如何安全地安裝受支援的視訊外掛程式。

如何在家或外出時透過網頁介面控制 Kodi

如何在家或外出時透過網頁介面控制 Kodi

啟用 Kodi 的 Chorus2 網路介面,透過任何瀏覽器控制您的媒體,並學習如何在不將 Kodi 暴露於網路的情況下進行遠端連線。