Szybki Start: Tworzenie aplikacji dla systemu Android z zakotwiczeniami przestrzennymi platformy AzureQuickstart: Create a Xamarin Android app with Azure Spatial Anchors

W tym przewodniku szybki start opisano sposób tworzenia aplikacji systemu Android przy użyciu funkcji Azure przestrzenny kotwic.This quickstart covers how to create an Android app with Xamarin using Azure Spatial Anchors. 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.Azure Spatial Anchors is a cross-platform developer service that allows you to create mixed reality experiences using objects that persist their location across devices over time. Po zakończeniu będziesz mieć aplikację systemu Android, która będzie mogła zapisywać i odwoływać kotwicę przestrzenną.When you're finished, you'll have an Android app that can save and recall a spatial anchor.

Omawiane tematy:You'll learn how to:

  • Tworzenie konta usługi Spatial AnchorsCreate a Spatial Anchors account
  • Konfigurowanie identyfikatora i klucza konta usługi Spatial AnchorsConfigure the Spatial Anchors account identifier and account key
  • Wdrażanie i uruchamianie na urządzeniu z systemem AndroidDeploy and run on an Android device

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem Utwórz bezpłatne konto .If you don't have an Azure subscription, create a free account before you begin.

Wymagania wstępnePrerequisites

Aby ukończyć ten przewodnik Szybki start, upewnij się, że dysponujesz następującymi elementami:To complete this quickstart, make sure you have:

Tworzenie zasobu usługi Spatial AnchorsCreate a Spatial Anchors resource

Przejdź do witryny Azure Portal.Go to the Azure portal.

W okienku po lewej stronie wybierz pozycję Utwórz zasób.On the left pane, select Create a resource.

Użyj pola wyszukiwania, aby wyszukać Spatial Anchors .Use the search box to search for Spatial Anchors.

Zrzut ekranu przedstawiający wyniki wyszukiwania Spatial Anchors.

Wybierz Spatial Anchors, a następnie wybierz pozycję Utwórz.Select Spatial Anchors, and then select Create.

W okienku Spatial Anchors konto wykonaj następujące czynności:On the Spatial Anchors Account pane, do the following:

  • Wprowadź unikatową nazwę zasobu przy użyciu zwykłych znaków alfanumerycznych.Enter a unique resource name by using regular alphanumeric characters.

  • Wybierz subskrypcję, do której chcesz dołączyć zasób.Select the subscription that you want to attach the resource to.

  • Utwórz grupę zasobów, wybierając pozycję Utwórz nową.Create a resource group by selecting Create new. Nadaj jej nazwę myResourceGroup, a następnie wybierz przycisk OK.Name it myResourceGroup, and then select 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.A resource group is a logical container into which Azure resources, such as web apps, databases, and storage accounts, are deployed and managed. Na przykład można później usunąć całą grupę zasobów w jednym prostym kroku.For example, you can choose to delete the entire resource group in one simple step later.

  • Wybierz lokalizację (region), w której ma być umieszczany zasób.Select a location (region) in which to place the resource.

  • Wybierz pozycję Nowy, aby rozpocząć tworzenie zasobu.Select New to begin creating the resource.

Zrzut ekranu przedstawiający Spatial Anchors tworzenia zasobu.

Po utworzeniu zasobu w Azure Portal, że wdrożenie jest ukończone.After the resource is created, the Azure portal shows that your deployment is complete.

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

Wybierz pozycję Przejdź do zasobu.Select Go to resource. Teraz możesz wyświetlić właściwości zasobu.You can now view the resource properties.

Skopiuj wartość Account ID zasobu do edytora tekstów do późniejszego użycia.Copy the resource's Account ID value into a text editor for later use.

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.Also copy the resource's Account Domain value into a text editor for later use.

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

W obszarze Ustawienia wybierz pozycję Klucz.Under Settings, select Key. Skopiuj wartość Klucz podstawowy, Klucz konta, do edytora tekstów do późniejszego użycia.Copy the Primary key value, Account Key, into a text editor for later use.

Zrzut ekranu przedstawiający okienko Klucze dla konta.

Otwieranie przykładowego projektuOpen the sample project

Sklonuj repozytorium przykładów , uruchamiając następujące polecenia:Clone the samples repository by running the following commands:

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.Open Xamarin/SampleXamarin.sln in Visual Studio.

Konfigurowanie identyfikatora i klucza kontaConfigure account identifier and key

Następnym krokiem jest skonfigurowanie aplikacji w taki sposób, aby korzystała z identyfikatora konta i klucza konta.The next step is to configure the app to use your account identifier and account key. Skopiowano je do edytora tekstu podczas konfigurowania zasobów kotwic przestrzennych.You copied them into a text editor when setting up the Spatial Anchors resource.

Otwórz plik Xamarin/SampleXamarin.Common/AccountDetails.cs.Open Xamarin/SampleXamarin.Common/AccountDetails.cs.

Znajdź pole SpatialAnchorsAccountKey i zastąp wartość Set me kluczem konta.Locate the SpatialAnchorsAccountKey field and replace Set me with the account key.

Znajdź pole SpatialAnchorsAccountId i zastąp wartość Set me identyfikatorem konta.Locate the SpatialAnchorsAccountId field and replace Set me with the account identifier.

Znajdź SpatialAnchorsAccountDomain pole i Zastąp Set me je domeną konta.Locate the SpatialAnchorsAccountDomain field and replace Set me with the account domain.

Wdrażanie aplikacji na urządzeniu z systemem AndroidDeploy the app to your Android device

Włącz urządzenie z systemem Android, zaloguj się i połącz je z komputerem przy użyciu kabla USB.Power on the Android device, sign in, and connect it to the computer using a USB cable.

Ustaw projekt startowy na SampleXamarin. Android, Zmień konfigurację rozwiązania na Zwolnij, a następnie wybierz urządzenie, które chcesz wdrożyć, na liście rozwijanej selektora urządzeń.Set the startup project to SampleXamarin.Android, change the Solution Configuration to Release, and select the device you want to deploy to in the device selector drop-down.

Zrzut ekranu pokazujący menu umożliwiające wybranie projektu i urządzenia w systemie Windows.

Wybierz kolejno opcje Debuguj > Rozpocznij debugowanie , aby wdrożyć i uruchomić aplikację.Select Debug > Start debugging to deploy and start your app.

W aplikacji wybierz pozycję podstawowa , aby uruchomić demonstrację, i postępuj zgodnie z instrukcjami, aby umieścić i odwołać kotwicę.In the app, select Basic to run the demo and follow the instructions to place and recall an anchor.

Zrzut ekranu 1 zrzut ekranu  2  zrzut ekranu 3Screenshot 1 Screenshot 2 Screenshot 3

Czyszczenie zasobówClean up resources

W poprzednich krokach utworzono zasoby platformy Azure w grupie zasobów.In the preceding steps, you created Azure resources in a resource group. Jeśli nie będziesz już potrzebować tych zasobów w przyszłości, możesz je usunąć przez usunięcie grupy zasobów.If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

W menu Azure Portal lub stronie głównej wybierz pozycję grupy zasobów.From the Azure portal menu or Home page, select Resource groups. Następnie na stronie grupy zasobów wybierz pozycję Grupa zasobów.Then, on the Resource groups page, select myResourceGroup.

Na stronie Moja zasobów upewnij się, że wymienione zasoby są tymi, które chcesz usunąć.On the myResourceGroup page, make sure that the listed resources are the ones you want to delete.

Wybierz pozycję Usuń grupę zasobów, wpisz w polu tekstowym pozycję Moja zasobów , a następnie wybierz pozycję Usuń.Select Delete resource group, type myResourceGroup in the text box to confirm, and then select Delete.

Następne krokiNext steps

W tym przewodniku szybki start utworzono konto zakotwiczeń przestrzennych.In this quickstart, you created a Spatial Anchors account. Następnie skonfigurujesz i wdrożono aplikację w celu zapisywania i odwoływania kotwic przestrzennych.You then configured and deployed an app to save and recall spatial anchors. Aby dowiedzieć się więcej na temat ulepszania aplikacji, dzięki czemu można udostępnić kotwice przestrzenne innym urządzeniom, przejdź do następnego samouczka.To learn more about how to improve the app so it can share spatial anchors with other devices, continue to the next tutorial.