Порядок сбора информации о багах
1. Общая информация
Иногда при проведении игр, а также при тестировании обновлений, в играх и менеджере устройств можно столкнуться с нетипичным поведением ПО, например багами, игровыми вылетами, и прочее.
В таких ситуация рекомендуется собрать как можно более подробную информацию о возникшей проблеме, и отправить ее в технический чат в Mattermost и Discord для дальнейшего рассмотрения.
Как это сделать подробно разберем в следующих пунктах.
2. Что НЕ принято считать багом / игровым сбоем?
Достаточно часто нам пишут про нестабильную работу шлемов, и частые их раскалибровки.
-
ВАЖНО! Раскалибровки в 99% случаев не относятся к багам игр Another World!
На шлемах, чаще на моделях Meta Quest, есть известная проблема с нестабильной работой системы отслеживания, которая может приводить к раскалибровкам шлемов.
Наши игры только подхватывают состояние шлемов, и если система отслеживания шлема будет работать нестабильно → в играх будут возникать проблемы с позиционированием.
К сожалению, со стороны нашего ПО мы никак не можем на это повлиять.
Напомним, что для стабилизации работы отслеживания шлемов есть отдельные рекомендации, с ними можно ознакомиться по ссылкам:
Основные причины раскалибровок
Рекомендации для стабильной работы системы отслеживания шлема
3. Общие рекомендации.
О возникающих проблемах в работе ПО и играх рекомендуем сообщать своевременно, и не откладывать вопрос в долгий ящик!
Достаточно часто партнеры сообщают о проблемах спустя несколько дней, а то и недель, когда собрать нужную информацию о баге уже не представляется возможным.
Рекомендуем отправлять информацию о багах как можно скорее!!!
ВАЖНО! Самый надежный вариант для диагностики проблем - это собрать и отправить информацию о баге сразу после проблемной игры, либо в течение этого же дня до перезапуска Менеджера устройств.
ПРИМЕЧАНИЕ: При перезапуске менеджера устройств логи будут архивированы и перемещены в отдельную папку.
Архивация логов в свою сильно усложняет процесс поиска нужных записей, плюсом сюда идет то, что при архивации часть логов не сохраняется.
Именно поэтому рекомендуется собирать логи сразу после проблемной игры!
4. Порядок сбора информации о проблеме.
Указать общую информацию о проблеме.
-
Описать что именно произошло.
-
Указать в какой момент возникла проблема
-
По возможности указать порядок действий для воспроизведения проблемы.
-
Прочая полезная информация.
Указать версии ПО и игр для которых возникла проблема:
-
Версия менеджера устройств
-
Название и версия игры
-
Размер карты и название используемой карты, название Режима.
-
Прочая полезная информация.
Приложить скриншоты или видео.
-
По возможности сделать скриншот ошибки или записать видео.
Это добавить информативности, и сильно поможет в диагностике.
Собрать и отправить логи.
-
ПРИМЕЧАНИЕ: Сбор логов производится в отдельных случаях, когда нужно более глубоко изучить возникшую проблему.
-
Порядок сбора и отправки логов отдельно рассмотрим в пунктах ниже.
И последним шагом необходимо отправить информацию о проблеме напрямую в технический чат в Mattermost.
5. СБОР ИГРОВЫХ ЛОГОВ.
ВАЖНО! Сбор логов производится в отдельных случаях, когда нужно более глубоко изучить возникшую проблему
-
Есть разные типы логов, которые используются для диагностики различных проблем в играх и в ПО Another World.
-
Каждый тип логов, а также где найти необходимые файлы, рассмотрим в пунктах ниже.
5.1 Логи менеджера устройств.
Логи менеджера устройств рекомендуется высылать на случай, если возникли проблемы в работе Менеджера, например:
-
Внезапное закрытие менеджера
-
Менеджер устройств не запускается
-
Некорректная работа кнопок менеджера устройств.
-
Прочие проблемы в работе менеджера.
Логи менеджера устройств можно найти в следующей папке:
- С:\Another World\VR\devicemanager_[версия]\logs
Для копирования логов менеджера устройства достаточно выделить только файл devicemanager.log (2) → перетащить файл в технический чат в Mattermost (3) и отправить сообщение (4).
5.2 Логи игр с сервера.
Логи игр рекомендуется высылать на случай, если возникли проблемы в работе игр на игровом сервере, например:
-
Некорректное поведение при запуске или остановке игры.
-
Некорректное поведение игры в той или иной игровой фазе
-
Некорректное отображение текстур
-
Прочие игровые проблемы.
Логи игр сохраняются в следующей папке:
-
C:\Another World\VR\data\logs\server\gamesessions (1)
ВАЖНО! При перезапуске менеджера устройств логи будут архивированы и перемещены в другую папку.
-
Архивация логов сильно усложняет процесс поиска нужных записей, именно поэтому мы рекомендуем собирать логи сразу после проблемной игры!
Для копирования логов достаточно просто перетащить лог нужной игры в технический чат в Mattermost (2) и отправить сообщение (3).
5.3 Логи игр со шлемов.
Логи шлемов собираются в случаях:
-
Некорректное поведение шлема во время игры.
-
Некорректное поведение игры в той или иной игровой фазе.
- Прочие игровые проблемы.
ПРИМЕЧАНИЕ: Собирать логи сразу со всех шлемов необязательно. Логи рекомендуем собирать только с тех устройств, на которых возникла проблема.
ВАЖНО! Для сбора логов со шлема обязательно необходимо подключить шлем по кабелю к серверу! В момент подключения шлема по кабелю логи будут скопированы на игровой сервер.
После подключения шлема по кабелю логи шлема можно будет найти в папке:
-
C:\Another World\VR\data\logs\server\agents (1)
ВАЖНО! При перезапуске менеджера устройств логи шлемов будут архивированы и перемещены в другую папку!
-
Архивация логов сильно усложняет процесс поиска нужных записей, именно поэтому мы рекомендуем собирать логи сразу после проблемной игры!
Для копирования логов достаточно просто перетащить файл лога нужного шлема в технический чат в Mattermost (2) и отправить сообщение (3).
— — —