Den här snabbstarten beskriver hur du skapar en iOS-app med Xamarin med hjälp av Azure Spatial Anchors. 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 iOS-app som kan spara och återkalla en spatial fästpunkt.
Du lär dig följande:
Skapa ett Spatial Anchors-konto
Konfigurera konto-ID och kontonyckel för Spatial Anchors
Använd sökrutan för att söka efter Spatial Anchors.
Välj Spatial Anchors och välj sedan Skapa.
I fönstret Spatial Anchors konto gör du följande:
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 resurs grupp är en logisk behållare där Azure-resurser, till exempel webbappar, databaser och lagrings konton, 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 Portal 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 också resursens kontodomänvärde till en textredigerare för senare användning.
Under Inställningar väljer du Åtkomstnyckel. Kopiera värdet för Primärnyckel,Kontonyckel, till en textredigerare för senare användning.
Om du vill kan du i stället installera Azure CLI för att köra CLI-referenskommandon.
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. Fler inloggningsalternativ finns i Logga in med Azure CLI.
När du uppmanas till det installerar du Azure CLI-tillägg vid första användning. 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 spatial anchors-kontot ska konfigureras:
az account set --subscription 00000000-0000-0000-0000-000000000000
Kör kommandot az group create för att skapa en resursgrupp eller använd en befintlig resursgrupp:
az group create --name myResourceGroup --location eastus2
En resurs grupp är en logisk behållare där Azure-resurser, till exempel webbappar, databaser och lagrings konton, 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ästpunktskonton för en resursgrupp med kommandot az spatial-anchors-account list:
az spatial-anchors-account list --resource-group myResourceGroup
Du kan också visa spatiala fästpunktskonton för din prenumeration:
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
När PowerShell-modulen Az.MixedReality är i förhandsversion måste du installera den separat med hjälp av Install-Module cmdleten . 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 resurs grupp är en logisk behållare där Azure-resurser, till exempel webbappar, databaser och lagrings konton, 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ästpunktskonton 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 ditt konto-ID och din kontonyckel. Du kopierade dem till en textredigerare när du konfigurerade Spatial Anchors resurs.
Leta upp fältet SpatialAnchorsAccountKey och ersätt Set me med kontonyckeln.
Leta upp fältet SpatialAnchorsAccountId och ersätt Set me med kontoidentifieraren.
Leta upp SpatialAnchorsAccountDomain fältet och ersätt med Set me kontodomänen.
Distribuera appen till din iOS-enhet
Sätt på iOS-enheten, logga in och anslut den till datorn med en USB-kabel.
Ställ in startprojektet på SampleXamarin.iOS, ändra Lösningskonfiguration till Version och välj den enhet som du vill distribuera till i listrutan för enhetsväljaren.
Välj Kör > start utan felsökning för att distribuera och starta din app.
I appen väljer du Basic 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.
Från Azure Portal-menyn eller Start sidan väljer du resurs grupper. På sidan resurs grupper väljer du sedan myResourceGroup.
På sidan myResourceGroup kontrollerar du att de listade resurserna är de som du vill ta bort.
Välj ta bort resurs grupp, Skriv myResourceGroup i text rutan för att bekräfta och välj sedan ta bort.
Nästa steg
I den här snabb starten skapade du ett konto för spatial ankare. Du har sedan konfigurerat och distribuerat en app för att spara och återkalla spatiala ankare. Fortsätt till nästa självstudie om du vill veta mer om hur du kan förbättra appen så att den kan dela spatiala ankare med andra enheter.
