【亲测免费】 Jellyfin-Plugin-MetaShark 项目安装与使用教程

1. 项目目录结构及介绍

jellyfin-plugin-metashark/
├── Jellyfin.Plugin.MetaShark/
│   ├── Jellyfin.Plugin.MetaShark.csproj
│   ├── Plugin.cs
│   ├── ...
├── doc/
│   ├── logo.png
│   ├── ...
├── scripts/
│   ├── build.sh
│   ├── ...
├── .gitattributes
├── .gitignore
├── Jellyfin.Plugin.MetaShark.sln
├── LICENSE
├── README.md
├── build.meta.json
├── build.sh

目录结构说明

• Jellyfin.Plugin.MetaShark/: 项目的主要代码目录，包含插件的核心逻辑和功能实现。
  • Jellyfin.Plugin.MetaShark.csproj: 项目文件，定义了项目的依赖和构建配置。
  • Plugin.cs: 插件的主入口文件，包含了插件的初始化和配置逻辑。
• doc/: 文档目录，包含项目的相关文档和资源文件。
  • logo.png: 项目的Logo图片。
• scripts/: 脚本目录，包含项目的构建和部署脚本。
  • build.sh: 构建脚本，用于编译和打包插件。
• .gitattributes: Git属性配置文件。
• .gitignore: Git忽略配置文件。
• Jellyfin.Plugin.MetaShark.sln: 项目的解决方案文件，用于在Visual Studio中打开项目。
• LICENSE: 项目的开源许可证文件。
• README.md: 项目的README文件，包含项目的介绍和使用说明。
• build.meta.json: 构建元数据文件，包含构建相关的配置信息。
• build.sh: 构建脚本，用于编译和打包插件。

2. 项目启动文件介绍

Plugin.cs

Plugin.cs 是 Jellyfin-Plugin-MetaShark 插件的主入口文件，负责插件的初始化和配置。以下是该文件的主要功能：

• 初始化插件: 在插件启动时，初始化插件的配置和依赖项。
• 注册服务: 注册插件所需的服务和组件，确保插件能够正常运行。
• 配置元数据下载器: 配置元数据下载器，用于从豆瓣和TMDB获取电影元数据。

代码示例

public class Plugin : BasePlugin<PluginConfiguration>
{
    public Plugin(IApplicationPaths applicationPaths, IXmlSerializer xmlSerializer)
        : base(applicationPaths, xmlSerializer)
    {
        Instance = this;
    }

    public override string Name => "MetaShark";

    public override Guid Id => Guid.Parse("your-plugin-id");

    public static Plugin Instance { get; private set; }

    // 其他初始化逻辑
}

3. 项目配置文件介绍

PluginConfiguration.cs

PluginConfiguration.cs 文件定义了插件的配置选项，用户可以通过这些配置选项来调整插件的行为。以下是一些常见的配置选项：

• EnableTMDB: 是否启用从TMDB获取元数据。
• EnableAntiBan: 是否启用防封禁功能，避免频繁请求豆瓣导致IP被封。
• JellyfinDomain: Jellyfin服务器的访问域名，用于图片资源的加载。

代码示例

public class PluginConfiguration : BasePluginConfiguration
{
    public bool EnableTMDB { get; set; } = true;
    public bool EnableAntiBan { get; set; } = false;
    public string JellyfinDomain { get; set; } = "http://localhost:8096";

    // 其他配置选项
}

配置文件路径

插件的配置文件通常存储在 Jellyfin 的配置目录中，路径为：

/path/to/jellyfin/config/plugins/MetaShark/config.json

用户可以通过编辑该文件来手动修改插件的配置选项。

总结

通过本教程，您已经了解了 Jellyfin-Plugin-MetaShark 项目的目录结构、启动文件和配置文件。希望这些信息能够帮助您更好地理解和使用该插件。