SuperAPI AI 工具集

merge-split-av-streams-desktop

通用与其它

查看项目

更新于 10-17 16:15

技能介绍

本技能针对 JVM 桌面端媒体播放场景:自适应流媒体源通常把音频和视频分别以独立 URL 提供,而 JVM 桌面应用内嵌的 C 媒体引擎一般可用内联 edit-list URL 一次命名多个流并同步播放,从而把两路流当作一个播放源使用。

用途与主要能力:把纯视频流和纯音频流合并为一个播放源,结果仍是单个句柄,因此传输控制、位置上报和资源释放逻辑无需改动,也不存在第二个句柄需要同步。技能提供了构建合并 URL 的 Kotlin 示例:以 edl:// 为前缀,用分号连接各条目,每个条目以 !new_stream 头部声明这是一路新的同步流,并对 URL 做长度前缀引用(%<len>%<value>),其中 len 按 UTF-8 字节数计算。

关键陷阱:长度引用是必需的,且长度按字节计算,JVM 的 String.length 按 UTF-16 单元计数,对非 ASCII URL 会算错,应使用 toByteArray(Charsets.UTF_8).size。真实流 URL 的查询串中可能含分号或逗号,未引用会被截断并产生难以定位的故障。只复制文档化的核心头部,引擎自身解析脚本附加的额外头部不属于核心格式、可能随时变化,不应照抄;应针对具体症状再加头部。

使用注意事项:纯视频流不含音频,合并不是可选项,每个返回视频源的分支都必须再获取音频 URL 并附加,否则得到静音视频且日志无提示。请求“已混流”路径看似方便,但常把同一 manifest URL 同时作为音频和视频答案返回,导致引擎重复打开同一清单,并失去按轨道选择画质的能力;还应检查解析器实现,避免该标志被误传为其他语义(例如匿名请求标志)而丢掉登录会话。合并决策应集中在一个辅助函数中,并且纯音频源不应携带第二个 URL。

过渡限制:不要在淡入淡出过渡进行中准备合并源,否则可能提前截断上一首或直接跳到视频首帧;视频应从第一帧开始、播放到最后一帧结束,因此视频相关的过渡应走普通非交叉淡入淡出路径。视频判断需同时检查“允许播放视频”的设置和条目类型,否则会对实际以纯音频播放的内容禁用交叉淡入淡出。防护逻辑要加在所有能启动过渡的路径上(通常为位置轮询和文件结束处理两处),只加在文件结束处理处可能导致代码永不执行。

验证方式:技能给出从仓库根目录运行的 grep 命令,检查字节计数行存在、错误的字符计数模式不存在、两处 audioSlaveUrl 赋值存在、两个视频判断函数均先读取 watchVideoEnabled,以及过渡触发调用点恰好两处。具体模块路径和函数名为示例实现,复制前应参照所用引擎的 edit-list 文档核对其语法。