mirror of
https://github.com/algerkong/AlgerMusicPlayer.git
synced 2026-05-18 19:47:29 +08:00
27 lines
1.2 KiB
TypeScript
27 lines
1.2 KiB
TypeScript
|
// local:// 协议 URL 拼接工具
|
|||
|
|
// 主进程与渲染进程共用，确保所有本地文件 URL 走同一套编码策略，
|
|||
|
|
// 否则音频/封面/缓存/下载在 edge-case 上行为分裂。
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 把绝对文件路径转成 local:// 协议 URL。
|
|||
|
|
*
|
|||
|
|
* 编码顺序：
|
|||
|
|
* 1. \\ -> /（Windows 路径规范化）
|
|||
|
|
* 2. 按路径段 encodeURIComponent，再用 / 拼回去
|
|||
|
|
*
|
|||
|
|
* 不直接对整条路径 encodeURIComponent：它会把 / 编码成 %2F，注册为 standard 的
|
|||
|
|
* local:// 协议在 Chromium 解析含 %2F 的 path 时存在边界差异。
|
|||
|
|
* 按路径段编码可以保留目录分隔符，同时正确处理空格、中文、#、?、% 等特殊字符。
|
|||
|
|
*
|
|||
|
|
* 必须编码而不是裸拼：Image loader（含 crossOrigin='Anonymous' 时）对未编码空格
|
|||
|
|
* 比 audio.src 严格——封面常落到 "Application Support" 这类含空格目录会加载失败。
|
|||
|
|
*
|
|||
|
|
* 主进程 fileManager 用 decodeURIComponent 还原；它是 encodeURIComponent 的逆，
|
|||
|
|
* 能解码本函数产生的全部 %XX。
|
|||
|
|
*/
|
|||
|
|
export function filePathToLocalUrl(absPath: string): string {
|
|||
|
|
const normalized = absPath.replace(/\\/g, '/');
|
|||
|
|
const encoded = normalized.split('/').map(encodeURIComponent).join('/');
|
|||
|
|
return `local:///${encoded}`;
|
|||
|
|
}
|