AKS1st/dock-media

README 摘要

dock-media English DSH 生态中最好用的媒体播放插件 —— 没有之一。 MP3、WAV、FLAC、M4A 等纯音频用音乐播放器呈现；MP4、WebM、MOV 等视频支持全屏播放。播放不走整文件 base64，而是 流式（HTTP Range / 206 分片） 读取，大文件也能秒开、随时拖动进度条。 dock 系列的媒体播放插件：为 dock-files 文件域注册 media 文件查看器（音频 + 视频扩展名）与对应的编辑器区视图，通过自己的 /dock-media/source 主机路由流式传输媒体字节（支持 Range 分段请求，便于 / 元素边看边下、拖拽定位）。 效果预览 功能 - 双模式播放 ：纯音频（MP3/WAV/OGG/OPUS/FLAC/AAC/M4A/WebA…）进入 音乐播放器 （旋转唱片 + 均衡器动画 + 自定义走带条）；视频（MP4/M4V/WebM/MOV/MKV/OGV/AVI/TS/3GP…）进入 原生视频播放器 ，带全屏播放。 - 流式传输 ：不同于 dock-images 的整文件 base64，dock-media 通过 /dock-media/source 直接流式返回文件字节，支持 HTTP Range → 206 Partial Content + Accept-Ranges: bytes ，因此大文件也能秒开、拖拽进度条、边下边播， 不会把整个文件读进内存 。 - 全屏 ：视频与音乐播放器都支持一键全屏（浏览器 Fullscreen API，容器全屏；不可用时退化为固定 inset:0 覆盖层）。全屏时头部变为半透明悬浮条，沉浸式观看。 - 音乐播放器 ：播放/暂停、拖动进度、当前/总时长、音量、静音、播放速度（0.5x–2x）、单曲循环；旋转唱片 + 均衡器随播放状态动效。 - 格式徽章与大小 ： /dock-media/probe 返回文件大小与媒体种类，头部实时显示 .MP3 / .MP4 徽章与大小。 - 优雅降级 ：浏览器无法解码的封装/编码（如 AVI、FLV、WMV、MPG、MIDI、WMA）会给出提示，而不是黑屏/转圈。 - 安全渲染 ：媒体通过 src 交给原生 / 解码，绝不做 innerHTML / 危险 DOM 注入。 支持格式 类别 扩展名 音频 mp3, wav, ogg, oga, opus, flac, aac, m4a, weba, wma, mid, midi 视频 mp4, m4v, webm, mov, mkv, ogv, avi, mpg, mpeg, flv, wmv, ts, 3gp 说明：浏览器能否解码头由 解码器 决定，与容器/扩展名无必然关系。 mp4 (H.264)、 webm (VP8/VP9/AV1)、 mp3 、 flac 、 o…

分类