Установка Unity SDK

Playtrace записывает выбранные геймплейные повторы внутри вашего Unity-проекта. SDK использует SDK-ключ проекта, чтобы получить активную кампанию записи, загрузить настройки захвата и отправлять только те клипы, которые подходят под условия этой кампании.

Требования

• Unity-проект для Windows или Android. Unity Editor поддерживается для локального тестирования.
• Аккаунт Playtrace с созданной компанией и проектом в панели управления.
• Доступ к SDK-ключу проекта из раздела Настройки проекта.

Добавление файлов SDK

1. Откройте ваш Unity-проект.
2. Импортируйте пакет через Assets > Import Package > Custom Package и выберите файл SDK .unitypackage.
3. Дождитесь, пока Unity скомпилирует проект.

После импорта пакета в папке Assets появится папка Playtrace.

Сохраняйте импортированную папку SDK в системе контроля версий вместе с остальным Unity-проектом, если у вашей команды нет отдельного процесса управления пакетами.

Копирование SDK-ключа

1. Откройте панель управления Playtrace.
2. Выберите проект для этой игры.
3. Откройте Настройки проекта.
4. Скопируйте SDK key из раздела Unity SDK.

SDK-ключ идентифицирует проект Playtrace. Это не пользовательский токен входа, но его сброс сразу отключит сборки, которые всё ещё используют старый ключ.

Настройка SDK

Откройте Unity и перейдите в Edit > Project Settings > Playtrace и вставьте SDK-ключ со страницы настроек проекта.

Создание кампании записи

SDK записывает повторы только тогда, когда есть подходящая активная кампания.

1. В панели управления откройте проект.
2. Создайте кампанию записи.
3. Выберите платформы, записи с которых вы хотите увидеть. Для тестирования в Play Mode убедитесь, что выбрана платформа Editor.
4. Выберите стартовое событие, правило записи, правило загрузки, качество захвата и лимит повторов.
5. Запустите кампанию.

Если ни одна активная кампания не подходит под игровую сессию, SDK остаётся неактивным и не записывает повторы.

Отправка геймплейных событий

Кампании работают на основе точных имён событий с учётом регистра. Используйте постоянные имена в нижнем регистре и сохраняйте их одинаковыми между сборками.

PlaytraceEvents.Emit("tutorial_started");
PlaytraceEvents.Emit("tutorial_finished");

SDK автоматически отправляет lifecycle-события game_paused и game_unpaused, если они поддерживаются текущей платформой. Playtrace обрабатывает их так же, как обычные события кампании.

Не отправляйте game_paused и game_unpaused вручную без необходимости, так как это может привести к дублированию событий.

Проверка настройки

1. Запустите собранный билд на платформе, которую вы выбрали при настройках кампании или в Play Mode, если была выбрана платформа Editor.
2. Вызовите стартовое событие кампании.
3. Завершите или провалите сценарий в соответствии с правилом загрузки кампании.
4. Откройте кампанию в панели управления и проверьте список повторов после завершения обработки.

Если повтор не появился, проверьте, что SDK-ключ актуален, кампания активна, фильтр платформы совпадает, имя стартового события совпадает точно, запись подходит под условия загрузки, а лимит повторов ещё не достигнут.