Szybki start: wdrażanie natywnego przykładu WMR języka C++ na urządzeniu HoloLens
W tym przewodniku Szybki start opisano sposób wdrażania i uruchamiania natywnej aplikacji samouczka C++ Windows Mixed Reality (WMR) w HoloLens 2.
W tym przewodniku Szybki start dowiesz się, jak wykonywać następujące zadania:
- Skompiluj aplikację samouczka dla urządzenia HoloLens.
- Zmień poświadczenia usługi Azure Remote Rendering w kodzie źródłowym.
- Wdróż i uruchom przykład na urządzeniu.
Wymagania wstępne
Aby uzyskać dostęp do usługi Remote Rendering, musisz najpierw utworzyć konto.
Należy zainstalować następujące oprogramowanie:
- Zestaw Windows SDK 10.0.18362.0 lub nowszy.
- Najnowsza wersja programu Visual Studio 2022.
- Narzędzia programu Visual Studio dla Mixed Reality. W szczególności wymagane są następujące instalacje obciążeń :
- Programowanie aplikacji klasycznych w języku C++
- programowanie platforma uniwersalna systemu Windows (UWP)
- Git.
- Wtyczka Git LFS
Klonowanie repozytorium przykładów Remote Rendering
W pierwszym kroku sklonuj repozytorium Git, które zawiera globalne przykłady usługi Azure Remote Rendering. Wpisz cmd w menu Start systemu Windows, aby otworzyć okno wiersza polecenia. Przejdź do katalogu, w którym chcesz przechowywać przykładowy projekt ARR.
Uruchom następujące polecenia:
mkdir ARR
cd ARR
git clone https://github.com/Azure/azure-remote-rendering
Ostatnie polecenie tworzy folder w folderze ARR zawierającym różne przykładowe projekty dla usługi Azure Remote Rendering.
Samouczek dotyczący urządzeń HoloLens języka C++ można znaleźć w folderze NativeCpp/HoloLens-Wmr.
Kompilowanie projektu
Otwórz plik rozwiązania HolographicApp.sln znajdujący się w folderze NativeCpp/HoloLens-Wmr za pomocą programu Visual Studio.
Przełącz konfigurację kompilacji na debugowanie (lub wydanie) i arm64. Upewnij się, że tryb debugera jest ustawiony na Urządzenie w przeciwieństwie do maszyny zdalnej:
Ponieważ poświadczenia konta są zakodowane na stałe w kodzie źródłowym samouczka, zmień je na prawidłowe poświadczenia. Otwórz plik HolographicAppMain.cpp w programie Visual Studio i zmień część, w której klient jest tworzony wewnątrz konstruktora klasy 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));
}
W szczególności zmień następujące wartości:
init.AccountId,init.AccountKeyiinit.AccountDomaindo używania danych konta. Zobacz sekcję dotyczącą pobierania informacji o koncie.- Określ, gdzie utworzyć sesję renderowania zdalnego, modyfikując część
init.RemoteRenderingDomainregionu ciągu dla innych regionów niżwestus2, na przykład"westeurope.mixedreality.azure.com". - Ponadto
m_sessionOverridemożna zmienić na istniejący identyfikator sesji. Sesje można tworzyć poza tym przykładem. Aby uzyskać więcej informacji, zobacz RenderingSession.ps1 lub Bezpośrednio użyj interfejsu API REST zarządzania sesjami .
Tworzenie sesji poza przykładem jest zalecane, gdy próbka powinna być uruchamiana wiele razy. Jeśli żadna sesja nie zostanie przekazana, przykład tworzy sesję po każdym uruchomieniu, co może potrwać kilka minut.
Teraz możesz skompilować aplikację.
Uruchamianie aplikacji
- Podłącz urządzenie HoloLens do komputera przy użyciu kabla USB.
- Włącz urządzenie HoloLens i zaczekaj na wyświetlenie menu Start.
- Uruchom debuger w programie Visual Studio (F5). Automatycznie wdraża aplikację na urządzeniu.
Przykładowa aplikacja zostanie uruchomiona, a zostanie wyświetlony panel tekstowy informujący o bieżącym stanie aplikacji. Stan w czasie uruchamiania to rozpoczęcie nowej sesji lub nawiązanie połączenia z istniejącą sesją. Po zakończeniu ładowania modelu wbudowany model aparatu pojawia się bezpośrednio na pozycji głowy. Occlusion-wise, model silnika współdziała prawidłowo z modułem wirowania, który jest renderowany lokalnie.
Jeśli chcesz ponownie uruchomić przykład później, możesz go również znaleźć w menu Start Urządzenia HoloLens. Może mieć w nim skompilowany wygasły identyfikator sesji.
Następne kroki
Ten przewodnik Szybki start opiera się na wynikach samouczka, w ramach którego wyjaśniono, jak zintegrować wszystkie Remote Rendering powiązane elementy z stockową aplikacją Holographic App. Aby dowiedzieć się, które kroki są niezbędne, wykonaj następujące czynności: