Дополнительные компоненты: загрузка компонентов захвата движения

Начиная с версии Swing Catalyst 26.2, модели захвата движения и файлы ускорения GPU больше не входят в установщик. Вы загружаете их один раз прямо из приложения, на странице настроек Дополнительные компоненты. Это позволяет установщику оставаться небольшим и даёт нам возможность обновлять модели без выпуска новой версии приложения.

В этой статье рассказано, что представляют собой эти загрузки, где найти страницу и что делать, если загрузка завершится ошибкой.

Четыре группы компонентов

На странице «Дополнительные компоненты» есть четыре группы. Каждая группа — это набор файлов, необходимых для одной функции.

Группа	Что делает	Примерный размер
Захват движения	Отслеживает движения тела на ваших видео. Нужна для всех функций захвата движения.	300 МБ
Отслеживание клюшки	Отслеживает клюшку для гольфа и мяч на видео игры в гольф.	340 МБ
Отслеживание силовых платформ	Автоматически находит силовые платформы на ваших видео.	70 МБ
Ускорение GPU	Более быстрая обработка на компьютерах с видеокартой NVIDIA. Не нужна на других компьютерах.	4,1 ГБ

Размеры могут меняться от версии к версии. Страница всегда показывает актуальный размер загрузки рядом с каждой группой.

Файлы хранятся в C:\ProgramData\Swing Catalyst\components. Страница показывает точную папку рядом с полем Components Folder, а кнопка Open Folder открывает её в проводнике Windows.

Где найти страницу

Есть три способа попасть на неё:

Настройки > Дополнительные компоненты. Это основной способ.
Справка > Открыть диспетчер компонентов. Работает и на стартовом экране, ещё до открытия сессии.
Со страницы настроек Захват движения. Если компонентов не хватает, вверху появляется жёлтая полоса с указанием, сколько компонентов нужно. Кнопка Загрузить всё необходимое запускает их загрузку. Кнопка Управление компонентами… открывает страницу «Дополнительные компоненты».

При запуске функции, для которой нужны компоненты, может также появиться запрос. Он гласит Требуется загрузка и перечисляет недостающее. Выберите Загрузить, чтобы начать, Не сейчас, чтобы пропустить, или Открыть «Дополнительные компоненты», чтобы сначала посмотреть подробности.

Как загрузить

Откройте Настройки > Дополнительные компоненты.
Нажмите Загрузить рядом с нужной группой или Загрузить всё недостающее вверху, чтобы получить всё сразу.
Следите за статусом справа от каждой группы. Он меняется с Не установлено на Загрузка… 45%, а затем на Установлено.

Пока файлы загружаются, приложением можно продолжать пользоваться. Прогресс также отображается в списке задач внизу окна. Когда загрузка завершится, появится сообщение Модели ML загружены или Компоненты среды выполнения загружены.

Пока группа загружается, можно:

Поставить загрузку на Паузу и позже нажать Возобновить. После возобновления текущий файл начинает загружаться заново с начала, поэтому пауза на большом файле отнимает время.
Нажать Отмена. В папке компонентов при этом ничего не остаётся: файл переносится туда только после того, как загрузка полностью завершена и проверена.

Если загрузка была запущена из функции, которой нужны были компоненты, по её завершении появится сообщение загружено. Повторите действие. После этого запустите функцию ещё раз.

Статусы

Статус	Значение
Установлено	Все файлы группы присутствуют и проверены.
Не установлено	На диске пока нет ни одного файла из этой группы.
Установлено 2 из 4	Часть файлов присутствует. Нажмите Загрузить, чтобы получить остальные.
Требуется восстановление	Файл повреждён или загружен не полностью. Нажмите Восстановить. Приложение удалит повреждённый файл и загрузит его заново.
Загрузка… 45%	Загрузка выполняется.

В верхней части страницы поле Использование диска показывает два числа. Одно — это место, занятое уже установленными файлами. Другое — место, которое заняли бы недостающие файлы.

Требования

Доступ в интернет к api.swingcatalyst.com и к хранилищу Microsoft Azure. Если сеть блокирует загрузки, попросите ИТ-отдел разрешить их.
Лицензия, включающая захват движения: страница проверяет вашу лицензию перед началом загрузки. Если ваша лицензия не покрывает какую-то группу, загрузка останавливается с сообщением о лицензии.
Свободное место на диске, равное размеру загрузки. Приложение проверяет это перед началом и сообщает, сколько места нужно.
Видеокарта NVIDIA для группы Ускорение GPU. На других компьютерах захват движения всё равно работает — используется движок DirectML, для которого не нужна дополнительная загрузка.

Если загрузка завершилась ошибкой

Под статусом группы появляется короткое сообщение. Устраните причину и снова нажмите Загрузить. Файл, загрузка которого не удалась, будет получен заново с самого начала.

Сообщение	Что делать
check your internet connection (проверьте подключение к интернету)	Приложению не удалось связаться с сервером. Проверьте соединение, VPN и брандмауэр, затем повторите попытку.
server temporarily unavailable (сервер временно недоступен)	Сервер загрузки не ответил. Подождите несколько минут и повторите попытку.
Your license does not have access to these models (у вашей лицензии нет доступа к этим моделям)	Ваша лицензия не включает эту функцию. Если считаете, что это не так, обратитесь в поддержку.
insufficient disk space (недостаточно места на диске)	Освободите указанный объём места и повторите попытку.
file not found on server (файл не найден на сервере)	Файл отсутствует на нашей стороне. Обратитесь в поддержку и приложите диагностику (см. ниже).
verification failed (ошибка проверки)	Файл был повреждён при загрузке. Нажмите Восстановить или Загрузить, чтобы получить его заново.
could not be saved to disk (не удалось сохранить на диск)	Приложению не удалось записать файл в папку компонентов. Убедитесь, что антивирус или права доступа к папке не блокируют `C:\ProgramData\Swing Catalyst\components`.

Если одна и та же ошибка повторяется, пришлите нам диагностику.

Диагностика для поддержки

Откройте Настройки > Дополнительные компоненты.
Нажмите Копировать диагностику. Это скопирует текстовую сводку по каждому компоненту: его версию, статус и папку компонентов.
Вставьте её в письмо в поддержку.

Чтобы увидеть больше подробностей, нажмите Показать технические детали внизу страницы. Для каждой группы отобразятся отдельные файлы с версией, размером, путём и контрольной суммой. Поддержка может попросить у вас скриншот этого экрана.

Удаление файлов

Чтобы освободить место на диске, закройте Swing Catalyst и удалите папку компонентов. При следующем открытии приложения каждая группа снова покажет статус Не установлено, и вы сможете загрузить всё заново.