Skip to main content

ensureFfmpeg()

从 v3.3 开始可用,从 v4.0 中移除

warning

此 API 已在 v4.0 中移除,不再需要调用。此页面仅用于存档目的。

检查 ffmpeg 二进制文件是否已安装,如果没有安装,将其下载并放入您的 node_modules 文件夹 中。

ensure.mjs
ts
import { ensureFfmpeg } from "@remotion/renderer";
await ensureFfmpeg();
ensure.mjs
ts
import { ensureFfmpeg } from "@remotion/renderer";
await ensureFfmpeg();

您可能不需要调用此函数。如果尝试渲染且未找到二进制文件,则 Remotion 将自动下载 ffmpeg

如果需要在第一次渲染开始之前准备好 FFmpeg,则此函数很有用。

还要调用 ensureFfprobe() 以获取 Remotion 需要的两个二进制文件。

选项

可选地,您可以传递一个对象并传递以下选项:

remotionRoot

string

您的 node_modules 所在的目录。

返回值

一个解析为具有以下属性的对象的 Promise:

  • wasAlreadyInstalled:布尔值,指示是否因为此函数调用而下载了二进制文件。
  • result:一个字符串,可以是 found-in-pathfound-in-node-modulesinstalled

异常

如果未找到二进制文件、下载失败或您的平台没有可用的二进制文件,则此函数会抛出异常。

另请参阅