Forward 预加载功能说明
注意:
Forward 在 1.3.14 版本新增了详情页预加载功能,详见下方具体描述。2026-01-21。
预加载机制
Forward 的预加载功能通过智能缓存管理来优化您的观看体验。当用户开启预加载时,系统会:
1. 智能缓存管理
- 检查用户的缓存状态
- 在片尾区间时自动忽略该区间的缓存请求
- 当前集已经缓存完毕或片尾时间之前的内容已经缓存完毕,则会开始预加载
2. 下一集预加载
- 自动开始缓存下一集开始播放时间点的内容
- 缓存大小根据视频码率动态调整
- 缓存范围: 50M ~ 200M
3. 详情页预加载(NEW)
从 1.3.14 版本开始,Forward 新增详情页预加载功能:
- 当用户在详情页选择资源后,在点击播放之前,会预先加载少量视频数据
- 预加载大小为 3-20MB,根据不同视频具体大小而定
- 当用户点击播放时,可实现近乎即时的起播体验
服务器支持检测
Forward 如何判断服务器是否支持预加载?
目前 Forward 支持 UA 检测、黑名单、Headers 三种方式来判断服务器是否支持预加载。
1. User-Agent 检测(NEW)
Forward 在不同场景下会使用不同的 User-Agent,服务器管理员可以根据 UA 来控制功能开启:
User-Agent 列表
| User-Agent | 使用场景 |
|---|---|
Forward-Standard | 正常播放请求 |
Forward-Preload | 下一集预加载请求 |
Forward-DetailPreload | 详情页预加载请求 |
服务器管理员可以根据请求的 UA 来决定是否允许该类型的请求。例如:
- 允许所有请求:放行全部三种 UA
- 禁用所有预加载:仅放行 Forward-Standard
- 仅禁用详情页预加载:放行 Forward-Standard 和 Forward-Preload
2. Ping 接口 Headers 配置检测
Forward 在启动时会调用服务器接口 GET System/Ping。如果该接口可正常响应,则会开启预加载功能。
服务器可通过响应 Header 控制预加载行为:
响应 Header
| Header | 说明 |
|---|---|
X-Preload-Bytes | 下一集预加载大小限制(字节) |
X-DetailPreload-Bytes | 详情页预加载大小限制(字节) |
配置示例:
- 限制下一集预加载为 100M:
X-Preload-Bytes: 104857600 - 禁用下一集预加载:
X-Preload-Bytes: -1 - 禁用详情页预加载:
X-DetailPreload-Bytes: -1
注:下一集预加载上限为 200M,详情页预加载为动态调整
3. 黑名单
如果服务器在黑名单中,则 Forward 会认为服务器不支持预加载。
如何开启预加载
作为 APP 使用者
你可以在 设置 - 缓存 中开启视频缓存,并开启以下功能:
- 预缓存下一集:在观看过程中预加载下一集内容
- 详情页起播加速:在详情页选择资源后预加载,加速起播(需服务器支持)
作为服务器管理员
如果想进行黑名单的添加:
- 通过 Telegram 联系 @ForwardPreloadBot
- 提交您的服务器一级域名,并附上域名所属证明
我们会尽快处理您的申请。
适用版本:1.2.10(186) 及以上
详情页预加载:1.3.14 及以上