Uruchamianie przykładowej aplikacji: Android — Xamarin (C#)
W tym przewodniku Szybki start opisano sposób uruchamiania przykładowej aplikacji usługi Azure Spatial Anchors dla urządzeń z systemem Android przy użyciu platformy Xamarin (C#). Azure Spatial Anchors to usługa dla deweloperów programujących dla wielu platform, która pozwala kreować rozwiązania z rzeczywistością mieszaną z użyciem obiektów, których lokalizacja jest taka sama na różnych urządzeniach mimo upływu czasu. Po zakończeniu będziesz mieć aplikację dla systemu Android, która może zapisywać i przywoływać kotwicę przestrzenną.
Dowiesz się, jak:
- Tworzenie konta usługi Spatial Anchors
- Konfigurowanie identyfikatora i klucza konta usługi Spatial Anchors
- Wdrażanie i uruchamianie na urządzeniu z systemem Android
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, upewnij się, że dysponujesz następującymi elementami:
- Komputer z systemem Windows lub macOS:
- W przypadku korzystania z systemu Windows:
- Aktualna wersja programu Visual Studio 2019 w wersji 16.2 lub nowszej.
- Git dla systemu Windows.
- Git LFS.
- W przypadku korzystania z systemu macOS:
- Aktualna wersja Visual Studio dla komputerów Mac 8.1 lub nowszej.
- Git dla systemu macOS.
- Git LFS.
- W przypadku korzystania z systemu Windows:
- Najnowsza wersja platformy Xamarin.Android zainstalowana i uruchomiona na wybranej platformie. Aby zapoznać się z przewodnikiem dotyczącym instalowania platformy Xamarin.Android, zapoznaj się z przewodnikami instalacji platformy Xamarin.Android.
- Urządzenie z systemem Android pracujące w trybie dewelopera i zgodne z platformą ARCore.
- Aby komputer mógł komunikować się z urządzeniem z systemem Android, może być wymagane dodatkowe sterowniki urządzeń. Więcej informacji można znaleźć tutaj.
- Aplikacja musi być docelowa arcore 1.8.
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.
Otwieranie przykładowego projektu
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
Otwórz plik Xamarin/SampleXamarin.sln w programie Visual Studio.
Konfigurowanie identyfikatora i klucza konta
Następnym krokiem jest skonfigurowanie aplikacji do używania identyfikatora konta i klucza konta. Skopiowano je do edytora tekstów podczas konfigurowania zasobu usługi Spatial Anchors.
Otwórz Xamarin/SampleXamarin.Common/AccountDetails.cs.
Znajdź pole SpatialAnchorsAccountKey i zastąp wartość Set me kluczem konta.
Znajdź pole SpatialAnchorsAccountId i zastąp wartość Set me identyfikatorem konta.
SpatialAnchorsAccountDomain Znajdź pole i zastąp ciąg Set me domeną konta.
Wdrażanie aplikacji na urządzeniu z systemem Android
Włącz urządzenie z systemem Android, zaloguj się i połącz go z komputerem przy użyciu USB.
Ustaw projekt startowy na SampleXamarin.Android, zmień konfigurację rozwiązania na Wydanie, a następnie wybierz urządzenie, do którego chcesz wdrożyć, na liście rozwijanej selektora urządzeń.
W aplikacji wybierz pozycję Podstawowa , aby uruchomić pokaz i postępować zgodnie z instrukcjami, aby umieścić i odwołać kotwicę.
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.