fix(emby): 电影条目不下发空的 SeasonId/SeriesId,修复小幻影视起播失败

小幻影视(RodelPlayer)2.2610 会把电影条目的 SeasonId 空串原样传进自己的
播放准备逻辑并抛 ArgumentException(Parameter 'seasonId'),客户端日志里
表现为 failedStage=PreparationFailed、playback generation null,也就是
点播放立刻「播放失败」;剧集条目的 SeasonId 非空,所以同一台设备放剧集正常。

Emby/Jellyfin 对「不适用」的字段是直接不下发(JSON 里没有该键)而不是下发空串。
这里对非剧集条目省略 SeasonId/SeriesId/SeasonName/SeriesName(顺带去掉电影被
标成「特别篇」的 SeasonName),剧集则保留真实季/剧信息、只清空值。

同时回退上一版针对 115 直链 UA 绑定的同源一跳改动:客户端日志显示该客户端的
播放器层与 API 层 UA 是一致的(剧集走服务端换链后的一跳直连可以正常解码播放),
不需要为此牺牲起播速度。
This commit is contained in:
truewhile
2026-09-28 22:51:40 +08:00
parent 1d73374fff
commit 8136e6ecb1
6 changed files with 117 additions and 235 deletions
-35
View File
@@ -86,36 +86,6 @@ func setCloudRedirectNoStore(w http.ResponseWriter) {
// 由 /api/strm/play 再去换链,最坏情况只是回到改动前的行为。
const directPlayResolveTimeout = 10 * time.Second
// clientSideSTRMResolveKey 标记「本次播放由客户端自己换取 strm 直链」。
type clientSideSTRMResolveKey struct{}
// WithClientSideSTRMResolve 让本次播放跳过「服务端换链后直接 302 到 CDN」的短路,
// 改为 302 到同源的 strm 播放端点,由客户端自己的请求去换取直链。
//
// 为什么需要它:115 等网盘的直链与「换取直链时提交的 User-Agent」逐个字符严格
// 绑定,换错一个字符 CDN 一律 403。服务端短路换链用的是当前请求的 UA,而真正
// 拉流的是客户端的播放器组件;当客户端的 API 层与播放器层 UA 不一致时
// (例如小幻影视 / RodelPlayer:API 请求带 "(Windows NT 10.0.26200; x64)" 后缀、
// 播放器拉流仍是裸 UA),客户端会拿到与自身 UA 不匹配的直链,CDN 返回 403,
// 表现为「播放失败」。交给客户端自己请求同源端点换链,换链用的就是播放器真实 UA。
//
// 浏览器(含 WebView / Electron)的 XHR 与 <video> 拉流必然是同一个 UA,
// 不需要走这条路径。
func WithClientSideSTRMResolve(ctx context.Context) context.Context {
if ctx == nil {
return nil
}
return context.WithValue(ctx, clientSideSTRMResolveKey{}, true)
}
func clientSideSTRMResolve(ctx context.Context) bool {
if ctx == nil {
return false
}
enabled, _ := ctx.Value(clientSideSTRMResolveKey{}).(bool)
return enabled
}
// resolveDirectPlayTargetURL 尝试在服务端把 strm 目标解析成客户端可直接拉取的
// 最终直链,供调用方直接 302。
//
@@ -126,11 +96,6 @@ func (s *StreamService) resolveDirectPlayTargetURL(r *http.Request, raw string)
if s == nil || s.strmResolve == nil || r == nil {
return "", false
}
// 调用方声明该客户端的拉流 UA 与本次请求 UA 不保证一致(见
// WithClientSideSTRMResolve):服务端换出来的直链会绑定错误的 UA,必须放弃短路。
if clientSideSTRMResolve(r.Context()) {
return "", false
}
ctx, cancel := context.WithTimeout(r.Context(), directPlayResolveTimeout)
defer cancel()
// 必须带播放器 UA:115 直链绑定换取时的 UA,且按 UA 分键缓存,换错会拿到