Uruchamianie przykładowej aplikacji: HoloLens — Unity (C#)
W tym przewodniku Szybki start uruchomisz przykładową aplikację usługi Azure Spatial Anchors dla urządzenia HoloLens przy użyciu aparatu Unity (C#). Spatial Anchors to międzyplatformowa usługa deweloperska, która umożliwia tworzenie środowisk rzeczywistości mieszanej z obiektami, które utrwalają ich lokalizację na urządzeniach w czasie. Gdy skończysz, będziesz mieć aplikację dla urządzenia HoloLens utworzoną za pomocą aparatu Unity, która może zapisywać i przywoływać kotwicę przestrzenną.
Dowiesz się, jak:
- Utwórz konto usługi Spatial Anchors.
- Przygotowywanie ustawień kompilacji aparatu Unity.
- Skonfiguruj identyfikator konta usługi Spatial Anchors i klucz konta.
- Wyeksportuj projekt programu Visual Studio dla urządzenia HoloLens.
- Wdróż aplikację i uruchom ją na urządzeniu HoloLens.
Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure.
Wymagania wstępne
Aby ukończyć ten przewodnik Szybki start:
- Potrzebujesz urządzenia HoloLens z włączonym trybem dewelopera. W przypadku urządzenia HoloLens 2 na urządzeniu musi być zainstalowana aktualizacja systemu Windows 10 z maja 2020 r. lub nowsza wersja. Aby zaktualizować najnowszą wersję na urządzeniu HoloLens, otwórz aplikację Ustawienia, przejdź do pozycji Aktualizuj i zabezpieczenia, a następnie wybierz pozycję Sprawdź dostępność aktualizacji.
- Potrzebny jest komputer z systemem Windows z zainstalowanym programem Visual Studio 2019 lub nowszym. Instalacja programu Visual Studio musi zawierać obciążenie programowania platforma uniwersalna systemu Windows oraz składnik Windows 10 SDK (10.0.18362.0 lub nowszy). Należy również zainstalować usługę Git dla systemów Windows i Git LFS.
- Musisz mieć zainstalowany aparat Unity. Aby zapoznać się z obsługiwanymi wersjami i wymaganymi możliwościami, odwiedź stronę konfiguracji projektu aparatu Unity.
Tworzenie zasobu usługi Spatial Anchors
Przejdź do portalu Azure Portal.
W okienku po lewej stronie wybierz pozycję Utwórz zasób.
Użyj pola wyszukiwania, aby wyszukać usługi Spatial Anchors.
Wybierz pozycję Zakotwiczenia przestrzenne, a następnie wybierz pozycję Utwórz.
W okienku Konto usługi Spatial Anchors wykonaj następujące czynności:
Wprowadź unikatową nazwę zasobu przy użyciu zwykłych znaków alfanumerycznych.
Wybierz subskrypcję, do której chcesz dołączyć zasób.
Utwórz grupę zasobów, wybierając pozycję Utwórz nową. Nadaj jej nazwę myResourceGroup, a następnie wybierz przycisk OK.
Grupa zasobów to logiczny kontener, w którym są wdrażane i zarządzane zasoby platformy Azure, takie jak aplikacje internetowe, bazy danych i konta magazynu. Na przykład można później usunąć całą grupę zasobów w jednym prostym kroku.
Wybierz lokalizację (region), w której ma być umieszczany zasób.
Wybierz pozycję Utwórz , aby rozpocząć tworzenie zasobu.
Po utworzeniu zasobu witryna Azure Portal pokazuje, że wdrożenie zostało ukończone.
Wybierz pozycję Przejdź do zasobu. Teraz możesz wyświetlić właściwości zasobu.
Skopiuj wartość identyfikatora konta zasobu do edytora tekstów do późniejszego użycia.
Skopiuj również wartość domeny konta zasobu do edytora tekstów do późniejszego użycia.
W obszarze Ustawienia wybierz pozycję Klucz dostępu. Skopiuj wartość Klucza podstawowego, Klucz konta, do edytora tekstów do późniejszego użycia.
Pobieranie przykładowego projektu i importowanie zestawu SDK
Klonowanie repozytorium przykładów
Sklonuj repozytorium przykładów, uruchamiając następujące polecenia:
git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples
Importowanie zestawu ASA SDK
Postępuj zgodnie z instrukcjami dostępnymi tutaj , aby pobrać i zaimportować pakiety zestawu ASA SDK wymagane dla platformy HoloLens.
Konfigurowanie aparatu Unity
W środowisku Unity otwórz projekt w folderze Unity . Aparat Unity może wyświetlić monit o różnicę między wersją projektu a wersją zainstalowaną na maszynie. To ostrzeżenie jest w porządku, o ile wersja edytora aparatu Unity jest nowsza niż ta, z którą projekt został utworzony. Jeśli wersja jest nowsza, wybierz pozycję Kontynuuj. Jeśli wersja jest starsza niż ta, której potrzebuje projekt, wybierz pozycję Zamknij i uaktualnij edytor aparatu Unity.
Otwórz obszar Build Settings (Ustawienia kompilacji), wybierając pozycje File (Plik)>Build Settings (Ustawienia kompilacji).
W sekcji Platform (Platforma) wybierz pozycję Universal Windows Platform (Platforma uniwersalna systemu Windows). Zmień urządzenie docelowe na HoloLens.
Wybierz pozycję Switch Platform (Przełącz platformę), aby zmienić platformę na Universal Windows Platform (Platforma uniwersalna systemu Windows). Aparat Unity może monitować o zainstalowanie składników obsługi platformy UWP, jeśli ich brakuje.
Zamknij okno Build Settings (Ustawienia kompilacji).
Konfigurowanie informacji o koncie
Następnym krokiem jest skonfigurowanie aplikacji do korzystania z informacji o koncie. Wartości Klucz konta, Identyfikator konta i Domena konta skopiowano wcześniej do edytora tekstów w sekcji "Tworzenie zasobu usługi Spatial Anchors".
W okienku Projekt przejdź do strony Assets\AzureSpatialAnchors.SDK\Resources.
Wybierz pozycję SpatialAnchorConfig. W okienku Inspektor wprowadź jako wartość klucz konta usługi Spatial Anchors, Account ID wartość jako wartość identyfikatora konta usługi Spatial Anchors i Account Domain jako wartość domeny konta usługi Spatial Anchors.Account Key
Eksportowanie projektu programu Visual Studio dla urządzenia HoloLens
Otwórz obszar Build Settings (Ustawienia kompilacji), wybierając pozycje File (Plik)>Build Settings (Ustawienia kompilacji).
W obszarze Sceny w kompilacji upewnij się, że obok wszystkich scen jest znacznik wyboru.
Wybierz pozycję Kompilacja. W oknie dialogowym wybierz folder, w którym chcesz wyeksportować projekt programu Visual Studio HoloLens.
Po zakończeniu eksportowania zostanie wyświetlony folder zawierający wyeksportowany projekt HoloLens.
Wdrażanie aplikacji dla urządzenia HoloLens
W folderze kliknij dwukrotnie plik HelloAR U3D.sln , aby otworzyć projekt w programie Visual Studio.
Zmień konfigurację rozwiązania na Wydanie, zmień platformęrozwiązania na x86, a następnie wybierz pozycję Urządzenie z opcji docelowych wdrożenia.
Jeśli używasz urządzenia HoloLens 2, użyj arm64 jako platformy rozwiązań zamiast x86.
Włącz urządzenie HoloLens, zaloguj się i podłącz urządzenie do komputera przy użyciu kabla USB.
Wybierz pozycje Debugowanie>Rozpocznij debugowanie, aby wdrożyć swoją aplikację i rozpocząć debugowanie.
W aplikacji wybierz pozycję BasicDemo za pomocą strzałek, a następnie naciśnij przycisk Przejdź! , aby uruchomić pokaz. Postępuj zgodnie z instrukcjami, aby umieścić i odwołać kotwicę.
W programie Visual Studio zatrzymaj aplikację, wybierając pozycję Zatrzymaj debugowanie lub Shift+F5.
Czyszczenie zasobów
W poprzednich krokach utworzono zasoby platformy Azure w grupie zasobów. Jeśli nie będziesz już potrzebować tych zasobów w przyszłości, możesz je usunąć przez usunięcie grupy zasobów.
W menu witryny Azure Portal lub na stronie głównej wybierz pozycję Grupy zasobów. Następnie na stronie Grupy zasobów wybierz pozycję myResourceGroup.
Na stronie myResourceGroup upewnij się, że wymienione zasoby są tymi, które chcesz usunąć.
Wybierz pozycję Usuń grupę zasobów, wpisz myResourceGroup w polu tekstowym, aby potwierdzić, a następnie wybierz pozycję Usuń.
Następne kroki
W tym przewodniku Szybki start utworzono konto usługi Spatial Anchors. Następnie skonfigurowano i wdrożono aplikację do zapisywania i odwoływania kotwic przestrzennych. Aby dowiedzieć się więcej na temat ulepszania aplikacji w celu udostępniania kotwic przestrzennych innym urządzeniom, przejdź do następnego samouczka.