XBMC新版“擴展功能”簡介

目錄 1. 擴展功能模塊結構 2. 圖片文件指引 2.1 icon.png 2.2 fanart.jpg 3. addon.xml 3.1 <addon>元素 3.2 <requires>元素 3.3 <extension>元素 3.4 xbmc.addon.metadata extension 4. extension類別

本貼介紹將在即將發布的XBMC Dharma（10.05）中采用的擴展功能管理系統。XBMC要推出的這個新插件系統使得第三方開發的增強功能可以被用戶直接通過XBMC內置用戶界面獲取。這個插件系統基于插件功能庫

c-pluff

擴展功能模塊結構

每個擴展功能模塊保存在獨立的目錄中，并用名這addon.xml的XML文件來描述。還有一些相關文件，名為icon.png、 changelog.txt和fanart.jpg。這幾個文件是可選擇使用的，不過建議至少要有icon.png。這些文件要存在擴展功能模塊的“根” 目錄中。其他文件應該包含在resources/子目錄中，如語言文件和設置描述文件。

圖片文件指引

每個擴展功能有2個相關的圖片文件：一個圖標文件（icon.png）和一個可選的同人畫文件（fanart.jpg）。如果你想要為你的擴展功能制作高質量的圖標或同人畫，可以隨時向XBMC論壇的社區提出請求－－那里有許多天才的設計師們樂于為你的擴展功能設計美圖。

icon.png

我們建議icon.png做成正方形的PNG文件，規則如下：

· 它應該以圖形方式向用戶表述這個擴展功能的作用；

· 它應該是256x256的PNG文件；

· 它不應該有陰影、光澤或類似特效－－XBMC皮膚系統會處理這些；

· 建議采用在平面背景（非透明）下的logo圖標形式（例如采用擴展功能在線獲取媒體的服務商的logo圖標）。

fanart.jpg

我們建議fanart.png做成16:9的JPG文件，規則如下：

· 它用作背景，所以應該簡潔沒有文字內容；

· 建議為1280x720的JPG文件，通常分辨率不要高于1920x1080；

· 建議在合理范圍內盡可能讓文件字節數小些，要知道有成千上萬人要下載它。

addon.xml

addon.xml是一個很重要的文件，它告訴XBMC這個擴展功能模塊是干嗎的（比如是哪一類擴展功能）以及要依賴哪些擴展功能、正常運行需要的XBMC最低版本。addon.xml文件范例如下：

復制內容到剪貼板

代碼:

<?xml version="1.0" encoding="UTF-8"?>
<addon
??id="skin.confluence"
??version="1.1.0"
??name="Confluence"
??provider-name="Jezz_X, Team XBMC">
??<requires>
? ? <import addon="xbmc.gui" version="2.11"/>
??</requires>
??<extension
? ? point="xbmc.gui.skin"
? ? defaultresolution="720p"
? ? defaultresolutionwide="720p"
? ? defaultthemename="textures.xbt"
? ? effectslowdown="0.75"
? ? debugging="false"/>
??<extension point="xbmc.addon.metadata">
? ? <summary>Confluence skin by Jezz_X. (XBMC's default skin)</summary>
? ? <summary lang="nl">Confluence skin door Jezz_X</summary>
? ? <summary lang="zh">Jezz_X開發的Confluence皮膚</summary>
? ? <description>Confluence is the default skin for XBMC 9.11 and above. It is a combination of concepts from many popular skins, and attempts to embrace and integrate their good ideas into a skin that should be easy for first time XBMC users to understand and use.</description>
? ? <description lang="nl">Confluence is de standaard skin voor XBMC 9.11 en hoger. Het combineert de concepten van andere populaire skins, waarbij het tracht hun goede ide&euml;en te integreren in een skin die gemakkelijk in gebruik is.</description>
? ? <description lang="zh">在XBMC 9.11之后的版本中Confluence是默認皮膚。它集合了許多流行皮膚的創意，力求把這些優點融合到一個皮膚中，使得首次使用XBMC的用戶能更容 易上手。</description>
? ? <disclaimer>Confluence is the default skin for XBMC, removing it may cause issues</disclaimer>
? ? <disclaimer lang="nl">Confluence is de standaard XMBC skin, het verwijderen van Confluence kan leiden tot problemen.</disclaimer>
? ? <disclaimer lang="zh">Confluence是XMBC的默認皮膚，刪除它可能導致故障。</disclaimer>
? ? <platform>all</platform>
??</extension>
</addon>

有幾個事項需要注意：

· <addon>元素是必須的，它用于定義擴展功能包的全部信息；

· <addon>元素中包括一個<requires>子元素，用于列示此擴展功能運行所依賴的項目；

· 然后是一個或多個<extension>子元素，每個描述一項XBMC的擴展功能；

· 最后，有一個特殊的<extension>子元素用于向用戶說明這個擴展功能模塊。

<addon>元素

addon元素有4個屬性：id、version、name和provider-name。

· id屬性是此擴展功能的唯一性標識。它必須是唯一性的，只能使用小寫字母和半角點號、下劃線、連字符以及數字。這個標識符同時用于保存此擴展功能模塊的目錄名。為便于查找，建議使用類似<擴展功能類型>.<唯一性名稱>的形式。

· version屬性由XBMC用來判斷是否有可用更新，你可以采用類似1.0.3的形式。

· name屬性是擴展功能在用戶界面中顯示的名稱，應該采用英文，XBMC不會對此進行翻譯。

· provider-name屬性是開發者信息，可以是開發團隊或個人。

<requires>元素

requires元素包含一個或多個<import>子元素，用于說明需要依賴的其它擴展功能以及要求的版本。這些擴展功能可能是XBMC內 置的，也可能是第三方開發的外部擴展功能。只有符合版本要求的所有依賴擴展功能都已安裝，當前擴展功能才可以運行。當你通過XBMC的擴展功能管理器從在 線擴展功能庫安裝擴展功能時，XBMC會嘗試自動安裝所依賴的功能模塊。

<extension>元素

extension元素描述此擴展功能的一些技術參數。至少要有一個point屬性指出實現XBMC的哪類功能。例如，上面給出的Confluence皮 膚的addon.xml文件擴展了XBMC的"xbmc.gui.skin"功能。其他可用extension points見后面介紹。

xbmc.addon.metadata extension

所有的擴展功能都必須有這個特殊的extension point，用于向擴展功能管理器的用戶說明此擴展功能。可以包含4個元素，但只有第一個是強制需要的：

· 一個或多個summary元素提供擴展功能的摘要。應該是單個句子。可以被翻譯成多國語言，并用類似lang="ch"屬性標明，沒有標明lang屬性的作為英語處理。

· 一個或多個description元素提供此擴展功能更詳細的介紹，同樣可以翻譯。

· 一個或多個disclaimer元素提供用戶需要注意的事項。這個聲明項不是必須的，可用于說明一些必要的設置，或只能用于特定語種之類。

· 一個platform標簽指明此擴展功能用于哪些平臺（操作系統、硬件）。一些擴展功能可用于所有平臺，則可設置為"all"，你還可以用"linux", "osx", "windx" 和 "wingl"。如果沒有指明可用平臺，默認為可用于所有平臺。

Extension類別

XBMC支持的各種extension points如下：

· xbmc.gui.skin

· xbmc.addon.repository

· xbmc.metadata.scraper.albums

· xbmc.metadata.scraper.artists

· xbmc.metadata.scraper.movies

· xbmc.metadata.scraper.musicvideos

· xbmc.metadata.scraper.tvshows

· xbmc.metadata.scraper.library

· xbmc.ui.screensaver

· xbmc.player.musicviz

· xbmc.python.pluginsource

· xbmc.python.script

· xbmc.python.weather

· xbmc.python.subtitles

· xbmc.python.lyrics

· xbmc.python.library

轉載于:https://blog.51cto.com/songhf/698230

總結

以上是生活随笔為你收集整理的xbmc addons的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。