第十三章 xbmc插件编写教程.docx

一、插件的结构每个插件保存在各自的文件夹里，打开xbmc插件的安装目录addons，可以看到很多安装好的插件的文件夹。一个典型的视频插件的文件夹里通常要有这三个文件：addon.xml：说明文件，用来告诉xbmc该插件所提供的内容以及安装要求；icon.png：图标文件，256x256像素，xbmc插件清单旁边显示的就是这个图标；*.py：python主程序文件，名字随便起，addon.xml中有一项会用到这个文件名。如果插件的子程序和用到的数据较多，可以在下面再开子文件夹来保存。重点看addon.xml的结构：首先第一行申明这是一个xml文件，且是utf-8编码的，接着是addon元素，在addon和/addon之间，有一个或多个extension元素，每个extension告诉xbmc这个插件扩展了哪一部分的功能，只有最后一个extension比较特别，只是用来向用户做个说明。addon元素有4个属性：id, version, name, provider-nameid属性：插件id，必须是唯一的，小写，插件zip文件解压后，以id命名文件夹，所以不能重名，建议以plugin.类别.唯一名的形式命名，类别可以是video, audio, script等；version属性：插件版本号，格式为x.x.x，xbmc用来确定是否应升级插件；name属性：插件名称；provider-name属性：插件作者。extension元素通过point属性告诉xbmc该插件扩展的类型，有多种类型，用python写的视频插件属xbmc.python.pluginsource类型，同时还应加上一个library属性告诉xbmc启动插件时运行哪个python程序。providesvideo/provides告诉xbmc这是对视频功能的扩展。最后一个xbmc.addon.metadata类型的extension元素用来说明插件的运行环境、摘要、详情、申明等，英文的必须有，中文的可有可无。插件做好后，把所有文件压缩进zip文件包中发行，xbmc在安装插件时会检查其中的addon.xml，确认格式无误后，才把它解压到addons目录下，成为一个可用的插件。二、做一个hello world版的插件很多计算机语言的教程开篇都有“hello world”的最简单的例子，让读者马上体验一下该编程语言的特点，在这里我们也做一个最简单的xbmc插件，只要会复制粘贴就能做出来。它显示一个“Hello, World!的菜单，点击菜单可看一则网络视频。做法：1、在xbmc的插件目录addons下新建一个子目录plugin.video.hello，它的目录名也是插件的id名，用来存放插件的3个文件2、把下面的icon.png文件拷进新建的目录3、用记事本编辑和保存一个名为addon.xml的文件，内容如下：?xml version=1.0 encoding=UTF-8 standalone=yes?addon id=plugin.video.hello name=helloworld演示 version=0.0.1 provider-name=Tau extension point=xbmc.python.pluginsource library=helloworld.py providesvideo/provides /extension extension point=xbmc.addon.metadata platformall/platform summaryhello world plugin/summary summary lang=zhhelloworld演示插件/summary descriptionhello world plugin, python script/description description lang=zhhelloworld演示插件，python脚本/description disclaimerFor demonstration only/disclaimer /extension/addon4、再用记事本生成一个名为helloworld.py的文件，内容如下：# -*- coding: utf-8 -*-# helloworld.py# hello world demoimport xbmcplugin, xbmcguiurl=/asset/2012/03/27/BTV1183405049_742928_23560.mp4handle=int(sys.argv[1])listitem=xbmcgui.ListItem(Hello, World!)xbmcplu