선택적 기능: 모션 캡처 구성 요소 다운로드
Swing Catalyst 26.2부터 모션 캡처 모델과 GPU 가속 파일은 설치 프로그램에 포함되지 않습니다. 이제 앱 안에서 선택적 기능 설정 페이지를 통해 한 번만 다운로드하면 됩니다. 이렇게 하면 설치 프로그램 용량이 작아지고, 앱을 새로 출시하지 않고도 모델을 업데이트할 수 있습니다.
이 문서에서는 이 다운로드 항목이 무엇인지, 해당 페이지를 어디서 찾는지, 다운로드가 실패했을 때 어떻게 해야 하는지 설명합니다.
네 가지 구성 요소 그룹
선택적 기능 페이지에는 네 개의 그룹이 있습니다. 각 그룹은 하나의 기능에 필요한 파일 모음입니다.
| 그룹 | 기능 | 대략적인 크기 |
|---|---|---|
| 모션 캡처 | 영상 속 신체 움직임을 추적합니다. 모든 모션 캡처 기능에 필요합니다. | 300 MB |
| 골프 클럽 추적 | 골프 영상에서 골프 클럽과 공을 추적합니다. | 340 MB |
| 포스 플레이트 추적 | 영상에서 포스 플레이트를 자동으로 찾습니다. | 70 MB |
| GPU 가속 | NVIDIA 그래픽 카드가 있는 컴퓨터에서 처리 속도를 높입니다. 다른 컴퓨터에서는 필요하지 않습니다. | 4.1 GB |
크기는 릴리스마다 달라집니다. 페이지에는 항상 각 그룹 옆에 현재 다운로드 크기가 표시됩니다.
파일은 C:\ProgramData\Swing Catalyst\components 아래에 저장됩니다. 페이지에는 구성 요소 폴더 옆에 정확한 폴더가 표시되며, 폴더 열기를 클릭하면 Windows 탐색기에서 해당 폴더가 열립니다.
이 페이지를 찾는 방법
이 페이지에 접근하는 방법은 세 가지입니다.
- 설정 > 선택적 기능. 가장 기본적인 방법입니다.
- 도움말 > 구성 요소 관리자 열기. 세션을 열기 전 시작 화면에서도 사용할 수 있습니다.
- 모션 캡처 설정 페이지에서도 접근할 수 있습니다. 구성 요소가 없으면 상단에 노란색 배너가 표시되어 몇 개가 필요한지 알려줍니다. 필요한 항목 모두 다운로드를 클릭하면 해당 항목을 모두 받습니다. **구성 요소 관리…**를 클릭하면 선택적 기능 페이지가 열립니다.
구성 요소가 필요한 기능을 시작할 때 안내 메시지가 나타날 수도 있습니다. 이 메시지에는 다운로드 필요라고 표시되며 누락된 항목이 나열됩니다. 다운로드를 선택하면 다운로드를 시작하고, 나중에를 선택하면 건너뛰고, 선택적 기능 열기를 선택하면 먼저 자세한 내용을 확인할 수 있습니다.
다운로드하는 방법
- 설정 > 선택적 기능을 엽니다.
- 그룹에서 다운로드를 클릭하거나, 상단의 누락된 항목 모두 다운로드를 클릭해 전체를 받습니다.
- 각 그룹 오른쪽의 상태를 확인합니다. 상태는 설치되지 않음에서 **다운로드 중… 45%**를 거쳐 설치됨으로 바뀝니다.
파일을 다운로드하는 동안에도 앱을 계속 사용할 수 있습니다. 진행 상황은 창 하단의 작업 목록에도 표시됩니다. 다운로드가 끝나면 ML 모델이 다운로드됨 또는 런타임 구성 요소가 다운로드됨이라는 메시지가 나타납니다.
그룹을 다운로드하는 동안 다음 작업을 할 수 있습니다.
- 일시 중지했다가 나중에 재개할 수 있습니다. 재개하면 현재 파일은 처음부터 다시 시작되므로, 큰 파일을 일시 중지하면 시간이 더 걸립니다.
- 취소할 수 있습니다. 취소하면 구성 요소 폴더에는 아무것도 남지 않습니다. 파일은 다운로드가 완료되고 검증을 마친 후에만 해당 폴더로 이동합니다.
기능에서 다운로드를 시작한 경우, 다운로드가 끝나면 다운로드되었습니다. 작업을 다시 시도하세요라는 메시지가 표시됩니다. 이때 해당 기능을 다시 실행하면 됩니다.
상태 라벨
| 상태 | 의미 |
|---|---|
| 설치됨 | 그룹의 모든 파일이 있으며 검증을 마쳤습니다. |
| 설치되지 않음 | 이 그룹의 파일이 아직 디스크에 없습니다. |
| 4개 중 2개 설치됨 | 일부 파일이 있습니다. 다운로드를 클릭해 나머지를 받으세요. |
| 복구 필요 | 파일이 손상되었거나 불완전합니다. 복구를 클릭하세요. 앱이 손상된 파일을 삭제하고 다시 다운로드합니다. |
| 다운로드 중… 45% | 다운로드가 진행 중입니다. |
페이지 상단의 디스크 사용량에는 두 가지 숫자가 표시됩니다. 하나는 설치된 파일이 차지하는 공간이고, 다른 하나는 누락된 파일을 받을 경우 차지할 공간입니다.
필요 조건
- 인터넷 액세스:
api.swingcatalyst.com와 Microsoft Azure storage에 연결할 수 있어야 합니다. 네트워크가 다운로드를 차단하는 경우, IT 부서에 허용을 요청하세요. - 모션 캡처가 포함된 라이선스: 페이지는 다운로드를 시작하기 전에 라이선스를 확인합니다. 라이선스가 특정 그룹을 포함하지 않으면, 다운로드가 라이선스 관련 메시지와 함께 중단됩니다.
- 다운로드 크기만큼의 여유 디스크 공간: 앱은 시작 전에 이를 확인하고 필요한 공간을 알려줍니다.
- NVIDIA 그래픽 카드: GPU 가속 그룹에 필요합니다. 다른 컴퓨터에서도 모션 캡처는 정상적으로 작동하며, 이 경우 추가 다운로드가 필요 없는 DirectML 엔진을 사용합니다.
다운로드가 실패했을 때
그룹 상태 아래에 짧은 메시지가 표시됩니다. 원인을 해결한 후 다운로드를 다시 클릭하세요. 실패한 파일은 처음부터 다시 받습니다.
| 메시지 | 해결 방법 |
|---|---|
| 인터넷 연결을 확인하세요 | 앱이 서버에 연결하지 못했습니다. 연결 상태, VPN, 방화벽을 확인한 후 다시 시도하세요. |
| 서버를 일시적으로 사용할 수 없습니다 | 다운로드 서버가 응답하지 않았습니다. 몇 분 기다린 후 다시 시도하세요. |
| 라이선스에 이 모델에 대한 액세스 권한이 없습니다 | 라이선스에 이 기능이 포함되어 있지 않습니다. 포함되어야 한다고 생각되면 지원팀에 문의하세요. |
| 디스크 공간이 부족합니다 | 표시된 만큼 공간을 확보한 후 다시 시도하세요. |
| 서버에서 파일을 찾을 수 없습니다 | 저희 쪽에서 파일이 누락된 상태입니다. 지원팀에 문의하고 아래의 진단 정보를 함께 보내주세요. |
| 확인 실패 | 다운로드 중 파일이 손상되었습니다. 복구 또는 다운로드를 클릭해 다시 받으세요. |
| 디스크에 저장할 수 없습니다 | 앱이 구성 요소 폴더에 파일을 쓰지 못했습니다. 백신 소프트웨어나 폴더 권한이 C:\ProgramData\Swing Catalyst\components를 차단하고 있지 않은지 확인하세요. |
같은 오류가 계속 발생하면 진단 정보를 보내주세요.
지원팀을 위한 진단 정보
- 설정 > 선택적 기능을 엽니다.
- 진단 정보 복사를 클릭합니다. 모든 구성 요소의 버전, 상태, 구성 요소 폴더 정보가 텍스트 요약으로 복사됩니다.
- 이를 지원팀에 보내는 이메일에 붙여넣습니다.
더 자세한 정보가 필요하면 페이지 하단의 기술 세부정보 표시를 클릭하세요. 그러면 각 그룹의 개별 파일이 버전, 크기, 파일 경로, 체크섬과 함께 나열됩니다. 지원팀이 이 화면의 스크린샷을 요청할 수도 있습니다.
파일 삭제하기
디스크 공간을 확보하려면 Swing Catalyst를 종료하고 구성 요소 폴더를 삭제하세요. 다음에 앱을 열면 모든 그룹이 설치되지 않음으로 표시되며, 다시 다운로드할 수 있습니다.

