Samouczek: udostępnianie kotwic przestrzenny między sesjami i urządzeniami

Kotwice przestrzenne platformy Azure to wieloplatformowa usługa programistyczna, za pomocą której można tworzyć środowiska o rzeczywistości mieszanej przy użyciu obiektów, które utrzymują swoją lokalizację na różnych urządzeniach w miarę upływu czasu.

W tym samouczku użyjesz kotwic przestrzennych platformy Azure do tworzenia kotwic podczas jednej sesji, a następnie znajdowania ich na tym samym urządzeniu lub innym. Te same kotwice mogą również znajdować się na wielu urządzeniach w tym samym miejscu i w tym samym czasie.

Animacja pokazująca kotwice przestrzenne, które są tworzone za pomocą urządzenia przenośnego i używane z innym urządzeniem w ciągu kilku dni.

Z tego samouczka dowiesz się, jak wykonywać następujące czynności:

  • Wdróż ASP.NET Core aplikację sieci Web na platformie Azure, której możesz użyć do udostępniania kotwic i przechowywania kotwic w pamięci przez określony czas.
  • Skonfiguruj scenę AzureSpatialAnchorsLocalSharedDemo w ramach przykładu aparatu Unity z naszego przewodnika Szybki Start, aby skorzystać z aplikacji sieci Web do udostępniania.
  • Wdróż i uruchom kotwice na jednym lub większej liczbie urządzeń.

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem Utwórz bezpłatne konto .

Wymagania wstępne

Przed rozpoczęciem pracy z tym samouczkiem upewnij się, że zostały spełnione następujące wymagania wstępne:

Uwaga

W tym samouczku będziesz używać aplikacji sieci Web w technologii Unity i ASP.NET Core, ale podejście tutaj dotyczy tylko przykładowego sposobu udostępniania identyfikatorów kotwice przestrzenne platformy Azure na innych urządzeniach. Możesz użyć innych języków i technologii zaplecza, aby osiągnąć ten sam cel.

Tworzenie zasobu usługi Spatial Anchors

Przejdź do witryny Azure Portal.

W okienku po lewej stronie wybierz pozycję Utwórz zasób.

Użyj pola wyszukiwania, aby wyszukać Spatial Anchors .

Zrzut ekranu przedstawiający wyniki wyszukiwania Spatial Anchors.

Wybierz Spatial Anchors, a następnie wybierz pozycję Utwórz.

W okienku Spatial Anchors konto 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 sieci Web, 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.

Zrzut ekranu przedstawiający Spatial Anchors tworzenia zasobu.

Po utworzeniu zasobu w Azure Portal, że wdrożenie jest ukończone.

Zrzut ekranu przedstawiający ukończenie wdrażania zasobów.

Wybierz pozycję Przejdź do zasobu. Teraz możesz wyświetlić właściwości zasobu.

Skopiuj wartość Account ID zasobu do edytora tekstów do późniejszego użycia.

Zrzut ekranu przedstawiający okienko właściwości zasobu.

Skopiuj również wartość Account Domain zasobu do edytora tekstów do późniejszego użycia.

Zrzut ekranu przedstawiający wartość domeny konta zasobu.

W obszarze Ustawienia wybierz pozycję Klucz dostępu. Skopiuj wartość Klucz podstawowy, Klucz konta, do edytora tekstów do późniejszego użycia.

Zrzut ekranu przedstawiający okienko Klucze dla konta.

Pobierz przykładowy projekt

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

Wdrażanie usługi zakotwiczenia udostępniania

Otwórz program Visual Studio, a następnie otwórz projekt w folderze Sharing\SharingServiceSample .

Otwieranie Kreatora publikacji

W Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt SharingService , a następnie wybierz pozycję Publikuj.

Zostanie uruchomiony Kreator publikowania.

Wybierz pozycję App Service > Opublikuj , aby otworzyć okienko Tworzenie App Service .

Logowanie się do platformy Azure

Zaloguj się do witryny Azure Portal.

W okienku tworzenie App Service wybierz pozycję Dodaj konto, a następnie zaloguj się do subskrypcji platformy Azure. Jeśli użytkownik jest już zalogowany, wybierz żądane konto z listy rozwijanej.

Uwaga

Jeśli przeprowadzono już logowanie, nie wybieraj jeszcze pozycji Utwórz.

Tworzenie grupy zasobów

Grupa zasobów to logiczny kontener, w którym są wdrażane i zarządzane zasoby platformy Azure, takie jak aplikacje sieci Web, bazy danych i konta magazynu. Na przykład można później usunąć całą grupę zasobów w jednym prostym kroku.

Obok pozycji Grupa zasobów wybierz pozycję Nowa.

Nadaj nazwę grupie zasobów, a następnie wybierz przycisk OK.

Tworzenie planu usługi App Service

Plan usługi App Service określa lokalizację, rozmiar i funkcje farmy serwerów sieci Web, która jest hostem aplikacji. Możesz zaoszczędzić pieniądze w przypadku hostowania wielu aplikacji, konfigurując aplikacje sieci Web do udostępniania jednego planu App Service.

Plany usługi App Service definiują następujące elementy:

  • Region (na przykład: Europa Północna, wschodnie stany USA, Azja Południowo-Wschodnia)
  • Rozmiar wystąpienia (mały, średni, duży)
  • Skala (od 1 do 20 wystąpień)
  • Warstwa cenowa (Bezpłatna, Współdzielona, Podstawowa, Standardowa, Premium)

Obok pozycji Plan hostingu wybierz pozycję Nowy.

W okienku Konfigurowanie planu hostingu Użyj następujących ustawień:

Ustawienie Sugerowana wartość Opis
Plan usługi App Service MySharingServicePlan Nazwa planu App Service
Lokalizacja Zachodnie stany USA Centrum danych, w którym jest hostowana aplikacja sieci Web
Rozmiar Bezpłatna Warstwa cenowa , która określa funkcje hostingu

Wybierz przycisk OK.

Tworzenie i publikowanie aplikacji internetowej

W polu Nazwa aplikacji wprowadź unikatową nazwę aplikacji. Prawidłowe znaki to a-z, 0-9 i kreski (-) lub akceptują automatycznie wygenerowaną unikatową nazwę. Adres URL aplikacji internetowej to https://<app_name>.azurewebsites.net, gdzie <app_name> to nazwa aplikacji.

Wybierz pozycję Utwórz, aby rozpocząć tworzenie zasobów platformy Azure.

Po zakończeniu pracy Kreatora publikuje ASP.NET Core aplikację sieci Web na platformie Azure, a następnie otwiera aplikację w domyślnej przeglądarce.

Zrzut ekranu opublikowanej aplikacji sieci Web ASP.NET na platformie Azure.

Nazwa aplikacji użyta w tej sekcji jest używana jako prefiks adresu URL w formacie https://<app_name>.azurewebsites.net . Skopiuj ten adres URL do edytora tekstów w celu późniejszego użycia.

Wdrażanie przykładowej aplikacji

Przykład Java dla systemu Android obsługuje udostępnianie między urządzeniami.

W Android Studio Otwórz plik Shared. Java w folderze Samples.

Wprowadź adres URL skopiowany w poprzednim kroku (z wdrożenia aplikacji sieci Web ASP.NET Azure) jako wartość dla SharingAnchorsServiceUrl w pliku Shared. Java .

Zastąp index.html adres URL adresem api/anchors . Powinien wyglądać następująco: https://<app_name>.azurewebsites.net/api/anchors .

Wdróż aplikację na urządzeniu.

Po uruchomieniu aplikacji w okienku Wybierz demonstrację Użyj strzałek w lewo i w prawo, aby wybrać opcję LocalShare . Następnie naciśnij pozycję Przejdź!.

Postępuj zgodnie z instrukcjami w aplikacji. Możesz wybrać opcję Utwórz zakotwiczenie udostępniania & lub zlokalizować zakotwiczenie udostępnione.

Dzięki zakotwiczeniem tworzenia & udostępniania można utworzyć kotwicę i zapisać ją w usłudze udostępniania. W polu Zwróć zostanie zwrócony identyfikator, którego można użyć, aby pobrać go z usługi udostępniania. Następnie można uruchomić drugi scenariusz, zlokalizować zakotwiczenie udostępnione na urządzeniu lub innym.

Przy użyciu okna Znajdź zakotwiczenie udostępnione możesz zlokalizować wcześniej udostępnione kotwice, wprowadzając wymieniony wcześniej identyfikator. Po wybraniu scenariusza aplikacja przeprowadzi Cię przez użytkownika z dalszych instrukcji. Na przykład użytkownik zostanie poproszony o przeniesienie urządzenia do programu w celu zebrania informacji o środowisku. Później Umieść kotwicę na świecie, poczekaj na jego zapis, Rozpocznij nową sesję, a następnie znajdź ją.

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 Azure Portal lub stronie głównej wybierz pozycję grupy zasobów. Następnie na stronie grupy zasobów wybierz pozycję Grupa zasobów.

Na stronie Moja zasobów upewnij się, że wymienione zasoby są tymi, które chcesz usunąć.

Wybierz pozycję Usuń grupę zasobów, wpisz w polu tekstowym pozycję Moja zasobów , a następnie wybierz pozycję Usuń.

Następne kroki

W tym samouczku wdrożono ASP.NET Core aplikację sieci Web na platformie Azure i skonfigurowano i wdrożono aplikację Unity. Utworzono kotwice przestrzenne z aplikacją i udostępniono je innym urządzeniom za pomocą aplikacji sieci Web ASP.NET Core.

Możesz ulepszyć ASP.NET Core aplikację sieci Web, tak aby używała Azure Cosmos DB do utrwalania magazynu udostępnionych identyfikatorów kotwic przestrzennych. Dzięki obsłudze Azure Cosmos DB można w aplikacji internetowej ASP.NET Core utworzyć kotwicę dzisiaj. Następnie przy użyciu identyfikatora zakotwiczenia, który jest przechowywany w aplikacji sieci Web, możesz później wrócić do aplikacji, aby ponownie zlokalizować zakotwiczenie.