如何建立和使用電視資料庫 API 金鑰：Kodi 開發人員提示

Kodi 軟體是免費開源的，這意味著任何人都可以查看程式碼，甚至可以對核心工作原理做出貢獻。然而，Kodi 真正的力量在於它的社區。該軟體的設計初衷是與用戶自製的附加元件進行交互，這些附加元件提供了豐富的內容，而這些內容是 Kodi 核心團隊獨自一人永遠無法實現的。這些附加元件稱為非官方附加元件，製作起來非常簡單，您只需一個下午就能開始！

為 Kodi 插件開發者提供的一項極其實用的服務是電視資料庫索引器，例如 TheTVDB.com 或 Trakt 等網站。這兩個資源都從網路上抓取元數據，並免費向公眾提供資訊。這意味著您可以建立一個外掛程式來尋找不同的電視節目，並使用 TheTVDB 對所有節目進行分類、標記和排序。無需自行獲取信息，也無需建立自己的追蹤器。只需從電視資料庫中取得 API 金鑰並將其插入到您的插件中即可。下面的指南將引導您完成整個過程。

獲取排名第一的VPN

68% 折扣 + 3 個月免費試用

提醒

如果您正在為 Kodi 開發插件，那麼您一定非常清楚該軟體在公眾眼中的地位。 Kodi 本身是安全的，它的大多數插件也同樣安全。但網路服務供應商和內容創作者通常不這麼認為，這意味著當您在 Kodi 上進行串流媒體時，您的帳戶可能會受到審查。無論您的外掛程式是否合法，您仍然面臨被限制流量或帳戶被追蹤的風險。

好消息是，虛擬私人網路 (VPN) 是抵禦這些隱私侵犯的簡單方法。使用 VPN，您的資料在離開裝置之前就會加密，任何人都無法看到您正在造訪的網站或您正在觀看的 Kodi 串流媒體。 VPN 也能讓您的身分或位置難以被發現，從而為萬維網帶來一定程度的匿名性。

Kodi 的最佳 VPN – IPVanish

IPVanish 完美契合 Kodi 的 VPN 需求。它速度快，在 60 個不同的國家/地區提供超過 950 台伺服器，無論您身在何處，都能獲得低延遲連線。它還非常安全，提供 256 位元 AES 加密、DNS 洩漏保護和適用於所有裝置的自動終止開關。您還可以享受卓越的流量零日誌記錄政策，並能夠完全匿名地下載種子和 P2P 網路內容。使用 IPVanish，您只需運行應用程序，您的連接即可安全無虞。

IPVanish 更多功能：

適用於 Windows、Mac、Linux、Android 和 iOS 的易於使用的應用程式。

無限頻寬，無速度上限或限制。

完全、匿名存取 Kodi 的所有附加元件。

IPVanish 提供 7 天退款保證，這意味著您有一周時間可以無風險地試用。請注意， WebTech360 Tips 的讀者可以節省 60% 的 IPVanish 包年套餐費用，每月僅需 4.87 美元。

開始之前

就像任何優秀的開發人員一樣，在深入研究之前，你應該要做好功課。閱讀以下部分，澄清你可能存在的任何誤解，然後你就可以隨意取得 API 並開始測試了。

如何建立和使用電視資料庫 API 金鑰：Kodi 開發人員提示

什麼是電視資料庫？

如果您正在開發 Kodi 插件，很可能會計劃索引大量的電影或電視節目內容。提供這些文件的網站通常只提供視頻，而不提供有助於識別內容的附加數據。檔案名稱可能包含節目、季數和集數，但演員或劇集的實際標題呢？這時，索引資料庫就派上用場了。

透過將你的 Kodi 外掛插入一個優質的資料庫，你可以輕鬆地命名和分類你的程式從網路存取的所有內容。在你的插件上，劇集的排序和搜尋將變得非常容易，而且由於從索引服務中抓取的元數據，它們看起來也更加清晰易讀。

資料庫包含哪些資訊？

這可能會因您使用的服務而異，但大多數索引器都專注於一組核心數據，其中包括以下內容：

該節目的完整名稱和最初播出日期。

劇集名稱和編號。

類型資訊。

有關演員、導演、編劇等的數據。

盒子藝術，包括粉絲製作的和官方的。

用戶評分和評論家評分。

元資料翻譯成其他語言。

訊息從何而來？

各種來源可能會讓您感到驚訝。由於準確的資訊至關重要，資料庫抓取工具會盡可能地貼近源頭。這通常意味著引用亞馬遜或IMDB等官方網站，這兩個網站都從製片廠本身獲取劇集名稱和相關資訊。如果做不到這一點，其他索引器會將其內容與其他開放的追蹤器進行交叉引用，或依靠使用者提交的資料來標記劇集的發行。

API 金鑰

API 代表應用程式介面 (API)。 API 金鑰是小型權限檔案或由隨機字母和數字組成的字串，用於授予程式存取特定服務的權限。例如，如果您要開發一款與 Twitter 配合使用的應用程序，則需要 API 金鑰，以便網站允許您的程式碼與 Twitter 的內容互動。電視資料庫索引的密鑰工作原理大致相同。透過在您的 Kodi 外掛程式中新增 API 金鑰，您將獲得從外部網站提取資料並在 Kodi 中使用這些資料所需的憑證。

使用哪個資料庫

互聯網上存在著多個索引資料庫。有些資料庫比其他資料庫更容易使用，而有些則比競爭對手更新。以下的指南將介紹 TheTVDB.com 的 API 建立流程，這是一個面向電視迷的開放資料庫。它是資源最齊全的資料庫之一，並且易於設定和部署。

元資料索引合法嗎？

當然可以。像我們下面要用到的電視資料庫這樣的索引服務，只能存取內容的元數據，而不是檔案本身。你不能用它們來串流播放任何內容，也不會以任何方式助長盜版。它們通常也獲得知識共享許可，可以免費分發。這相當於在數位世界中整理你的DVD收藏。完全安全，100%合法。

建立電視資料庫 API 金鑰

一旦您的 Kodi 插件專案處於工作狀態，您就可以獲得 API 金鑰並開始使用它來測試。

如何建立和使用電視資料庫 API 金鑰：Kodi 開發人員提示

步驟 1 – 建立帳戶

造訪TheTVDB.com並建立帳戶。為了保持一致性，請使用您的程式碼名稱，甚至可以使用插件的名稱。註冊後，您需要登錄，然後向下捲動頁面並勾選頁面底部的方框，同意條款和條件。

第 2 步 - 產生金鑰

擁有帳戶後，前往API 金鑰註冊頁面。在頁面底部，您需要輸入項目名稱及其官方網站。完成後，點選「取得 API 金鑰」。

步驟 3 – 儲存 API 金鑰

TVDB 會在單獨的頁面上顯示您的啟動碼。請將此程式碼複製到安全的地方，切勿與他人分享，因為它是專為您的應用程式產生的。您稍後需要參考此程式碼，因此請將其放在手邊。

在您的 Kodi 插件中使用 API 金鑰

使用 TheTVDB 或其他元資料索引服務產生 API 金鑰後，就該將其插入到您的插件程式碼中，以確保其正常運作。此過程可能會因您插件的建構方式而異。我們將使用 Jen 模板，這是一種廣泛使用的將追蹤器與 Kodi 插件結合的方法。

如何建立和使用電視資料庫 API 金鑰：Kodi 開發人員提示

步驟 1 – 下載 Jen 模板

造訪Jen 範本的 GitHub 頁面。點擊右上角的綠色按鈕“克隆或下載”，然後將 zip 檔案下載到桌面。將其解壓縮到對應的資料夾中，然後就可以進行編輯了。

步驟 2 - 編輯 Addon.xml

在剛剛解壓縮的 plugin.video.jen-master 資料夾中，您會找到一個名為 addon.xml 的檔案。在程式碼編輯器中打開它。您需要對其中幾行進行一些編輯，以自訂範本引用的資料。首先填寫文件第二行中的資訊（如下所示）。請記住，只能使用字母和數字，不要使用空格或非標準字符，並且不要忘記設定版本號。

接下來，編輯第 19 行和第 21 行，提供有關您的附加元件的更多資訊。

插件概要

更長的插件描述

您可能會看到引用其他語言的重複行。您可以根據需要保留這些行或將其刪除。

儲存 addon.xml 文件，現在您已完成編輯。

如何建立和使用電視資料庫 API 金鑰：Kodi 開發人員提示

步驟3 - 編輯Default.py

我們從這裡開始了解 API 金鑰資訊。在同一個頂層資料夾中，找到名為 default.py 的檔案。在程式碼編輯器中開啟它，然後向下捲動，直到看到下面引用的那一行。它應該在第 25 行左右。

__builtin__.tvdb_api_key = “在此處貼上 API 密鑰” # tvdb API 密鑰

在上面指定的位置插入您的電視資料庫 API 金鑰。實際行中只有兩個引號，中間沒有任何內容。

儲存 default.py 並退出。您的 API 金鑰已輸入！

步驟 4 – 編輯 Settings.xml

最後一個文件需要編輯，然後就可以開始測試了。進入插件工作目錄中的 resources 資料夾。在程式碼編輯器中開啟 settings.xml 文件，然後向下捲動到第 27 行左右。我們需要在這裡輸入一些資訊來完成 Jen 模板的設定。

檢查文件代碼中的以下行。它應該在第 27、31 和 36 行出現三次。

操作=”RunPlugin（插件：//plugin.video.jen/？mode=ScraperSettings）”/>

看到plugin.video.jen了嗎？把它改成你在 addon.xml 檔案中輸入的插件名稱。例如，如果你輸入的是 plugin.video.addictivetips，那麼這一行應該像這樣：

操作=”RunPlugin（插件：//plugin.video.addictivetips/?mode=ScraperSettings）”/>

儲存此文件並退出。

步驟 5 – 重新命名並測試

現在 API 和自訂資料已輸入完畢，您可以開始收尾工作了。請確保所有編輯的文件都已儲存，然後退出並返回桌面。我們正在處理的資料夾名稱應類似於以下內容：

plugin.video.jen-master

將其變更為您在 addon.xml 檔案中輸入的名稱，後面跟著在同一部分中輸入的版本號碼。使用上面的範例，文件現在將命名為：

插件.video.addictivetips.0.1.zip

就這樣！現在，您已將 TVDB API 資料新增至外掛程式中，並準備開始從網路上抓取元資料。

其他附加自訂

準備好 Jen 範本和電視資料庫 API 金鑰後，何不加入一些自訂功能，為您的版本打造品牌？這些步驟快速簡單，卻能讓您的外掛更有辨識度。

新增圖示

每次您的附加元件被高亮顯示時，圖示影像都會顯示在 Kodi 螢幕左側。添加圖標可以讓您輕鬆找到內容，而無需閱讀標題，這比您想像的更有用！要使用圖標，您只需建立一個 256×256 的 PNG 文件，最好不要包含任何文字或 Kodi 品牌標識，然後將其新增至名為 icon.png 的資料夾的頂層即可。就這樣！

使用粉絲藝術

與上面的圖標類似，粉絲藝術是一個閃屏背景，每當用戶突出顯示您的內容時，它就會顯示在 Kodi 的選擇文字後面。這可以與您的圖示品牌相關，也可以與您的外掛內容主題相關。例如，如果外掛提供電視節目，請創建一個原創的粉絲藝術橫幅，其中包含《老爸老媽浪漫史》中的角色。要將其新增至您的發布版本中，只需建立 1280×720 的 JPG 映像，將其命名為 fanart.jpg，然後將其貼到插件的頂級資料夾中。

結論

開發插件可能是一個令人困惑且複雜的過程。不過，社群提供了大量實用資源，可以助您一臂之力。新增電視資料庫 API 金鑰只是其中一個例子，使用者自製的內容可以直接與您的外掛程式對接，無需費盡周折即可運作。您有什麼建議可以幫助 Kodi 新手開發者嗎？請在下方留言處分享您的經驗！