用途:Helios Renderer 用于在 Node.js 中以编程方式把 Helios 合成渲染为视频文件,基于 Playwright 与 FFmpeg 做无头渲染。
主要能力:支持 canvas 与 dom 两种渲染模式;canvas 模式适合 WebGL、Three.js、Pixi.js 和 2D Canvas,通过 CdpTimeDriver 控制时间、CanvasStrategy 直接捕获画布;dom 模式适合 CSS 动画、HTML/DOM 元素及复杂音视频合成,通过 SeekTimeDriver(seek 与截图)确保布局稳定,并自动发现 DOM 中的 audio/video 标签加入其音频。可设置宽高、fps、时长或精确帧数、起始帧,注入 inputProps 到 window.HELIOS_PROPS。支持音频文件与音轨列表(音量、偏移、seek、播放速率)、音频编解码与码率,视频编解码、像素格式、crf、preset、码率,以及字幕烧录(需 libx264)。
使用方式:从 @helios-project/renderer 导入 Renderer,构造后调用 render(compositionUrl, outputPath, jobOptions),jobOptions 支持 onProgress 回调与 AbortSignal 取消。可调用 diagnose() 检查 Playwright、WebCodecs、FFmpeg 环境。工具还提供 RenderOrchestrator 分布式渲染、concatenateVideos 视频拼接。DOM 模式可用 JPEG 中间图加速草稿渲染,并支持通过 data-helios-offset、data-helios-seek、muted 属性同步嵌套媒体与 Shadow DOM。
适用场景:需要批量或自动化产出视频、分布式分片渲染、音轨混音、字幕烧录、区间渲染的流程。
限制:DOM 模式因整页截图比 canvas 模式慢;字幕烧录依赖 libx264;中间图 JPEG 选项仅 DOM 模式有效;未提供具体安装命令、平台要求与收费信息。