FFmpeg GUI

截图

网页版

WPF桌面版

架构

项目名	项目名（中文）	介绍
Core	核心	提供Host和WPF、Web的契约以及公共方法
Host	主机	通过NamedPipe向WebAPI发布服务
WebAPI	服务端	使用ASP.NetCore实现的服务器
Web	Web客户端	使用Vue.js实现的网页端
WPF	桌面GUI	桌面端的GUI实现
WebApp	桌面客户端	对WebAPI、Web和Host进行包装的、使用内置浏览器显示的、基于WinForms的桌面客户端（不再使用）

构建与部署

准备工作

确保安装了 .NET 8 SDK：
确保安装了npm（Node.js）：
确保在根目录下（与ReadMe同级目录）的 bin目录中放置了ffmpeg二进制文件（shared版）：下载。共有三个exe文件和若干个dll文件。已测试版本：6.1.1
若要使用媒体信息查询功能，应在根目录（与ReadMe同级目录）下的 bin目录中放置了MediaInfo CLI可执行文件（如MediaInfo.exe）：下载
若要使用编码测试功能，应在根目录（与ReadMe同级目录）下的 bin目录中放置了测试视频 test.mp4和VMAF模型（下载。选取的视频宜为4K分辨率，30秒以上的长度。

自动构建

执行PowerShell：./build.ps1。

参数：

-w：生成Web（Web、WebAPI、Host）
-d：生成WPF（标准、单文件、自包含）

若提示无法加载文件 ******.ps1，因为在此系统中禁止执行脚本，需要首先在管理员模式下运行PowerShell并执行 set-executionpolicy remotesigned，然后按Y确认。生成文件位于 Generation/Publish下，其中 WebPackage为Web部署包，WPF为桌面程序。

部署基于Windows +IIS的Web版本

进入 Generation/Publish/WebPackage
编辑 api的 appsettings.json，主要修改 InputDir和 OutputDir项，指定输入和输出目录。其它修改项详见文件内的注释。
在合适的位置新建一个网站文件夹，将 Generation/Publish/WebPackage内的所有内容复制到新建的文件夹之中。
确保安装了DotNET 8 Hosting Bundle，并在Windows中启用了IIS。
在IIS中新建网站，指定物理目录为之前新建的目录。右键其中的api目录，设置为虚拟应用程序。
运行Host的exe，然后打开设置的url即可使用。

若要在IIS中启用自动启动Host功能，还需要：
1. IIS > 应用程序池。
2. 为网站选择高级设置。
3. 将标识（Identity）更改为 LocalSystem。
4. 重启 IIS。
若输入或输出文件夹位于网络位置等IIS无权限的位置，则需要：
1. 设置 appsettings.json中的 InputDirAccessable和/或 OutputDirAccessable为 false，告知程序无权限访问，那么后端将通过Host对文件进行访问。
2. 关闭通过WebAPI自动启动Host功能，因为自动启动的Host将继承IIS的权限，依旧无法访问。
3. 这种模式下，HTTP上传和下载功能将不可用（懒得写）。

Host启动参数：

-s           (默认： false) 注册开机启动
-u           (默认： false) 取消开机启动
-d           (默认： false) 设置工作目录为程序所在目录
--help       显示帮助信息

开发

项目结构

Core：提供Host和WPF、Web的契约以及公共方法
- Model：数据库实体和相关非结构化数据模型
- Dto：用于API与Host交换、前后端交换的数据结构
- FFMpegArgumentExtension：用于FFMpegCore库上的一些扩展参数
- Manager：对数据和服务的管理
- IPipeService：API与Host之间通信的管道契约
- Logger：日志管理
- MediaInfoModule：调用MediaInfo.dll
Host：通过NamedPipe向WebAPI发布服务
- ConsoleLogger：命令行的Logger
- FtpManager：FTP相关操作
- PipeService：对IPipeService的实现，向WebAPI提供服务
WebAPI：使用ASP.NetCore实现的服务器
- Controllers：控制器，提供Web接口
- Converter：使用JSON序列化数据时用到的转换器
- Dto：与前端交换数据时用到的数据结构
- PipeClient：用于调用Host发布的服务
- TokenFilter：在处理请求之前进行拦截，验证是否带有正确的Token
Web：使用Vue.js实现的网页端
- public：静态文件
- src：Web源码，使用WebPack打包
  - assets：静态资源
  - components：Vue组件
  - router：路由设置
  - views：Vue视图
    - Add：新增任务视图
  - common.ts：一些通用方法
  - main.ts：启动文件
  - net.ts：网络相关（Vue.axios）代码
  - parameters.ts：一些固定参数
WPF：桌面端的GUI实现
- Model：桌面GUI中用到的一些数据结构
- Pages：在主界面右侧显示的页面
- Panels：组成页面或窗口的、具有比较单一的功能的面板
- MainWindow：主窗口
- TestWindow：编码性能测试窗口

注意事项

Clone仓库后，只需安装好相关SDK，即可进行构建，无需额外设置。
libs目录中二进制文件来自于：FzLib和Wpf.Notifications，均为开源产品。
开发者对WPF比较了解，对ASP.NET略有涉猎，但对前端技术技艺不精，因此网页端做得比较简单。欢迎大家在此基础上进行二次开发。

autodotua/RemoteFFmpegGUI