# MediaEdit **Repository Path**: pengyoucongcode/media-edit ## Basic Information - **Project Name**: MediaEdit - **Description**: 基于原生实现的图片、视频编辑工具,一切以功能实现为需要而打造的UI极简的轻量工具 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-07 - **Last Updated**: 2026-11-14 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # MediaEdit 一个完全本地运行的图片 / 视频编辑 App,重点是**去掉相机水印**。没有账号、没有社区、不上传任何素材,选片 → 编辑 → 写回相册,全程在手机上完成。 自己拍的照片带机型 / 时间 / 地点水印,又不想为了擦一行字去开电脑修图,这个 App 就是为这个场景写的。 - 语言:Kotlin + Jetpack Compose - 最低系统:Android 7.0(API 24) - 许可证:[MIT](LICENSE) ## 功能 ### 图片编辑 | 工具 | 说明 | | --- | --- | | 比例 / 旋转 / 滤镜 | 常用的构图与调色 | | 文字 | 可拖动、可改字号与颜色 | | 去水印 | 手指涂抹要擦掉的区域,三种修复方式任选(见下) | ### 视频编辑 | 工具 | 说明 | | --- | --- | | 裁剪 / 旋转 / 比例 / 滤镜 | 基于 Media3 Transformer 的效果链 | | 音频 | 保留或删除原声、加一段配乐、调音量 | | 文字 | 叠加字幕式文字 | | 去水印 | AI / 智能 / 马赛克三档,拖时间轴逐帧涂蒙版、逐帧处理 | ### 素材来源 - 系统相册选片(Photo Picker) - 其它 App 通过系统"分享"送进来的内容:文件流,或者带链接的文案 - 粘贴公开链接解析直链:跟随重定向、在页面元信息 / 内嵌 JSON 里找候选地址并验真。需要登录态、签名或风控拦截的站点(小红书、抖音等)通常拿不到真实地址,此时会如实报错并提示改用系统分享——**不做登录绕过,也不碰付费墙和防盗链签名**。 ## 去水印是怎么做的 手刷一个蒙版(半透明笔触),修复只作用在蒙版覆盖的像素上,蒙版外保持原像素。图片页有三种方式: ### 1. AI 修复(推荐) 端侧跑 [big-lama](https://github.com/advimman/lama) 的 fp16 ONNX 权重,用 ONNX Runtime 推理。 - **模型不随 APK 分发**:约 98MB,第一次点"下载"时才拉到应用私有目录(`files/models/lama_fp16w.onnx`),之后离线可用。下载完成后按文件大小 + SHA-256 双重校验,两处同时下载会被串行化,避免交叉写坏同一个临时文件。 - **断点续传**:数据先写 `lama_fp16w.onnx.part`,熄屏、断网、切走页面、进程被杀都不会丢掉已下的部分。下次点"继续下载"用 HTTP Range 从断点接着拉,并带 `If-Range`(ETag)确认源文件没换过;连接中途断了会自动重连续传(最多 6 次)。下载期间持一个 partial wake lock,熄屏不会把 CPU 挂住。 - **ROI 裁剪**:只把蒙版外接矩形外扩一圈上下文送进网络,等比缩放到 256..640 并对齐到 8 的倍数,整图推理在手机上太慢。 - **羽化回贴**:网络输出缩回 ROI 尺寸后,按羽化后的蒙版混回原图,避免硬边。 - **失败自动回退**:模型没就绪、下载失败或推理异常时,自动改用本地算法并提示,不会把编辑卡死。 实测(2000×1500 的相机水印照,ROI 约 700×180):单张 3.6s 左右(第二次起复用 session),水印区纯白像素占比 9.7% → 0.002%,修复区与周边平均亮度差 0.85,颗粒与接缝能自然接上。 ### 2. 智能修复(纯本地,无需模型) 没有模型也能用的纹理合成算法,思路是"先定颜色,再补纹理": - 用 Criminisi 式的整块复制填充,源块按置信度与匹配代价挑选,并做 DC 对齐,防止整块复制带来的色差; - 在平坦但有细颗粒的背景上(石板、水泥、墙面),整块复制会出现相位不连续,于是改成"外围高频移植":盒式模糊得到低频底,再逐像素从周围已知区域随机采样高频残差叠上去; - 根据外围的高频能量自动判断该走哪条路径。 这一档速度快(一张 2000×1500 约 0.19s),适合背景规整的图;复杂结构(横竖正交的栅栏、密集文字、人像边缘)效果不如 AI。 ### 3. 马赛克遮盖 实在处理不了时把区域糊掉,比留一行水印体面。 ### 视频去水印:解帧 → 逐帧修 → 合成 把视频当成一串图片来处理,不是一点导出就打包: 1. **解帧**:进页面就把画面摊成一条缩略图,点哪张就落到哪一帧(`OPTION_CLOSEST` 精确解码,不是最近的同步帧); 2. **逐帧涂蒙版**:在哪一帧上涂抹就生成那个时刻的蒙版,最多 12 个,每段只管自己附近的时间;也可以“预览本帧”先看看效果; 3. **逐帧修复(不打包)**:按帧解码、按最近的蒙版修复,**只把改动的那一小块写进缓存**,此时不生成任何视频文件,可以拖着逐帧检查、不满意重做; 4. **合成**:确认后才把缓存的小块贴回原帧、编码、混入原音轨写进相册。这一步不重跑推理,所以很快。 为什么只缓存小块:整帧落盘会占几百 MB、还会多一次有损压缩;只存蒙版外接矩形那块 PNG,既无额外画质损失,合成时也能一帧一帧对得上(PTS 对不上就保持原帧,不会错位)。 蒙版之间是“就近切换”,没做位置插值:水印连续移动时中间帧会用较近的那个,多打几个时间点更准。 ### 视频上的 AI 视频走 MediaExtractor → MediaCodec 解码 → 逐帧修复 → 重编码,AI 档每帧都跑一次 LaMa。逐帧推理最大的两个问题是慢和闪,这里各有一个对策: - **相似帧复用**:把当前帧 ROI 缩成 32×32 的灰度签名,与上一帧差异很小时直接套用上次的修复结果。固定机位大部分帧都不推理,既快又稳;镜头一动就自动退回逐帧推理。 - **预算与确认**:点"逐帧修复"前会按帧数给出最坏耗时估算,确认后才开始,中途可随时取消;推理出错、模型缺失时当帧及后续帧自动改用本地算法,并提示原因。 实测:1440×1080、30 帧、机位不动的水印视频,整段导出 9.5s(水印区纯白像素占比 9.7% → 0.11%);画面每帧都在变时单帧推理约 1 秒(ROI 214×104、输入 448)。 ### 视频的另外两档 “智能修复”和“马赛克遮盖”与图片版是同一套算法,只是逐帧套用各自时间点最近的蒙版,不需要模型。 ## 构建 需要 Android Studio(Hedgehog 或更新)和 JDK 17。 ```bash git clone https://gitee.com/pengyoucongcode/media-edit.git cd media-edit ./gradlew :app:assembleDebug ``` 用到的关键依赖: | 依赖 | 版本 | 用途 | | --- | --- | --- | | Jetpack Compose BOM | 2023.08.00 | UI | | AndroidX Media3(transformer / effect / exoplayer) | 1.3.1 | 视频效果链与转码导出 | | ONNX Runtime Android | 1.20.0 | 端侧推理 | | ExifInterface | 1.3.7 | 读写旋转信息 | ## 测试 仪器测试共 23 项,覆盖图片 / 视频去水印(含 AI 逐帧、相似帧复用、蒙版随时间切换、逐帧缓存与二阶段合成)、音轨增删、链接导入、分享接收: ```bash ./gradlew :app:connectedAndroidTest ``` `AiInpaintTest` 需要真机上存在模型文件,没有时自动跳过(`assumeTrue`)。想手动跑的话: ```bash adb push lama_fp16w.onnx /data/local/tmp/ adb shell run-as com.pyc.mediaedit mkdir -p files/models adb shell run-as com.pyc.mediaedit cp /data/local/tmp/lama_fp16w.onnx files/models/ ``` 另外几项测试依赖放在 `Android/data/com.pyc.mediaedit/files/` 下的测试素材(照片、视频),没有素材时会跳过。 ## 目录结构 ``` app/src/main/java/com/pyc/mediaedit/ ├── editor/ │ ├── EditorApp.kt 入口与导航(首页 / 图片 / 视频) │ ├── ImageEditorScreen.kt 图片编辑 │ ├── VideoEditorScreen.kt 视频编辑 │ ├── WatermarkRemovalScreen.kt 图片去水印(手刷蒙版 + 三种修复方式) │ ├── VideoWatermarkScreen.kt 视频去水印 │ ├── render/ │ │ ├── InpaintEngine.kt 去水印引擎接口 + 本地实现 │ │ ├── Inpainter.kt 纹理合成 / 逐帧修复算法 │ │ └── ai/ LaMa 端侧推理与模型下载 │ ├── export/ 图片、视频、音轨导出,写回相册 │ ├── remote/ 链接解析与网络素材导入 │ ├── media/ model/ components/ ├── ui/theme/ └── MainActivity.kt ``` ## 已知限制 - AI 逐帧每帧推理约 1 秒,长视频请优先用固定机位拍摄,或改用智能修复; - 视频蒙版最多 12 个,蒙版间是“就近切换”、没做位置插值,连续移动的水印需要多打几个时间点; - 链接解析对需要登录或风控较严的平台无能为力,请改用系统分享; - 模型下载走 hf-mirror 镜像,国内可用;换源只需改 `LamaModel.kt` 里的 `DOWNLOAD_URL`。断点续传依赖服务端支持 HTTP Range(该镜像支持);若换的源不支持,会自动退回从头下载。 ## 许可 本项目代码以 **MIT** 协议开源,Copyright (c) 2026 彭友聪,见 [LICENSE](LICENSE)。 第三方组件: - **LaMa**(`big-lama` 权重)来自 [advimman/lama](https://github.com/advimman/lama),Apache-2.0;本项目使用的 ONNX 封装来自 [AUXOUT-TEAM/agit-lama-inpainting](https://huggingface.co/AUXOUT-TEAM/agit-lama-inpainting),模型文件不随仓库分发。 - **ONNX Runtime**:MIT。 - **Jetpack Compose / Media3 / AndroidX**:Apache-2.0。