Releases
v8.1.2
Compare
Sorry, something went wrong.
No results found
概述
桌面客户端下载草稿到本地时,此前会把素材的绝对路径写进草稿 JSON,导致草稿一旦移动或改名素材就断链,且路径能否对上取决于服务端的运行目录。本次把落盘前的素材路径统一归一化为剪映自身的相对路径写法,使下载到本地的草稿具备可移植性。
改动范围仅限桌面客户端,服务端生成的草稿内容未作变动,仍由客户端在写入磁盘前完成归一化。
改动内容
新增草稿路径工具模块,实现与剪映一致的相对路径写法:素材路径使用剪映的「草稿目录占位符前缀 + 草稿内相对路径」形式,不再写入绝对路径。
路径归一化只针对确实位于草稿目录内的素材。远程 http 与 https 地址、以及指向草稿目录之外的路径均保持原样,避免破坏外部引用型草稿。
依据素材路径的实际形态推断并写入素材保存模式:素材已收纳进草稿目录时记为「草稿内保存」,仍引用远程地址或草稿目录之外的资源时记为「外部引用」。该模式在远程素材下载完成后重新推断,修正了此前 URL 直写模式下服务端声明与实际落盘状态不一致的问题。
草稿信息文件的本地化:草稿名改写为本地文件夹名,草稿目录与草稿根目录改写为本地路径并统一使用正斜杠,素材登记表中的文件路径同样只保留相对形式。这避免了服务端自身的目录结构随草稿下发到用户机器。
素材根目录名收敛为单一常量,便于将来整体调整目录布局。
占位符标识默认采用剪映内置的常量值,并支持通过环境变量覆盖,兼容不同版本剪映。
新增 14 项单元测试,覆盖绝对路径与相对路径的判定、占位符改写与幂等性、远程地址与草稿目录外路径的放行、素材保存模式的推断,以及草稿信息文件的本地化。
收益
下载到本地的草稿可以自由移动或改名,素材不再断链。
不再依赖服务端运行目录的前缀匹配,非容器化部署同样可用。
草稿中的素材保存模式与实际落盘状态保持一致,减少剪映将素材判为缺失而重新复制的可能。
兼容性说明
服务端生成的草稿 JSON 仍写入绝对路径,由客户端在下载落盘前统一归一化,因此新旧服务端下发的草稿都能得到相对路径结果。
素材仍放置在草稿目录下的 assets 子目录中,而剪映原生使用 Resources/local。占位符前缀的替换与目录名无关,播放解析路径必然成立,但该布局尚未在剪映中实测确认。
验证
客户端单元测试 14 项全部通过。
建议发布前用客户端真实下载一份草稿,在剪映中打开确认素材正常显示与播放。
You can’t perform that action at this time.