XBMC新版“擴展功能”簡介

目錄 1. 擴展功能模塊結(jié)構(gòu) 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類別

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

c-pluff

擴展功能模塊結(jié)構(gòu)

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

圖片文件指引

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

icon.png

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

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

· 它應(yīng)該是256x256的PNG文件；

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

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

fanart.jpg

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

· 它用作背景，所以應(yīng)該簡潔沒有文字內(nèi)容；

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

· 建議在合理范圍內(nèi)盡可能讓文件字節(jié)數(shù)小些，要知道有成千上萬人要下載它。

addon.xml

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

復(fù)制內(nèi)容到剪貼板

代碼:

<?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開發(fā)的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是默認皮膚。它集合了許多流行皮膚的創(chuàng)意，力求把這些優(yōu)點融合到一個皮膚中，使得首次使用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的默認皮膚，刪除它可能導(dǎo)致故障。</disclaimer>
? ? <platform>all</platform>
??</extension>
</addon>

有幾個事項需要注意：

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

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

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

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

<addon>元素

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

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

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

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

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

<requires>元素

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

<extension>元素

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

xbmc.addon.metadata extension

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

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

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

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

· 一個platform標(biāo)簽指明此擴展功能用于哪些平臺（操作系統(tǒng)、硬件）。一些擴展功能可用于所有平臺，則可設(shè)置為"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

轉(zhuǎn)載于:https://blog.51cto.com/songhf/698230

總結(jié)

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

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。