Chromium 标志

自 Remotion 2.6.5 起，我们允许你在 Chromium 和 Google Chrome 中设置以下标志：

🌐 We allow you to set the following flags in Chromium and Google Chrome since Remotion 2.6.5:

--disable-web-security

这将尤其会禁用 CORS 以及其他安全功能。

🌐 This will most notably disable CORS among other security features.

note

Remotion 将自动添加 --user-data-dir 标志。

通过 Node.JS API

🌐 Via Node.JS APIs

在getCompositions()、renderStill()、renderMedia()、renderFrames()、getCompositionsOnLambda()、renderStillOnLambda()、renderMediaOnLambda()、renderMediaOnVercel()和renderStillOnVercel()中，你可以通过chromiumOptions.disableWebSecurity。

🌐 In getCompositions(), renderStill(), renderMedia(), renderFrames(), getCompositionsOnLambda(), renderStillOnLambda(), renderMediaOnLambda(), renderMediaOnVercel() and renderStillOnVercel(), you can pass chromiumOptions.disableWebSecurity.

通过命令行标志

🌐 Via CLI flag

在以下命令之一中传递 --disable-web-security：remotion render、remotion compositions、remotion still、remotion lambda render、remotion lambda still、remotion lambda compositions。

🌐 Pass --disable-web-security in one of the following commands: remotion render, remotion compositions, remotion still, remotion lambda render, remotion lambda still, remotion lambda compositions.

通过配置文件

🌐 Via config file

使用 setChromiumDisableWebSecurity()。

🌐 Use setChromiumDisableWebSecurity().

Config.setChromiumDisableWebSecurity(true);

note

在 v3.3.39 之前，该选项被称为 Config.Puppeteer.setChromiumDisableWebSecurity()。

--ignore-certificate-errors

导致无效的 SSL 证书（例如自签名证书）被忽略。

🌐 Results in invalid SSL certificates, such as self-signed ones, being ignored.

通过 Node.JS API

🌐 Via Node.JS APIs

在 ['getCompositions()']（/docs/renderer/get-compositions）、['renderStill()']（/docs/renderer/render-still#ignorecertificateerrors）、['renderMedia()']（/docs/renderer/render-media#ignorecertificateerrors）、['renderFrames()']（/docs/renderer/render-frames#ignorecertificateerrors）、['getCompositionsOnLambda()']（/docs/lambda/getcompositionsonlambda#disablewebsecurity）、['renderStillOnLambda()']（/docs/lambda/renderstillonlambda#ignorecertificateerrors）、['renderMediaOnLambda()']（/docs/lambda/rendermediaonlambda#ignorecertificateerrors）、['renderMediaOnVercel()']（/docs/vercel/render-media-on-vercel#chromiumoptions）和 ['renderStillOnVercel()']（/docs/vercel/render-still-on-vercel#chromiumoptions），你可以通过 ['chromiumOptions.ignoreCertificateErrors']（/docs/renderer/render-still#ignorecertificateerrors）。

🌐 In getCompositions(), renderStill(), renderMedia(), renderFrames(), getCompositionsOnLambda(), renderStillOnLambda(), renderMediaOnLambda(), renderMediaOnVercel() and renderStillOnVercel(), you can pass chromiumOptions.ignoreCertificateErrors.

通过命令行标志

🌐 Via CLI flag

在以下命令之一中传递 --ignore-certificate-errors：remotion render、remotion compositions、remotion still、remotion lambda render、remotion lambda still、remotion lambda compositions。

🌐 Pass --ignore-certificate-errors in one of the following commands: remotion render, remotion compositions, remotion still, remotion lambda render, remotion lambda still, remotion lambda compositions.

通过配置文件

🌐 Via config file

使用 setChromiumIgnoreCertificateErrors()。

🌐 Use setChromiumIgnoreCertificateErrors().

Config.setChromiumIgnoreCertificateErrors(true);

note

在 v3.3.39 之前，该选项被称为 Config.Puppeteer.setChromiumIgnoreCertificateErrors()。

--disable-headless

Deprecated - will be removed in 5.0.0. With the migration to Chrome Headless Shell, this option is not functional anymore.

If disabled, the render will open an actual Chrome window where you can see the render happen. The default is headless mode.

通过 Node.JS API

🌐 Via Node.JS APIs

在 getCompositions()、renderStill()、renderMedia() 和 renderFrames() 中，你可以传递 chromiumOptions.headless。你不能在 Lambda 中设置此选项。

🌐 In getCompositions(), renderStill(), renderMedia() and renderFrames(), you can pass chromiumOptions.headless. You cannot set this option in Lambda.

通过命令行标志

🌐 Via CLI flag

在以下命令之一中传递 --disable-headless：remotion compositions、remotion render、remotion still。

🌐 Pass --disable-headless in one of the following commands: remotion compositions, remotion render, remotion still.

通过配置文件

🌐 Via config file

使用 setChromiumHeadlessMode()。

🌐 Use setChromiumHeadlessMode().

Config.setChromiumHeadlessMode(false);

note

在 v3.3.39 之前，该选项被称为 Config.Puppeteer.setChromiumHeadlessMode()。

--gl

Changelog

• From Remotion v2.6.7 until v3.0.7, the default for Remotion Lambda was swiftshader, but from v3.0.8 the default is swangle (Swiftshader on Angle) since Chrome 101 added support for it.
• From Remotion v2.4.3 until v2.6.6, the default was angle, however it turns out to have a small memory leak that could crash long Remotion renders.

Select the OpenGL renderer backend for Chromium.
Accepted values:

• "angle"
• "egl"
• "swiftshader"
• "swangle"
• "vulkan" (from Remotion v4.0.41)
• "angle-egl" (from Remotion v4.0.51)

The default is null, letting Chrome decide, except on Lambda where the default is "swangle"

通过 Node.JS API

🌐 Via Node.JS APIs

在getCompositions()、renderStill()、renderMedia()、renderFrames()、getCompositionsOnLambda()、renderStillOnLambda()、renderMediaOnLambda()、renderMediaOnVercel()和renderStillOnVercel()中，你可以通过chromiumOptions.gl。

🌐 In getCompositions(), renderStill(), renderMedia(), renderFrames(), getCompositionsOnLambda(), renderStillOnLambda(), renderMediaOnLambda(), renderMediaOnVercel() and renderStillOnVercel(), you can pass chromiumOptions.gl.

通过命令行标志

🌐 Via CLI flag

在以下命令之一中传递 --gl=swiftshader：remotion render、remotion compositions、remotion still、remotion lambda render、remotion lambda still、remotion lambda compositions。

🌐 Pass --gl=swiftshader in one of the following commands: remotion render, remotion compositions, remotion still, remotion lambda render, remotion lambda still, remotion lambda compositions.

通过配置文件

🌐 Via config file

Config.setChromiumOpenGlRenderer('swiftshader');

note

在 v3.3.39 之前，该选项被称为 Config.Puppeteer.setChromiumOpenGlRenderer()。

--user-agentv3.3.83

通过 Node.JS API

🌐 Via Node.JS APIs

在getCompositions()、renderStill()、renderMedia()、renderFrames()、getCompositionsOnLambda()、renderStillOnLambda()、renderMediaOnLambda()、renderMediaOnVercel()和renderStillOnVercel()中，你可以通过chromiumOptions.userAgent。

🌐 In getCompositions(), renderStill(), renderMedia(), renderFrames(), getCompositionsOnLambda(), renderStillOnLambda(), renderMediaOnLambda(), renderMediaOnVercel() and renderStillOnVercel(), you can pass chromiumOptions.userAgent.

通过命令行标志

🌐 Via CLI flag

在以下命令之一中传递 --user-agent：remotion render、remotion compositions、remotion still、remotion lambda render、remotion lambda still、remotion lambda compositions。

🌐 Pass --user-agent in one of the following commands: remotion render, remotion compositions, remotion still, remotion lambda render, remotion lambda still, remotion lambda compositions.

--dark-modev4.0.381

Whether Chromium should pretend to be in dark mode by emulating the media feature 'prefers-color-scheme: dark'. Default is false.

通过 Node.JS API

🌐 Via Node.JS APIs

在getCompositions()、renderStill()、renderMedia()、renderFrames()、getCompositionsOnLambda()、renderStillOnLambda()、renderMediaOnLambda()、renderMediaOnVercel()和renderStillOnVercel()中，你可以通过chromiumOptions.darkMode。

🌐 In getCompositions(), renderStill(), renderMedia(), renderFrames(), getCompositionsOnLambda(), renderStillOnLambda(), renderMediaOnLambda(), renderMediaOnVercel() and renderStillOnVercel(), you can pass chromiumOptions.darkMode.

通过命令行标志

🌐 Via CLI flag

在以下命令之一中传递 --dark-mode：remotion render、remotion compositions、remotion still、remotion lambda render、remotion lambda still、remotion lambda compositions。

🌐 Pass --dark-mode in one of the following commands: remotion render, remotion compositions, remotion still, remotion lambda render, remotion lambda still, remotion lambda compositions.

需要更多标志吗？

🌐 Need more flags?

打开一个 GitHub 问题 来请求它。

🌐 Open a GitHub issue to request it.