1、立项原因
在线转换工具大致两类:一类把文件上传到服务器再返回结果;另一类是在浏览器里本地转,但转换引擎(几十 MB 的 ffmpeg.wasm 之类)首次要从 CDN 拉取,弱网或断网时首开很慢甚至打不开,之后靠浏览器缓存才变快。两类共同的限制是:格式与编码覆盖不全(AVIF 编码、PSD/HEIC、APNG 等常缺)、受浏览器内存和单文件体积限制、页面关闭即中断、缺少批量与连续处理;桌面老工具则安装臃肿、带捆绑广告、功能要付费解锁。本项目要解决的是 “引擎随包内置、完全离线可用、图片 / 视频 / 音频全格式一次覆盖、不受浏览器内存与会话限制”,做成双击即用的单文件 EXE。
2、行业场景与业务背景
产品属于软件和信息技术服务业中的效率工具(实用工具)细分,形态是本地离线桌面客户端。典型场景:一是自媒体与短视频创作者,需把素材在 MP4、MOV、WebM、GIF 间互转、图片批量转 WebP/AVIF 压体积;二是办公与教育场景,处理课件音频、会议录音的 MP3/WAV/OGG 互转;三是设计与电商场景,把 PSD、HEIC、TIFF 等转成通用格式;四是内网、涉密或弱网环境中不便依赖在线服务时的本地转换需求。
1、功能模块
程序为单文件 Windows EXE(约 37MB),顶部为 PCL 风格标题栏,含「转换器 / 下载 / 设置 / 更多」四个入口,其中「下载」「更多」为预留占位;主体由三大转换模块、设置模块、本地引擎模块组成。
2、主要功能描述
图片转换:支持 JPG、JPEG、PNG、WEBP、AVIF、BMP、TIFF、TIF、SVG、APNG、PSD、HEIC、HEIF 互转,可预设画质与尺寸上限,AVIF 编码器内嵌。
视频转换:支持 MP4、MKV、MOV、AVI、WEBM、WMV、FLV、M4V、TS、MTS、RMVB、RM、GIF 互转,可重新编码视频容器或导出 GIF 动图。
音频转换:支持 MP3、WAV、FLAC、AAC、M4A、OGG、OPUS、ALAC、WMA、APE、AMR 互转,按格式重新封装音频轨道。
通用流程:选择文件 → 选择目标格式 → 显示进度条 → 输出结果列表 → 一键「另存为」指定目录。
引擎与运行:内置 32MB ffmpeg 转码引擎与 AVIF 编码器,转换在后台工作线程执行、界面不卡顿,全程离线、文件不出本机、不需要联网下载引擎。
设置模块:个性化页提供 16 色主题调色与恢复默认紫色,主题色同步应用到标题栏与界面元素,并记住上次选择。
已知边界:PSD、HEIC、HEIF 仅支持作为输入;APE、AMR 无输出编码器;高级转码能力(转码器)在正式版提供。
1、我负责的具体任务
独立完成从立项到交付:界面与交互设计(PCL 风格无边框标题栏、三张转换卡、独立设置页与 16 色调色)、前端单页的开发、WinForms 外壳编写、ffmpeg/AVIF 引擎集成、单文件打包与联调测试,以及下载保存、进度显示、主题同步等细节的实现。
2、技术栈与架构
技术栈:C# 5 /.NET Framework WinForms(无控制台单文件 EXE)、WebView2 内核渲染、原生 HTML/CSS/JS 单页(不使用框架和构建工具)、ffmpeg.wasm 0.12.6(32MB)、@jsquash/avif 编码器,用 csc 的 `/resource` 把页面与引擎全部内嵌,运行时通过内置 TcpListener 启动的本地 HTTP 服务按路由提供。
架构分三层:外壳层(窗口、自绘标题栏、资源服务、下载另存为)↔ 页面层(UI 与业务流程)↔ Worker 引擎层(ffmpeg 解码编码),三层通过 postMessage 传递状态与进度。
3、实现亮点
①把 ffmpeg 移入 Web Worker 执行,转换时界面不再卡死:自测主线程最大卡顿从 2684ms 降到 26–57ms,产物与优化前字节一致;②引擎随包内嵌,首次启动即用、完全离线,不再依赖 CDN 拉取;③接管 WebView2 下载事件,弹出系统「另存为」对话框,用户可自选目录;④主题色在页面与标题栏之间双向同步,深色背景下菜单文字自动转白。
4、主要难点
①在 Blob Worker 中,`importScripts` 必须传入绝对地址,ffmpeg core 的 `mainScriptUrlOrBlob` 必须附带 base64 配置段,否则初始化失败;②把无边框窗口的自绘标题栏、拖动缩放命中测试、最大化与满铺布
声明:本文仅代表作者观点,不代表本站立场。如果侵犯到您的合法权益,请联系我们删除侵权资源!如果遇到资源链接失效,请您通过评论或工单的方式通知管理员。未经允许,不得转载,本站所有资源文章禁止商业使用运营!

下载安装【程序员客栈】APP
实时对接需求、及时收发消息、丰富的开放项目需求、随时随地查看项目状态
评论