選用功能:下載動作擷取元件
從 Swing Catalyst 26.2 版開始,動作擷取模型與 GPU 加速檔案不再包含在安裝程式中。你只需在應用程式內的「選用功能」設定頁面下載一次即可。這樣安裝程式可以保持精簡,也讓我們能在不發布新版應用程式的情況下更新模型。
本文說明這些下載內容是什麼、如何找到這個頁面,以及下載失敗時該怎麼做。
四個元件群組
「選用功能」頁面共有四個群組。每個群組都是某項功能所需的一組檔案。
| Group | What it does | Approximate size |
|---|---|---|
| 動作擷取 | 追蹤影片中的身體動作。所有動作擷取功能都需要它。 | 300 MB |
| 高爾夫球桿追蹤 | 追蹤高爾夫影片中的球桿與球。 | 340 MB |
| 力量板追蹤 | 自動在影片中找出力量板。 | 70 MB |
| GPU 加速 | 在配備 NVIDIA 顯示卡的電腦上加快處理速度。其他電腦不需要此項目。 | 4.1 GB |
大小會隨版本更新而改變。頁面上會一律顯示每個群組目前的下載大小。
檔案會儲存在 C:\ProgramData\Swing Catalyst\components 之下。頁面會在「元件資料夾」旁顯示確切的資料夾位置,按一下「開啟資料夾」即可在 Windows 檔案總管中開啟。
如何找到這個頁面
有三種方式可以進入這個頁面:
- 設定 > 選用功能。這是主要的方式。
- 說明 > 開啟元件管理器。即使在開啟工作階段之前的啟動畫面,也可以使用這個方式。
- 從「動作擷取」設定頁面進入。如果缺少元件,頂端會出現黃色橫幅,顯示需要下載的元件數量。按一下「下載所需項目」即可下載;按一下「管理元件…」則會開啟選用功能頁面。
當你啟動需要這些元件的功能時,也可能會看到提示訊息。訊息會顯示「需要下載」,並列出缺少的項目。你可以選擇「下載」開始下載、選擇「稍後」略過,或選擇「開啟選用功能」先查看詳細資料。
如何下載
- 開啟「設定 > 選用功能」。
- 按一下某個群組的「下載」,或按一下頂端的「下載所有缺少的項目」以取得全部內容。
- 留意每個群組右側的狀態,狀態會從「未安裝」變成「下載中…45%」,再變成「已安裝」。
檔案下載期間,你仍可以繼續使用應用程式。下載進度也會顯示在視窗底部的工作清單中。下載完成時,會顯示「已下載 ML 模型」或「已下載執行階段元件」的訊息。
群組下載期間,你可以:
- 暫停下載,之後再繼續。繼續下載後,目前的檔案會從頭重新開始下載,所以暫停大型檔案會多花一些時間。
- 取消下載。元件資料夾中不會留下任何檔案,因為檔案只有在完整下載並通過檢查後,才會移入該資料夾。
如果你是從某項需要該元件的功能啟動下載,完成後會顯示「已下載,請再試一次」的訊息。這時只要再執行一次該功能即可。
狀態標籤
| Status | Meaning |
|---|---|
| 已安裝 | 群組中的每個檔案都已存在且通過檢查。 |
| 未安裝 | 這個群組目前在磁碟上完全沒有檔案。 |
| 已安裝 2/4 個 | 部分檔案已存在。按一下「下載」即可取得其餘檔案。 |
| 需要修復 | 檔案損毀或不完整。按一下「修復」,應用程式會刪除損毀的檔案並重新下載。 |
| 下載中…45% | 下載正在進行中。 |
頁面頂端的「磁碟使用量」會顯示兩個數字:一個是已安裝檔案所佔用的空間,另一個是缺少檔案所需的空間。
需求
- 需要網際網路連線,以連接到
api.swingcatalyst.com及 Microsoft Azure 儲存空間。如果你的網路封鎖了下載,請要求你的 IT 部門允許這些連線。 - 授權必須包含動作擷取功能:頁面會在開始下載前檢查你的授權。如果你的授權未涵蓋某個群組,下載會停止並顯示授權相關的訊息。
- 需要相當於下載大小的可用磁碟空間。應用程式會在開始下載前檢查空間,並告訴你需要多少空間。
- 「GPU 加速」群組需要 NVIDIA 顯示卡。在其他電腦上,動作擷取功能仍可正常運作,只是會改用 DirectML 引擎,不需要額外下載。
下載失敗時
群組的狀態下方會顯示簡短的訊息。請先排解原因,再按一下「下載」重試。失敗的檔案會從頭重新下載。
| Message | What to do |
|---|---|
| 請檢查你的網際網路連線 | 應用程式無法連上伺服器。請檢查你的網路連線、VPN 與防火牆設定,然後重試。 |
| 伺服器暫時無法使用 | 下載伺服器沒有回應。請等待幾分鐘後重試。 |
| 您的授權未涵蓋這些模型 | 你的授權未包含這項功能。如果你認為授權應該涵蓋此功能,請聯絡支援團隊。 |
| 磁碟空間不足 | 請釋出訊息顯示的空間大小,然後重試。 |
| 在伺服器上找不到檔案 | 檔案在我們的伺服器端遺失。請聯絡支援團隊並附上診斷資訊(見下文)。 |
| 驗證失敗 | 檔案在下載過程中損毀。請按一下「修復」或「下載」重新取得檔案。 |
| 無法儲存至磁碟 | 應用程式無法寫入元件資料夾。請確認防毒軟體或資料夾權限沒有封鎖 C:\ProgramData\Swing Catalyst\components。 |
如果同樣的錯誤一再發生,請將診斷資訊寄給我們。
提供給支援團隊的診斷資訊
- 開啟「設定 > 選用功能」。
- 按一下「複製診斷資訊」,即可複製每個元件的文字摘要,包括版本、狀態及元件資料夾位置。
- 將內容貼到你的支援信件中。
如需更詳細的資訊,請按一下頁面底部的「顯示技術詳細資料」。每個群組會列出個別檔案,包括版本、大小、檔案路徑與檢查碼。支援團隊可能會要求你提供這個畫面的螢幕截圖。
移除檔案
若要釋放磁碟空間,請關閉 Swing Catalyst 並刪除元件資料夾。下次開啟應用程式時,所有群組都會顯示「未安裝」,你可以重新下載。
相關文章
- Swing Catalyst 動作擷取設定
- 如何安裝 Swing Catalyst 動作擷取元件 (適用於 26.2 之前的版本)
- 動作擷取常見問答

