Краткое руководство. Развертывание примера собственного приложения WMR на C++ в HoloLens

Статья
03/09/2023

В этом кратком руководстве описано, как развернуть и запустить собственное приложение windows Смешанная реальность (WMR) для HoloLens 2.

Из этого краткого руководства вы узнаете, как:

создание учебного приложения для HoloLens;
Измените учетные данные Azure Удаленная отрисовка в исходном коде.
развертывание и запуск примера на устройстве.

Необходимые компоненты

Чтобы получить доступ к службе Удаленная отрисовка, сначала необходимо создать учетную запись.

Необходимо установить следующее программное обеспечение:

Windows SDK 10.0.18362.0 или более поздней версии.
Последняя версия Visual Studio 2022.
Средства Visual Studio для службы "Смешанная реальность". В частности, требуются следующие установки рабочей нагрузки :
- Разработка классических приложений на C++.
- Разработка приложений для универсальной платформы Windows (UWP).
Git.
Подключаемый модуль Git LFS

Клонирование репозитория примеров Удаленная отрисовка

На первом шаге клонируйте репозиторий Git, в котором размещаются глобальные примеры Удаленная отрисовка Azure. Введите cmd в Windows меню , чтобы открыть окно командной строки. Перейдите в каталог, в котором вы хотите сохранить пример проекта ARR.

Выполните следующие команды:

mkdir ARR
cd ARR
git clone https://github.com/Azure/azure-remote-rendering

Последняя команда создает папку в папке ARR, которая содержит различные примеры проектов для Azure Удаленная отрисовка.

Руководство по C++ HoloLens можно найти в папке NativeCpp/HoloLens-Wmr.

Сборка проекта

Откройте файл решения HolographicApp.sln , расположенный в папке NativeCpp/HoloLens-Wmr с помощью Visual Studio.

Включите конфигурацию сборки Debug (Отладка) или Release (Выпуск) и укажите платформу ARM64. Убедитесь, что для режима отладчика задано значение Device вместо удаленного компьютера:

Снимок экрана: область конфигурации Visual Studio со значениями, как описано ниже.

Так как учетные данные учетной записи жестко задаются в исходном коде учебника, укажите вместо них действительные учетные данные. Откройте файл HolographicAppMain.cpp в Visual Studio и измените часть, в которой клиент создается внутри конструктора класса HolographicAppMain:

// 2. Create Client
{
    // Users need to fill out the following with their account data and model
    RR::SessionConfiguration init;
    init.AccountId = "00000000-0000-0000-0000-000000000000";
    init.AccountKey = "<account key>";
    init.RemoteRenderingDomain = "westus2.mixedreality.azure.com"; // <change to the region that the rendering session should be created in>
    init.AccountDomain = "westus2.mixedreality.azure.com"; // <change to the region the account was created in>
    m_modelURI = "builtin://Engine";
    m_sessionOverride = ""; // If there is a valid session ID to re-use, put it here. Otherwise a new one is created
    m_client = RR::ApiHandle(RR::RemoteRenderingClient(init));
}

В частности, измените следующие значения:

init.AccountId, init.AccountKey и init.AccountDomain должны содержать данные для вашей учетной записи. См. раздел о том, как получить сведения об учетной записи.
Укажите, где следует создать сеанс удаленной подготовки к отрисовке, изменив указывающую на регион часть в строке init.RemoteRenderingDomain на регионы, отличные от westus2, например "westeurope.mixedreality.azure.com".
Кроме того, вместо m_sessionOverride можно указать существующий идентификатор сеанса. Сеансы можно создавать вне этого примера. Дополнительные сведения см. в разделе RenderingSession.ps1 или использование REST API управления сеансами напрямую.

Мы рекомендуем создавать сеанс за пределами примера, если его нужно выполнять несколько раз. Если сеанс не передается, образец создает сеанс при каждом запуске, что может занять несколько минут.

Теперь можно скомпилировать приложение.

Запуск приложения

Подключите HoloLens к компьютеру по USB-кабелю.
Включите HoloLens и подождите, пока появится начальное меню.
Запустите отладчик в Visual Studio (клавиша F5). Он автоматически развертывает приложение на устройстве.

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

Если вы хотите снова запустить пример позже, его также можно найти в меню "Пуск" HoloLens. Он может иметь идентификатор сеанса с истекшим сроком действия, скомпилированный в него.

Следующие шаги

Это краткое руководство основано на результатах, полученных при работе с руководством по интеграции всех элементов службы "Удаленная отрисовка" с базовым примером Holographic App. Необходимые действия собраны в следующем руководстве:

Руководство по интеграции Удаленная отрисовка в приложение HoloLens Holographic

Поделиться через