可选功能：下载动作捕捉组件

从 Swing Catalyst 26.2 版本开始，动作捕捉模型和 GPU 加速文件不再包含在安装程序中。你只需在应用内的可选功能设置页面下载一次即可。这样可以保持安装程序体积小，也让我们能够在不发布新版本的情况下更新模型。

本文将说明这些下载内容是什么、如何找到该页面，以及下载失败时该怎么做。

四个组件组

可选功能页面包含四个组。每个组都是某项功能所需的一组文件。

组	功能说明	大约大小
动作捕捉	追踪视频中的身体动作。所有动作捕捉功能都需要此组。	300 MB
高尔夫球杆追踪	追踪高尔夫视频中的球杆和球。	340 MB
力板追踪	自动在视频中识别力板。	70 MB
GPU 加速	在配备 NVIDIA 显卡的电脑上加快处理速度。其他电脑无需此组。	4.1 GB

各版本之间的大小可能会有变化。页面会始终在每个组旁边显示当前的下载大小。

这些文件存储在 C:\ProgramData\Swing Catalyst\components 下。页面会在组件文件夹旁边显示具体的文件夹路径，点击打开文件夹即可在 Windows 资源管理器中打开该文件夹。

有三种方式可以进入该页面：

设置 > 可选功能。这是主要方式。
帮助 > 打开组件管理器。在开始屏幕（尚未打开会话时）也可以使用此方式。
从动作捕捉设置页面进入。如果缺少组件，顶部会显示一个黄色横幅，说明还需要下载多少个组件。点击下载所有所需项即可下载；点击**管理组件…**可打开可选功能页面。

启动需要相应组件的功能时，也可能会看到一个提示。提示会显示需要下载，并列出缺少的内容。点击下载开始下载，点击暂不跳过，或点击打开可选功能先查看详情。

文件下载期间，你可以继续使用应用。下载进度也会显示在窗口底部的任务列表中。下载完成后，会出现提示消息已下载 ML 模型或已下载运行时组件。

组正在下载时，你可以：

如果是从某个需要该组件的功能启动的下载，完成后会出现提示消息已下载。请重试该操作，此时请再次运行该功能。

状态	含义
已安装	该组的所有文件均已存在并通过校验。
未安装	该组尚无任何文件下载到磁盘。
已安装 2/4	部分文件已存在。点击下载获取其余文件。
需要修复	有文件损坏或不完整。点击修复，应用会删除损坏的文件并重新下载。
正在下载… 45%	正在进行下载。

页面顶部的磁盘占用会显示两个数字：一个是已安装文件占用的空间，另一个是缺失文件将占用的空间。

网络连接：需要能够访问 api.swingcatalyst.com 和 Microsoft Azure 存储服务。如果你的网络屏蔽了下载，请让 IT 部门放行这些地址。
包含动作捕捉的许可证：页面会在开始下载前检查你的许可证。如果许可证不包含某个组，下载会中止并显示许可证提示。
足够的可用磁盘空间：需与下载大小相当。应用会在开始前进行检查，并告知所需空间大小。
NVIDIA 显卡：仅 GPU 加速组需要。在其他电脑上，动作捕捉功能仍然可用，会改用 DirectML 引擎，无需额外下载。

该组会在状态下方显示一条简短消息。请先解决问题原因，再次点击下载。失败的文件会从头重新下载。

消息	处理方法
请检查网络连接	应用无法连接到服务器。请检查网络连接、VPN 和防火墙设置，然后重试。
服务器暂时不可用	下载服务器没有响应。请稍等几分钟后重试。
你的许可证无法访问这些模型	你的许可证不包含此功能。如果你认为应该包含，请联系支持团队。
磁盘空间不足	请释放所显示大小的磁盘空间，然后重试。
服务器上找不到该文件	我方服务器缺少该文件。请联系支持团队，并附上诊断信息（见下文）。
校验失败	文件在下载过程中损坏。点击修复或下载以重新获取。
无法保存到磁盘	应用无法写入组件文件夹。请检查杀毒软件或文件夹权限是否阻止了 `C:\ProgramData\Swing Catalyst\components`。

如果同一个错误反复出现，请将诊断信息发送给我们。

如需更多详情，请点击页面底部的显示技术详情。之后每个组都会列出各自的文件，包括版本、大小、文件路径和校验和。支持团队可能会要求你提供此视图的截图。

如需释放磁盘空间，请关闭 Swing Catalyst 并删除组件文件夹。下次打开应用时，所有组都会显示为未安装，你可以重新下载。