播放器、水印、片头与预览

TubePress 使用 FluidPlayer（一款打包在 vendor/fluidplayer 中的自托管 HTML5 播放器）播放上传的视频和基于 URL 的视频。围绕它有几个在转码过程中生成的功能—水印、片头和片尾片段、帧预览缩略图—以及列表卡片上显示的悬停预览。

播放器行为在外观 → 观看下配置；水印、片头和时间轴功能位于各自的 /admin/settings?tab=transcode 子标签页，因为它们是编码到视频中的，而不是在播放时切换的。

视频播放器

对于上传的或基于 URL 的视频，TubePress 会渲染一个 <video> 元素，每个渲染版本对应一个 <source>，并在其上初始化 FluidPlayer。由于每个渲染版本都作为独立来源列出并标注其质量等级（720p 及以上标记为 HD），播放器会显示内置的质量选择菜单。强调色跟随主题的主色，控件在播放时会自动隐藏。

该捆绑包附带了自适应流（HLS 和 MPEG-DASH）、WebVTT 和 360°/VR 播放的模块，因此在需要时可以处理纯 MP4 以外的格式。携带嵌入代码的视频会完全绕过 FluidPlayer，转而渲染其源 iframe。

水印

水印是叠加在视频上的徽标。在 TubePress 中，它是在转码期间由 FFmpeg 编码到每个渲染版本中的，而不是由播放器绘制的—因此它无法在客户端被去除，但确实需要转码，且仅出现在您启用它之后处理的视频上。在水印子标签页中进行配置：

编辑器中的实时预览大致显示叠加层的位置，但最终水印由 FFmpeg 在下次编码时应用。

片头预播

您可以在每个视频前添加一段短片—一个预播片头—并在视频后附加一个后播片尾，两者都在片头子标签页中设置。每个都是 MP4 上传，存储在 uploads/intros/ 下。与水印一样，它们是编码的一部分：在转码过程中，每个片段都会被重新编码以匹配每种输出格式的精确分辨率、编解码器和比特率，然后无缝拼接，因此没有中途的质量跳变。

对于在播放器内部播放而非编码到文件中的广告片段，请改用 广告 系统中的 VAST 前/中/后贴片广告。

时间轴预览

时间轴预览是拖动进度条时出现的小缩略图。在时间轴子标签页中，启用生成时间轴截图会使转码器构建一个帧精灵图及 timeline.vtt 映射文件，FluidPlayer 准备好后会自动将其连接到进度条。

精灵图作为独立的队列任务生成，因此预览可能在视频本身发布后不久出现。

悬停预览

与播放器分开，列表卡片在访客悬停时会播放一段短预览片段—一个真实的每视频 preview.mp4，而不是时间轴精灵图。这由主题外观选项中的卡片悬停设置控制，让浏览者无需打开观看页面就能快速预览每个视频。

播放器设置

打开外观 → 观看来控制播放器。这些选项仅适用于上传的和基于 URL 的视频，不适用于嵌入视频。

同一页面还可切换播放器周围显示的元数据—观看次数、时长、发布日期、点赞/踩以及收藏按钮，以及演员、频道、分类和标签部分—并设置侧边栏显示多少个相关视频（2–20 个）。

下一步