LifeOS Remotion 技能实战：使用 Mediabunny 精确获取视频时长（秒）-迪斯科星球

LifeOS Remotion 技能实战：使用 Mediabunny 精确获取视频时长（秒）

【免费下载链接】LifeOS⛰️ The Life Operating System — an intent engineering platform that moves you from your current state to your ideal state, in life and work.项目地址: https://gitcode.com/GitHub_Trending/pe/LifeOS

导读

在 LifeOS 的 Remotion 编程化视频生产链路中，几乎所有自动化流程（内容转动画、动态时长编排、多素材拼接）都依赖一个前置能力：先拿到视频文件的精确时长。本文以 Remotion 技能的参考文档 Ref-get-video-duration.md 为主体，结合仓库中同系列的音频时长、视频尺寸、calculateMetadata动态编排等源码级文档，系统讲解如何用 Mediabunny 的Input.computeDuration()在浏览器、Node.js、Bun 三种环境中读取视频时长，并给出远程 URL、本地文件、RemotionstaticFile()三种数据源与组合成动态时长的完整实战方案。读完本文，你将能写出可复用的getVideoDuration工具函数，并把它接入 Remotion 组合的动态元数据计算。

Mediabunny 是什么，为什么用它

在 LifeOS 的 Remotion 技能体系中，视频时长读取由Mediabunny承担。这是一个统一的媒体解析库，能从媒体文件中提取时长、尺寸、轨道等元数据。它的关键特性是跨环境一致：同一套 API 在浏览器、Node.js、Bun 中都能工作，这与 Remotion 技能"代码即视频、结果确定性可复现"的理念一致——SKILL.md 中明确指出 Remotion 的每一帧都由useCurrentFrame()驱动而非 CSS 动画，保证输出确定性与可复现性；时长作为组合（Composition）的输入参数，自然也需要一个确定、可编程的获取途径。

从仓库的 Tools/package.json 可以看到，该技能以remotion >= 4.0.0为 peer 依赖，运行环境为 Bun（bunx而非npx，这是 CriticalRules.md 第 10 条硬性规定），因此 Mediabunny 对 Bun 的原生支持与整个技能栈是无缝衔接的。

核心 API：`Input`+`computeDuration()`

参考文档给出的最小实现是一个纯函数getVideoDuration，它把"构造输入源"与"计算时长"两个动作封装起来：

import { Input, ALL_FORMATS, UrlSource } from "mediabunny"; export const getVideoDuration = async (src: string) => { const input = new Input({ formats: ALL_FORMATS, source: new UrlSource(src, { getRetryDelay: () => null, }), }); const durationInSeconds = await input.computeDuration(); return durationInSeconds; };

拆解这段代码，理解每个参数的实际作用：

ALL_FORMATS：告诉 Mediabunny 允许使用全部媒体封装格式（MP4、WebM、MOV 等）来解析。从源码结构看，formats是Input的核心配置项，决定解析器允许探测的容器类型，全部启用可以最大化兼容不同来源的视频文件。
UrlSource(src, { getRetryDelay: () => null })：声明输入源为远程 URL。getRetryDelay回调用于控制网络重试策略——返回null表示不重试。这在读取不稳定的远程媒体时是一种快速失败策略：宁可立刻报错，也不让渲染管线长时间挂在重试上（渲染是 CPU 密集任务，见 SKILL.md 的 Gotchas 部分）。
computeDuration()：异步方法，返回以秒为单位的时长，类型为 number，例如10.5表示 10.5 秒。时长可能是小数，后续换算帧数时需要用Math.ceil()向上取整（见下文"接入动态时长"）。

三种数据源：URL、本地文件、staticFile

1. 远程 URL（默认场景）

把任意可访问的视频地址传给UrlSource即可：

const duration = await getVideoDuration("https://remotion.media/video.mp4"); console.log(duration); // e.g. 10.5 (seconds)

远程源适合视频托管在 CDN、对象存储或第三方服务上的场景，是 LifeOS 内容工作流中最常见的输入形式（例如把 YouTube 视频转为动画时，先拿到原视频时长用于编排）。

2. 本地文件：改用`FileSource`

当视频来自本地（例如用户拖拽上传、文件选择器返回的File对象）时，不能再用UrlSource，而是换成FileSource：

import { Input, ALL_FORMATS, FileSource } from "mediabunny"; const input = new Input({ formats: ALL_FORMATS, source: new FileSource(file), // File object from input or drag-drop }); const durationInSeconds = await input.computeDuration();

注意FileSource接收的是浏览器环境中的File对象，而不是文件路径字符串。这意味着本地文件时长读取天然面向"浏览器内"或"运行时内存中已有文件对象"的场景；若你在 Node/Bun 后端拿到的是磁盘路径，需要先以合适的方式构造文件对象再传入。

3. Remotion 静态资源：`staticFile()`

在 Remotion 组合内部，/public目录下的资源必须通过staticFile()引用，而不能硬编码绝对路径或相对路径——CriticalRules.md 第 3 条明确要求"ALWAYS usestaticFile()for/publicassets"，因为staticFile()在 Remotion Studio 预览和服务端渲染两种模式下都能正确解析路径。

import { staticFile } from "remotion"; const duration = await getVideoDuration(staticFile("video.mp4"));

把getVideoDuration与staticFile组合，就能在渲染前读取打包进项目的素材时长。这与 Ref-videos.md 中<Video src={staticFile("video.mp4")} />的用法完全一致，构成"读时长→设时长→渲染视频"的完整闭环。

把时长接进 Remotion：`calculateMetadata`动态编排

单纯拿到时长还不够，它真正的价值在于驱动<Composition>的动态元数据。参考文档 Ref-calculate-metadata.md 给出了标准接法：用calculateMetadata在渲染前根据视频时长动态设置durationInFrames。

单视频：时长决定组合帧数

import {CalculateMetadataFunction} from 'remotion'; import {getMediaMetadata} from '../get-media-metadata'; const calculateMetadata: CalculateMetadataFunction<Props> = async ({props}) => { const {durationInSeconds} = await getMediaMetadata(props.videoSrc); return { durationInFrames: Math.ceil(durationInSeconds * 30), }; };

这里的换算关系是：帧数 = 时长（秒）× fps。Math.ceil()向上取整保证帧数不会因为小数时长而不足，避免组合在最后一帧被截断。getMediaMetadata与本文的getVideoDuration属于同一 Mediabunny 工具族——你可以直接在自己的getVideoDuration返回值上乘以 fps 完成换算。

匹配视频尺寸（进阶组合）

时长与尺寸可以一次同时设置，让组合自动匹配素材分辨率：

const calculateMetadata: CalculateMetadataFunction<Props> = async ({props}) => { const {durationInSeconds, dimensions} = await getMediaMetadata(props.videoSrc); return { durationInFrames: Math.ceil(durationInSeconds * 30), width: dimensions?.width ?? 1920, height: dimensions?.height ?? 1080, }; };

尺寸的读取方式可以参考同目录的 Ref-get-video-dimensions.md：通过input.getPrimaryVideoTrack()拿到主视频轨道，再读取track.displayWidth/track.displayHeight。两者配合即可实现"视频是什么规格，组合就是什么规格"的自动化适配。

多视频：时长求和

当组合由多个视频素材拼接而成时，用Promise.all并行读取所有时长再求和：

const calculateMetadata: CalculateMetadataFunction<Props> = async ({props}) => { const metadataPromises = props.videos.map((video) => getMediaMetadata(video.src)); const allMetadata = await Promise.all(metadataPromises); const totalDuration = allMetadata.reduce((sum, meta) => sum + meta.durationInSeconds, 0); return { durationInFrames: Math.ceil(totalDuration * 30), }; };

这正好对应 LifeOS 的 ContentToAnimation.md 工作流中"内容分镜 → 场景编排 → 总时长 = 90 + (sections × 150) + 90"的时长规划逻辑：无论分镜时长来自内容密度公式还是真实视频素材，最终都要换算为durationInFrames交给组合。

同一工具族：音频时长与视频尺寸

本文主角getVideoDuration不是孤立函数，它与 Mediabunny 工具族共享完全一致的Input + source + computeXxx()模式。理解这一模式后，其他元数据读取可以触类旁通：

音频时长：Ref-get-audio-duration.md 提供getAudioDuration，代码结构与本文几乎相同，只是示例源换成https://remotion.media/audio.mp3，返回180.5这类秒数值。当视频需要配乐、配音并据此设置音频轨时长时使用。
视频尺寸：Ref-get-video-dimensions.md 使用input.getPrimaryVideoTrack()读取displayWidth/displayHeight，并通过if (!videoTrack) throw new Error("No video track found")做轨道缺失保护。

三者共用的关键点是：数据源构造（UrlSource / FileSource / staticFile）与元数据读取（computeDuration / getPrimaryVideoTrack）完全解耦，你可以在getVideoDuration之上自由扩展，例如返回一个包含时长、宽高、帧率的结构化MediaMetadata对象。

常见陷阱与最佳实践

结合仓库文档，整理出使用 Mediabunny 读时长时最值得注意的几条规则：

远程源重试策略：getRetryDelay: () => null表示不重试。如果你的素材来自不稳定的 CDN，可以按业务需要改为返回固定毫秒数实现有限重试；但在渲染管线中建议保持快速失败，避免后台渲染任务长时间挂起。
本地文件必须用FileSource：误用UrlSource传本地路径不会得到文件内容，只会得到解析失败或网络请求错误。
Remotion 内永远用staticFile()：这是 CriticalRules.md 的硬性规则，直接传/video.mp4在服务端渲染时可能解析失败。
帧数换算向上取整：Math.ceil(durationInSeconds * fps)避免小数帧导致的最后一帧截断或组合边界计算错误。
环境差异意识：Mediabunny 的"跨环境一致"是 API 层面的，实际部署时仍需注意——例如FileSource依赖浏览器File对象，Node/Bun 后端需先构造对应文件对象；渲染用bunx remotion render（见 SKILL.md 的 Quick Reference），不要在 Bun 环境使用npx。
与动态时长功能配合：calculateMetadata支持动态设置durationInFrames、width、height、fps、props、defaultOutName等字段（详见 Ref-calculate-metadata.md 的返回值清单），读时长只是其中一环，把它和defaultOutName、props变换组合，可以构建完全数据驱动的视频生成管线。

总结

通过本文，你掌握了在 LifeOS Remotion 技能中使用 Mediabunny 读取视频时长的完整方案：以Input+ALL_FORMATS构造解析器，用UrlSource/FileSource/staticFile()三种方式切换数据源，以computeDuration()拿到秒级时长，再通过calculateMetadata把时长换算为durationInFrames驱动组合动态渲染。这套"读元数据 → 动态编排 → 渲染"的模式同时覆盖音频时长与视频尺寸，是 LifeOS 内容自动化生产链路中最基础也最关键的一环。

进一步阅读：参考文档原文见 Ref-get-video-duration.md，同族工具见 Ref-get-audio-duration.md 与 Ref-get-video-dimensions.md，动态编排见 Ref-calculate-metadata.md，整个技能的总览与使用约束见 SKILL.md 与 CriticalRules.md。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析