Профилирование с помощью Unreal InsightsProfiling with Unreal Insights

Нереалная аналитика — это система профилирования, собирающая, анализирующая и визуализирующая данные из нереального механизма.Unreal Insights is a profiling system that collects, analyzes, and visualizes data from Unreal Engine. Система профилирования помогает найти узкие места оптимизации и области, в которых производительность приложений может увеличиться.The profiling system can help you find optimization bottlenecks and areas where you apps performance could use a boost. Как правило, вы включаете функцию "неreal Insights" прямо из редактора, но для HoloLens 2 потребуется использовать командную строку.Normally, you enable Unreal Insights right from the editor, but for HoloLens 2 you'll need to use the command line.

НастройкаSetup

Нереал. позволяет создать и настроить "настраиваемый профиль" в средстве запуска HoloLens с параметрами командной строки, которые включают неreal Insights.Unreal lets you to create and configure a "Custom Profile" in the HoloLens launcher with the command line parameters that enable Unreal Insights.

  1. Найдите IP-адрес компьютера с помощью команды ipconfig в командной строке.Find the IP address of your computer using the ipconfig command on the command prompt. IP-адрес — это адрес IPv4, указанный в ipconfig.The IP address is the IPv4 address listed by ipconfig. Помните об этом при настройке параметров командной строки.Keep this in mind for later when you set Command Line Parameters.

Важно!

Если вы находитесь за VPN, вам может потребоваться предоставить IP-адрес, предоставленный через VPN.If you're behind a VPN, you may need to provide the IP address provided via the VPN instead.

Снимок экрана: результаты командной строки для команды ipconfig

  1. Перейдите в начало панели нереала и откройте Device Manager под кнопкой запуска :Go to the top of the Unreal Engine panel and open Device Manager under the Launch button:

Снимок экрана параметров запуска с выделенным диспетчером устройств

  1. В Device Manager выберите Добавить устройство, которое не было добавлено в список.In the Device Manager, select Add an Unlisted Device:

Снимок экрана: Открытие диспетчера устройств в нереальном ядре

  1. Щелкните выбрать платформу и выберите HoloLens:Click Select a platform and choose HoloLens:

Снимок экрана: Добавление раскрывающегося списка непоставленных устройств с выделенным HoloLens

  1. Если вы используете Иповерусб, введите 127.0.0.1:10080 в качестве идентификатора устройства.If you're using IPoverUSB, enter 127.0.0.1:10080 as the Device Identifier. Введите имя пользователя и пароль HoloLens в соответствующие поля и заполните Отображаемое название по своему усмотрению.Enter your HoloLens user and password in their respective fields and fill Display Name as you wish.

Важно!

Идентификатор устройства — это IP-адрес HoloLens, а не компьютер с нереальными сведениями, найденными на шаге 1.The Device Identifier is the IP address of the HoloLens, NOT of the computer running Unreal Insights you found in step 1.

Снимок экрана сведений об устройстве HoloLens в диспетчере устройств

  1. Выберите Добавить , и HoloLens должен появиться в списке устройств диспетчера устройств:Select Add and your HoloLens should appear in the device list of the device manager:

Снимок экрана: HoloLens добавлен в список устройств

LaunchLaunch

  1. Откройте средство запуска проектов на панели UE4 под кнопкой запустить :Open Project Launcher from the UE4 panel under the Launch button:

Снимок экрана параметров запуска с выделенным средством запуска проекта

  1. Нажмите + кнопку, чтобы создать настраиваемый профиль в разделе пользовательские профили запуска.Select the + button to create a custom profile under Custom Launch Profiles. После создания этот профиль можно изменить позже:Once created, you can always edit this profile later:

Снимок экрана средства запуска проекта с выделенными пользовательскими профилями запуска

  1. Нажмите кнопку изменить профиль в настраиваемом профиле запуска HoloLens и настройте:Select edit profile button on the HoloLens custom launch profile and configure:
    • Выберите в книге Кука , чтобы включить копирование на устройствоSelect Cook to By the Book to enable copying to device
    • Возможно, вы захотите выполнить архивацию в разделе " Архив ", чтобы сохранить созданный. appxbundle вместо удаления, чтобы сэкономить место на диске.You may want to check Do you wish to archive? in the Archive section to retain the generated .appxbundle rather than deleting to save disk space. Укажите расположение для appxbundle и переключитесь на сборку разработки, если хотитеSpecify a location for the .appxbundle and switch to a development build if you wish

Снимок экрана с параметрами Кука в конфигурации профиля с Кука, выделенной книгой и HoloLens

  1. Укажите, как вы хотите развернуть сборку? для копирования на устройство , чтобы активировать раздел запуска пользовательского интерфейса:Set How would you like to deploy the build? to Copy to device to activate the Launch section of the UI:

Снимок экрана средства запуска проектов с параметрами развертывания с выделенным копированием в устройство

  1. Задайте Дополнительные параметры командной строки в разделе Launch .Set Additional Command Line Parameters in the Launch section. Параметры записываются в файл ue4commandline.txt, упаковываются в пакет и используются при запуске.The parameters will be written into a ue4commandline.txt file, packaged into the bundle, and used at launch.

Примечание

"IP_OF_YOUR_PC" — это IP-адрес, найденный на шаге 1."IP_OF_YOUR_PC" is the IP address we found in step 1. Это IP-адрес компьютера, на котором выполняются нереальные аналитические сведения, а не IP-адрес HoloLens.This is the IP address of the computer running Unreal Insights, NOT the IP address of the HoloLens.

Важно!

Трассировка может значительно быстро получиться.Traces can get large very quickly. Включайте только те каналы, которые необходимы для обеспечения низкого размера трассировки.Enable only those channels you need to keep trace size low.

Снимок экрана параметров конфигурации запуска

  1. Запустите нереалную аналитику перед запуском приложения, иначе нереальное понимание не сможет выполнить правильную инициализацию приложения:Launch Unreal Insights BEFORE app launch, otherwise Unreal Insights wont be able to initialize appropriately before the app:
    • Исполняемый файл неreal Insights хранится в папке обработчика двоичных файлов, как правило, следующим образом: "C:\Program Филес\епик Games\UE_4.26\Engine\Binaries\Win64\UnrealInsights.exe".The Unreal Insights executable is stored in the binaries engine folder, usually as follows: "C:\Program Files\Epic Games\UE_4.26\Engine\Binaries\Win64\UnrealInsights.exe"

Снимок экрана исполняемого файла неreal Insights

  1. Нажмите кнопку назад , чтобы вернуться в корневую папку диалогового окна запуска проекта .Select Back to return to the root of the Project Launcher dialog
  2. В редакторе щелкните запустить в настраиваемом профиле запуска.Back in the editor, Click Launch on your custom launch profile

Снимок экрана с пользовательскими профилями запуска

  1. Следите за тем, чтобы проект был упакован, установлен на устройстве и запущен.Watch as your project is packaged up, installed on your device, and launched

ПрофилированиеProfiling

Вернувшись в нереалную аналитику, выберите активное подключение к устройству для запуска профилирования.Back in Unreal Insights, select the Live connection to your device to start profiling

Пользовательский профиль является общим для проектов.The custom profile is shared between projects. Здесь вы можете использовать созданный вами пользовательский профиль вместо того, чтобы делать это каждый раз.From here on out, you can use the custom profile you created instead of having to do this every time. Подключение к устройству необходимо создать заново при каждом запуске нереального действия с шагами 3 – 6 в разделе Настройка.You only need to recreate the connection to the device every time you start Unreal with steps 3 to 6 in the setup section.

См. также разделSee also