mirror of
https://github.com/truewhile/MeBox.git
synced 2026-11-15 20:34:23 +08:00
truewhile
93 lines
4.5 KiB
TypeScript
93 lines
4.5 KiB
TypeScript
export type DirectPlayErrorAction = 'ignore' | 'retry' | 'fallback'
|
||
|
||
const MEDIA_ERR_ABORTED = 1
|
||
const HAVE_CURRENT_DATA = 2
|
||
|
||
/** 程序化续播/跳转后忽略直连误报的宽限期（毫秒）。 */
|
||
export const DIRECT_SEEK_GRACE_MS = 12_000
|
||
|
||
/** 直连起播看门狗的等待上限（毫秒）。 */
|
||
export const DIRECT_STALL_TIMEOUT_MS = 6_000
|
||
/** STRM / 云盘直链要等 302 换链，冷启动比本地文件慢，给长一点的期限。 */
|
||
export const DIRECT_STALL_TIMEOUT_STRM_MS = 12_000
|
||
/**
|
||
* 没有可退线路（远程 Emby 挂载、客户端直连解码）时的等待上限。
|
||
*
|
||
* 这两种源都不在宿主机转码，等不到数据时没有任何补救动作——唯一的输出是给用户
|
||
* 一条提示，所以宁可多等：跨网上游的冷启动实测要 8–11 秒才吐第一段数据，6 秒
|
||
* 就判失败只会把「上游慢」写成「浏览器不支持这个编码」，而画面其实几秒后就播上了。
|
||
*/
|
||
export const DIRECT_STALL_TIMEOUT_NO_FALLBACK_MS = 20_000
|
||
|
||
/**
|
||
* 起播看门狗该等多久才把「还没起来」当成「起不来」。
|
||
*
|
||
* canFallback=false：直连失败没有可切的线路（远程 Emby / 直连解码），失败提示
|
||
* 是唯一产出，所以要容忍慢启动。canFallback=true：还能切 HLS，早点换线路对用户
|
||
* 更有利，保持较短期限。
|
||
*/
|
||
export function directStallTimeoutMs(input: { isStrm?: boolean; canFallback: boolean }): number {
|
||
if (!input.canFallback) return DIRECT_STALL_TIMEOUT_NO_FALLBACK_MS
|
||
return input.isStrm ? DIRECT_STALL_TIMEOUT_STRM_MS : DIRECT_STALL_TIMEOUT_MS
|
||
}
|
||
|
||
/** 直连起播失败的两类起因：看门狗等超时（上游一直没数据）/ 媒体元素真的报了 error。 */
|
||
export type DirectPlayFailureReason = 'stall' | 'error'
|
||
|
||
/** 直连失败时用户看到的来源：远程 Emby 挂载 / 客户端直连解码。 */
|
||
export type DirectPlayFailureKind = 'remote-emby' | 'direct-only'
|
||
|
||
/**
|
||
* 直连失败的横幅与 toast 文案。
|
||
*
|
||
* 超时和真报错的文案必须分开：超时的真实原因是上游慢，不该断言「浏览器不支持这个
|
||
* 编码」（实测最常见的情形就是慢，画面随后自己就播上了）。
|
||
*/
|
||
export function directPlayFailureCopy(
|
||
kind: DirectPlayFailureKind,
|
||
reason: DirectPlayFailureReason = 'error',
|
||
): { banner: string; toast: string } {
|
||
if (reason === 'stall') {
|
||
return {
|
||
banner:
|
||
kind === 'remote-emby'
|
||
? '直接播放失败：远程 Emby 挂载的流长时间没有返回数据（该线路不转码，只能直连）。可稍后重试，或用外部播放器（如 PotPlayer / VLC / IINA）播放。'
|
||
: '直接播放失败：客户端直连解码模式下宿主机不转码，流长时间没有返回数据。可稍后重试，或关闭直连解码模式改用转码播放。',
|
||
toast: '直连流长时间没有响应',
|
||
}
|
||
}
|
||
return {
|
||
banner:
|
||
kind === 'remote-emby'
|
||
? '直接播放失败。该媒体为远程 Emby 挂载直连播放（不进行转码）；当前浏览器可能不支持该视频编码或音频格式，建议使用外部播放器（如 PotPlayer / VLC / IINA）播放。'
|
||
: '直接播放失败。当前为「客户端直连解码」模式，宿主机不转码；请使用支持该编码/封装的播放器（如 Infuse / VLC / Emby 客户端）播放，或关闭直连解码模式。',
|
||
toast: '直接播放失败，建议使用外部播放器',
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Chromium 常把被中断的直连（换 src、插入 track、302 未完成就 seek）
|
||
* 报成 error。真正不兼容应 fallback；瞬时中断应忽略或静默重试一次。
|
||
*
|
||
* seekGraceActive：程序化续播/跳转后的宽限期。115 STRM 在 302 直链上
|
||
* seek 时 Chromium 经常误报 decode/network error，此时绝不能升到 HLS。
|
||
*/
|
||
export function classifyDirectPlayError(input: {
|
||
errorCode: number | undefined | null
|
||
readyState: number
|
||
elementSrc: string
|
||
expectedSrc: string
|
||
alreadyRetried: boolean
|
||
seekGraceActive?: boolean
|
||
}): DirectPlayErrorAction {
|
||
const code = input.errorCode ?? 0
|
||
if (code === MEDIA_ERR_ABORTED) return 'ignore'
|
||
if (input.readyState >= HAVE_CURRENT_DATA) return 'ignore'
|
||
if (!input.elementSrc) return 'ignore'
|
||
if (input.expectedSrc && input.elementSrc !== input.expectedSrc) return 'ignore'
|
||
// 续播 seek 宽限期内：误报很常见，且 retry 会 video.load() 把进度清零，直接忽略。
|
||
if (input.seekGraceActive) return 'ignore'
|
||
if (!input.alreadyRetried) return 'retry'
|
||
return 'fallback'
|
||
}
|