Emby桌面播放器项目启动与配置教程

Emby桌面播放器项目启动与配置教程

emby-player Emby桌面播放器是一款轻量级、高性能的跨平台媒体客户端，专为Emby服务器用户设计。基于Electron和React构建，支持Windows、macOS和Linux系统，提供流畅的HLS流媒体播放体验。应用采用TypeScript开发，结合现代化UI框架Ant Design，为用户带来直观美观的界面。支持直接播放Emby服务器内容，可自定义播放器设置，是媒体爱好者和Emby用户的理想桌面播放解决方案。开源项目，MIT许可证下免费使用，欢迎社区贡献。 项目地址: https://gitcode.com/gh_mirrors/em/emby-player

1. 项目目录结构及介绍

Emby桌面播放器项目采用现代化技术栈构建，项目目录结构清晰。以下是项目的主要目录和文件介绍：

emby-player/                     # 项目根目录
│
├── .github/                      # GitHub 工作流文件
│
├── docs/                         # 文档目录
│
├── public/                       # 公共静态文件目录
│
├── src/                          # 源代码目录
│   ├── assets/                   # 静态资源
│   ├── components/               # 通用组件
│   ├── pages/                    # 页面组件
│   ├── store/                    # 状态管理
│   ├── utils/                    # 工具函数
│   └── App.tsx                   # 应用主组件
│
├── .gitignore                    # Git 忽略文件
├── CHANGELOG.md                  # 更新日志
├── CODE_OF_CONDUCT.md            # 行为准则
├── CONTRIBUTING.md               # 贡献指南
├── LICENSE                       # 开源协议
├── README.md                     # 项目介绍
├── build.sh                      # 构建脚本
├── index.html                    # 入口 HTML 文件
├── main.js                       # 主进程文件
├── package-lock.json             # 依赖锁定文件
├── package.json                  # 项目配置文件
├── preload.js                    # 预加载脚本
├── tsconfig.json                 # TypeScript 配置文件
├── tsconfig.node.json            # Node 环境的 TypeScript 配置文件
└── vite.config.ts                # Vite 配置文件

2. 项目的启动文件介绍

项目的启动主要依赖于 main.js 文件，这是 Electron 的主进程文件。以下是 main.js 文件的主要功能：

• 创建应用的主窗口。
• 加载应用的渲染进程。
• 处理应用的生命周期事件。
• 注册全局快捷键等。

启动应用时，运行以下命令：

npm run electron:dev

此命令会启动 Electron 并加载 main.js 文件，从而启动应用。

3. 项目的配置文件介绍

项目的配置主要通过 package.json 和 vite.config.ts 文件进行。

• package.json：定义了项目的依赖、脚本和元数据。以下是一些重要的配置项：

  "scripts": {
    "electron:dev": "vite run dev",
    "electron:build": "vite build && electron-builder"
  },
  

  这里定义了两个脚本，electron:dev 用于启动开发服务器，electron:build 用于构建生产版本的应用。

• vite.config.ts：Vite 的配置文件，用于配置 Vite 的行为，如代理、环境变量等。以下是一些基本的配置：

  import { defineConfig } from 'vite';
  import react from '@vitejs/plugin-react';
  import { visualizer } from 'rollup-plugin-visualizer';
  
  // https://vitejs.dev/config/
  export default defineConfig({
    plugins: [react(), visualizer()],
    base: process.env.NODE_ENV === 'production' ? '/dist/' : '/',
    // 其他配置...
  });
  

  这里导入了必要的插件，并定义了基本的配置，如应用的基路径等。

通过以上文件的配置，可以顺利启动和运行 Emby桌面播放器项目。

emby-player Emby桌面播放器是一款轻量级、高性能的跨平台媒体客户端，专为Emby服务器用户设计。基于Electron和React构建，支持Windows、macOS和Linux系统，提供流畅的HLS流媒体播放体验。应用采用TypeScript开发，结合现代化UI框架Ant Design，为用户带来直观美观的界面。支持直接播放Emby服务器内容，可自定义播放器设置，是媒体爱好者和Emby用户的理想桌面播放解决方案。开源项目，MIT许可证下免费使用，欢迎社区贡献。 项目地址: https://gitcode.com/gh_mirrors/em/emby-player