Den här snabbstarten beskriver hur du kör Azure Spatial Anchors-exempelappen för Android-enheter med Xamarin (C#). Azure Spatial Anchors är en plattformsoberoende utvecklartjänst som du kan använda för att skapa upplevelser med mixad verklighet med hjälp av objekt som bevarar sin plats mellan enheter över tid. När du är klar har du en Android-app som kan spara och återkalla ett rumsligt fästpunkt.
Du lär dig att:
Skapa ett Spatial Anchors-konto
Konfigurera kontoidentifierare och kontonyckel för Spatial Anchors
Den senaste versionen av Xamarin.Android har installerats och körts på valfri plattform. En guide för att installera Xamarin.Android finns i installationsguiderna för Xamarin.Android.
Använd sökrutan för att söka efter Spatial Anchors.
Välj Spatial Anchors och välj sedan Skapa.
Gör följande i fönstret Spatial Anchors-konto :
Ange ett unikt resursnamn med hjälp av vanliga alfanumeriska tecken.
Välj den prenumeration som du vill koppla resursen till.
Skapa en resursgrupp genom att välja Skapa ny. Ge den namnet myResourceGroup och välj sedan OK.
En resursgrupp är en logisk container där Azure-resurser, till exempel webbappar, databaser och lagringskonton, distribueras och hanteras. Du kan exempelvis välja att ta bort hela resursgruppen i ett enkelt steg längre fram.
Välj en plats (region) där du vill placera resursen.
Välj Skapa för att börja skapa resursen.
När resursen har skapats visar Azure-portalen att distributionen är klar.
Välj Gå till resurs. Nu kan du visa resursegenskaperna.
Kopiera resursens konto-ID-värde till en textredigerare för senare användning.
Kopiera även resursens kontodomänvärde till en textredigerare för senare användning.
Under Inställningar väljer du Åtkomstnyckel. Kopiera värdet Primärnyckel , Kontonyckel, till en textredigerare för senare användning.
Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Andra inloggningsalternativ finns i Logga in med Azure CLI.
När du uppmanas att installera Azure CLI-tillägget vid första användningen. Mer information om tillägg finns i Använda tillägg med Azure CLI.
Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.
När du har loggat in använder du kommandot az account set för att välja den prenumeration där kontot spatial anchors ska konfigureras:
az account set --subscription 00000000-0000-0000-0000-000000000000
az group create --name myResourceGroup --location eastus2
En resursgrupp är en logisk container där Azure-resurser, till exempel webbappar, databaser och lagringskonton, distribueras och hanteras. Du kan exempelvis välja att ta bort hela resursgruppen i ett enkelt steg längre fram.
az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key primary
az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key secondary
Även om PowerShell-modulen Az.MixedReality är i förhandsversion måste du installera den separat med hjälp av cmdleten Install-Module . När modulen blir allmänt tillgänglig kommer den att ingå i framtida versioner av Az PowerShell-modulen och vara tillgänglig som standard i Azure Cloud Shell.
Install-Module -Name Az.MixedReality
När du har loggat in använder du cmdleten Set-AzContext för att välja den prenumeration där kontot spatial anchors ska konfigureras:
En resursgrupp är en logisk container där Azure-resurser, till exempel webbappar, databaser och lagringskonton, distribueras och hanteras. Du kan exempelvis välja att ta bort hela resursgruppen i ett enkelt steg längre fram.
Du kan visa dina aktuella spatiala fästpunkter för en resursgrupp med hjälp av cmdleten Get-AzSpatialAnchorsAccount :
git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples
Öppna Xamarin/SampleXamarin.sln i Visual Studio.
Konfigurera konto-ID och -nyckel
Nästa steg är att konfigurera appen så att den använder din kontoidentifierare och kontonyckel. Du kopierade dem till en textredigerare när du konfigurerade Spatial Anchors-resursen.
Leta upp fältet SpatialAnchorsAccountKey och ersätt Set me med kontonyckeln.
Leta upp fältet SpatialAnchorsAccountId och ersätt Set me med konto-ID.
Leta upp fältet SpatialAnchorsAccountDomain och ersätt Set me med kontodomänen.
Distribuera appen till din Android-enhet
Starta Android-enheten, logga in och anslut den till datorn med hjälp av en USB-kabel.
Ställ in startprojektet på SampleXamarin.Android, ändra lösningskonfigurationen till Släpp och välj den enhet som du vill distribuera till i listrutan enhetsväljare.
Välj Felsöka>Starta felsökning för att distribuera och starta appen.
Välj Kör>start utan felsökning för att distribuera och starta din app.
I appen väljer du Grundläggande för att köra demonstrationen och följer anvisningarna för att placera och återkalla en fästpunkt.
Rensa resurser
I de föregående stegen skapade du Azure-resurser i en resursgrupp. Om du inte tror att du behöver dessa resurser i framtiden, kan du ta bort dem genom att ta bort resursgruppen.
På menyn eller startsidan i Azure-portalen väljer du Resursgrupper. Välj sedan myResourceGroup på sidan Resursgrupper.
På sidan myResourceGroup kontrollerar du att resurserna i listan är de som du vill ta bort.
Välj Ta bort resursgrupp, skriv myResourceGroup i textrutan för att bekräfta och välj sedan Ta bort.
Nästa steg
I den här snabbstarten skapade du ett Spatial Anchors-konto. Sedan konfigurerade och distribuerade du en app för att spara och återkalla spatiala fästpunkter. Om du vill veta mer om hur du förbättrar appen så att den kan dela rumsliga fästpunkter med andra enheter fortsätter du till nästa självstudie.
