XBMC新版“擴(kuò)展功能”簡介

目錄 1. 擴(kuò)展功能模塊結(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）中采用的擴(kuò)展功能管理系統(tǒng)。XBMC要推出的這個(gè)新插件系統(tǒng)使得第三方開發(fā)的增強(qiáng)功能可以被用戶直接通過XBMC內(nèi)置用戶界面獲取。這個(gè)插件系統(tǒng)基于插件功能庫

c-pluff

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

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

圖片文件指引

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

icon.png

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

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

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

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

· 建議采用在平面背景（非透明）下的logo圖標(biāo)形式（例如采用擴(kuò)展功能在線獲取媒體的服務(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是一個(gè)很重要的文件，它告訴XBMC這個(gè)擴(kuò)展功能模塊是干嗎的（比如是哪一類擴(kuò)展功能）以及要依賴哪些擴(kuò)展功能、正常運(yùn)行需要的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是默認(rèn)皮膚。它集合了許多流行皮膚的創(chuàng)意，力求把這些優(yōu)點(diǎn)融合到一個(gè)皮膚中，使得首次使用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的默認(rèn)皮膚，刪除它可能導(dǎo)致故障。</disclaimer>
? ? <platform>all</platform>
??</extension>
</addon>

有幾個(gè)事項(xiàng)需要注意：

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

· <addon>元素中包括一個(gè)<requires>子元素，用于列示此擴(kuò)展功能運(yùn)行所依賴的項(xiàng)目；

· 然后是一個(gè)或多個(gè)<extension>子元素，每個(gè)描述一項(xiàng)XBMC的擴(kuò)展功能；

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

<addon>元素

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

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

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

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

· provider-name屬性是開發(fā)者信息，可以是開發(fā)團(tuán)隊(duì)或個(gè)人。

<requires>元素

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

<extension>元素

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

xbmc.addon.metadata extension

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

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

· 一個(gè)或多個(gè)description元素提供此擴(kuò)展功能更詳細(xì)的介紹，同樣可以翻譯。

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

· 一個(gè)platform標(biāo)簽指明此擴(kuò)展功能用于哪些平臺（操作系統(tǒng)、硬件）。一些擴(kuò)展功能可用于所有平臺，則可設(shè)置為"all"，你還可以用"linux", "osx", "windx" 和 "wingl"。如果沒有指明可用平臺，默認(rèn)為可用于所有平臺。

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)容還不錯(cuò)，歡迎將生活随笔推薦給好友。