XBMC 插件仓库项目结构及使用指南

1. 项目目录结构及介绍

本项目是基于 XBMC（现在称为 Kodi）插件的仓库，包含了多个插件和脚本。以下是项目的目录结构及各部分的简要介绍：

seppius-xbmc-repo/
├── addons.xml           # 插件清单文件
├── addons.xml.md5       # 插件清单文件的MD5校验文件
├── addons_xml_generator.py  # 生成addons.xml文件的脚本
├── @generate.py         # 生成插件信息的脚本
├── .gitignore           # Git忽略文件列表
├── LICENSE              # 项目许可证文件
├── README.md            # 项目说明文件
├── pre-commit.sh        # Git提交前检查脚本
├── repository.seppius.zip  # 压缩后的仓库文件
├── script.*             # 多个Python脚本文件，用于实现各种功能
├── service.*            # 服务脚本文件
├── skin.*               # 皮肤相关文件
├── repository/          # 仓库目录，包含多个子仓库
│   ├── repository.seppius/
│   ├── repository.arneson/
│   ├── repository.const/
│   ├── ...
├── plugin.video.*       # 视频插件目录
│   ├── plugin.video.1kinobig.ru/
│   ├── plugin.video.1tv-latest-news/
│   ├── ...
├── ...                  # 其他插件和脚本文件

• addons.xml：这是 XBMC 插件系统用来识别插件的清单文件，它列出了所有可用的插件。
• addons.xml.md5：用于验证 addons.xml 文件的完整性。
• addons_xml_generator.py：一个 Python 脚本，用于生成 addons.xml 文件。
• @generate.py：生成插件元数据的脚本。
• .gitignore：指定在 Git 版本控制中应该忽略的文件和目录。
• LICENSE：项目的许可证信息，本项目遵循 GPL-2.0 许可。
• README.md：项目的说明文件，通常包含项目信息和如何使用它的指南。
• pre-commit.sh：一个 shell 脚本，用于在提交前执行一些检查。
• repository.seppius.zip：压缩后的仓库文件，可以用于备份或部署。
• script.*、service.*、skin.*：包含实现不同功能的 Python 脚本、服务脚本和皮肤文件。
• repository/：包含子仓库的目录。
• plugin.video.*：视频插件目录，包含用于流媒体播放的插件。

2. 项目的启动文件介绍

在 XBMC 插件系统中，通常没有一个单一的“启动文件”。插件的启动是通过用户在 XBMC 界面中的交互触发的。然而，addons.xml 文件是核心，它定义了插件的存在和如何与 XBMC 系统交互。

addons.xml 文件通常包含如下内容：

<addons>
  <addon
    id="plugin.video.example"
    name="Example Video Plugin"
    version="1.0.0"
    provider-name="Your Name">
    <extension
      point="xbmc.plugin"
      library="default.py">
      <provides>
        <media>video</media>
      </provides>
    </extension>
    <requires>
      <import library="xbmcgui" />
      <import library="xbmcplugin" />
    </requires>
  </addon>
</addons>

这段代码定义了一个名为“Example Video Plugin”的插件，指定了它的 ID、名称、版本和提供者。library="default.py" 指定了插件的入口点。

3. 项目的配置文件介绍

XBMC 插件通常使用 JSON 或 XML 格式的配置文件来存储用户设置的偏好。这些配置文件通常位于插件的 resources/settings/ 目录中。

例如，一个配置文件可能看起来像这样：

{
  "appearance": {
    "theme": {
      "name": "Default",
      "description": "Default theme"
    },
    "font_size": {
      "name": "Font Size",
      "description": "Select font size",
      "type": "slider",
      "min": 1,
      "max": 5,
      "step": 1,
      "default": 3
    }
  }
}

这个配置文件定义了外观设置的部分，包括主题和字体大小。在 XBMC 插件中，可以使用内置的函数来读取和写入这些设置，以便根据用户的偏好调整插件的行为。