DaVinci 21 Fusion 设置：脚本

DaVinci Resolve 的 Fusion 设置中的“脚本”（Script）用于配置 Fusion 脚本的外部执行验证方式、脚本编辑器，以及 .py 脚本默认使用的 Python 版本。

Fusion 提供脚本接口，可以使用 Lua 和 Python 对合成、节点、参数、渲染及其他操作进行自动化，也可以由外部程序通过 FusionScript 控制 Fusion。“脚本”设置页主要管理这类脚本环境，并不用于编写脚本本身。普通用户如果只使用 Fusion 节点和效果，通常保持默认设置即可。

登录

Login

用于设置从 Fusion 外部执行脚本或远程控制 Fusion 时采用的登录验证方式。

这里的“登录”并不是 Blackmagic Cloud、DaVinci Resolve 账户或操作系统登录本身，而是 Fusion 对外部脚本命令进行身份验证的机制。

需要特别注意：这些验证设置主要影响从命令行执行的脚本，以及尝试控制其他 Fusion 实例的外部脚本。从 Fusion 界面内部执行的脚本不需要经过这里的登录验证。

不需要登录即可执行脚本

No login required to execute script

默认选项。

选择后，从命令行执行脚本或通过 FusionScript 等方式从外部控制 Fusion 时，不要求先提供用户名和密码。

这是使用最方便的方式，也适合普通单机工作站以及只在本机使用脚本自动化的工作流程。

如果工作站允许其他计算机通过网络访问 Fusion 的脚本接口，或者处于需要严格控制自动化访问权限的制作环境，则可以考虑使用下面的身份验证方式。

无论选择哪一种登录方式，从 Fusion 自身界面运行的脚本都不受这里的登录要求限制。

指定自定义登录名

Specify custom login

选择后，可以为 Fusion 的外部脚本访问设置专用的用户名和密码。

启用后，Fusion 会要求外部脚本先使用正确的登录信息完成验证，然后才接受相应的脚本命令。它主要用于命令行脚本、FusionScript 外部控制以及远程 Fusion 自动化。

适合需要限制外部脚本访问，而又不希望直接使用 Windows 账户验证的环境。

--名称

Name

设置外部脚本验证使用的自定义用户名。

这个名称是 Fusion 脚本验证所使用的名称，并不是 Blackmagic Cloud 用户名。

--密码

Password

设置与自定义用户名对应的密码。

外部脚本连接 Fusion 时，需要使用与这里匹配的登录信息才能执行受保护的外部脚本命令。

如果不需要从其他程序或计算机远程控制 Fusion，一般没有必要专门设置自定义登录。

使用Windows登录验证

Use windows login validation

仅适用于 Windows。

选择后，Fusion 不再使用上面单独设置的自定义用户名和密码，而是通过 Windows 的用户凭据对外部脚本访问进行验证。

这种方式适合已经通过 Windows 用户账户管理访问权限的工作站或制作环境，可以把 Fusion 外部脚本访问与现有的系统账户认证结合起来。

macOS 和其他系统不使用 Windows 登录验证，因此一般选择前两种方式。

选项

Options

用于指定 Fusion 编辑脚本时调用的外部程序。

脚本编辑器

Script editor

默认可以为空。

用于指定 Fusion 使用的外部脚本编辑器。

设置后，当从 Fusion 的脚本相关菜单执行“编辑”（Edit）操作时，可以直接调用这里指定的应用程序打开脚本。

可以根据个人工作习惯选择能够编辑纯文本、Lua 或 Python 文件的编辑器，例如代码编辑器或其他文本编辑工具。

右侧的文件夹按钮用于浏览并指定相应的编辑器程序。

这项设置只决定用什么程序打开脚本进行编辑，不会改变脚本使用的语言、执行方式或 Fusion 脚本接口。

如果平时不直接编写或修改 Fusion 脚本，可以保持为空。

默认的Python版本

Default Python Version

用于设置 Fusion 对没有明确指定 Python 版本的 Python 脚本所采用的默认解释器版本。

当前界面提供：

--Python 3

Python 3

默认选项。

使用 Python 3 执行普通 .py Fusion 脚本。

对于新建脚本和当前的自动化开发，应优先采用 Python 3。Python 3 是当前 Python 生态使用的主要版本，新脚本通常没有必要再针对 Python 2.7 编写。

--Python 2.7

Python 2.7

使用 Python 2.7 作为默认 Python 解释器。

这一选项主要用于兼容依赖 Python 2.7 语法或第三方库的早期 Fusion 脚本。

Python 2 已经停止维护，因此新脚本一般不建议选择 Python 2.7。只有确认现有旧脚本不能在 Python 3 下正常运行时，才需要使用这一兼容选项。

Fusion 还允许通过文件扩展名明确指定 Python 解释器：

• .py：使用这里设置的默认 Python 版本

• .py3：明确使用 Python 3

• .py2：明确使用 Python 2

这种 .py2、.py3 扩展名属于 Fusion 的脚本机制，并不是 Python 通用的文件扩展规则。

1、Lua 与默认Python版本的关系

Fusion 除 Python 外还支持 Lua 脚本。

“默认的Python版本”只决定 Python 脚本使用哪一种 Python 解释器，不会影响 Lua 脚本。

Fusion 可以根据脚本扩展名选择相应语言，例如：

example.lua

使用 Lua 执行；

example.py

使用这里选择的默认 Python 版本执行。

因此，如果安装的 Fusion 脚本全部采用 Lua，这里的 Python 版本通常无需关心。

Fusion 的控制台也可以用于执行 FusionScript 命令和检查脚本输出，是开发、测试和排查脚本的重要工具。

2、Python 环境与这一设置的区别

“默认的Python版本”用于选择解释器类型，并不等同于安装或配置完整的 Python 开发环境。

如果某个 Python 脚本依赖特定 Python 环境、第三方模块或其他软件包，还需要保证相应环境和依赖已经正确配置。修改这一选项本身不会安装 Python 模块，也不会解决脚本缺失第三方依赖的问题。

因此，遇到 Python Fusion 脚本无法运行时，可以分别检查：

• 脚本需要 Python 3 还是 Python 2.7

• .py 脚本的默认 Python 版本是否正确

• 所需 Python 环境是否可用

• 脚本需要的第三方模块是否已经安装

• 脚本自身是否与当前 Fusion API 兼容

对于普通用户，保持 Python 3 即可。

“点赞有美意，赞赏是鼓励”