Questa guida introduttiva illustra come eseguire l'app di esempio Ancoraggi nello spazio di Azure per dispositivi Android usando Xamarin (C#). Ancoraggi nello spazio di Azure è un servizio per lo sviluppo multipiattaforma che consente di creare esperienze di realtà mista usando oggetti la cui posizione persiste tra dispositivi nel corso del tempo. Al termine, si avrà un'app Android in grado di salvare e richiamare un ancoraggio nello spazio.
Si apprenderà come:
Creare un account di Ancoraggi nello spazio
Configurare l'identificatore e la chiave dell'account di Ancoraggi nello spazio
Distribuire ed eseguire l'app in un dispositivo Android
La versione più recente di Xamarin.Android installata e in esecuzione nella piattaforma preferita. Per una guida all'installazione di Xamarin.Android, vedere le guide di installazione di Xamarin.Android.
Potrebbero essere necessari driver di dispositivo aggiuntivi per la comunicazione del computer con il dispositivo Android. Per altre informazioni, vedere qui.
Nel riquadro sinistro selezionare Crea una risorsa.
Digitare Ancoraggi nello spazio nella casella di ricerca.
Selezionare Ancoraggi nello spazio, quindi selezionare Crea.
Nel riquadro Account ancoraggi nello spazio procedere come segue:
Immettere un nome di risorsa univoco usando i normali caratteri alfanumerici.
Selezionare la sottoscrizione a cui collegare la risorsa.
Creare un gruppo di risorse selezionando Crea nuovo. Assegnare al gruppo il nome myResourceGroup e quindi selezionare OK.
Un gruppo di risorse è un contenitore logico in cui vengono distribuite e gestite risorse di Azure come app Web, database e account di archiviazione. Ad esempio, si può scegliere in un secondo momento di eliminare l'intero gruppo di risorse in un unico semplice passaggio.
Selezionare un'area in cui inserire la risorsa.
Selezionare Crea per iniziare a creare la risorsa.
Dopo aver creato la risorsa, il portale di Azure indica che la distribuzione è stata completata.
Selezionare Vai alla risorsa. È ora possibile visualizzare le proprietà della risorsa.
Copiare il valore di ID account della risorsa in un editor di testo per un uso successivo.
Copiare anche il valore di Dominio account della risorsa in un editor di testo per un uso successivo.
In Impostazioni selezionare Chiave di accesso. Copiare i valori di Chiave primaria e Chiave dell'account in un editor di testo per un uso successivo.
Per iniziare, preparare l'ambiente per l'interfaccia della riga di comando di Azure:
Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.
Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Accedere con l'interfaccia della riga di comando di Azure.
Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.
Dopo aver eseguito l'accesso, usare il comando az account set per selezionare la sottoscrizione in cui configurare l'account di ancoraggi nello spazio:
az account set --subscription 00000000-0000-0000-0000-000000000000
Eseguire il comando az group create per creare un gruppo di risorse o usarne uno esistente:
az group create --name myResourceGroup --location eastus2
Un gruppo di risorse è un contenitore logico in cui vengono distribuite e gestite risorse di Azure come app Web, database e account di archiviazione. Ad esempio, si può scegliere in un secondo momento di eliminare l'intero gruppo di risorse in un unico semplice passaggio.
Per visualizzare gli attuali account di ancoraggi nello spazio per un gruppo di risorse, usare il comando az spatial-anchors-account list:
az spatial-anchors-account list --resource-group myResourceGroup
È anche possibile visualizzare gli account di ancoraggi nello spazio per la sottoscrizione:
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
Durante la fase di anteprima, è necessario installare il modulo Az.MixedReality di PowerShell separatamente usando il cmdlet Install-Module. Quando il modulo di PowerShell diventerà disponibile a livello generale, entrerà a far parte delle future versioni del modulo Az di PowerShell e sarà disponibile per impostazione predefinita all'interno di Azure Cloud Shell.
Install-Module -Name Az.MixedReality
Dopo aver eseguito l'accesso, usare il cmdlet Set-AzContext per selezionare la sottoscrizione in cui configurare l'account di ancoraggi nello spazio:
Un gruppo di risorse è un contenitore logico in cui vengono distribuite e gestite risorse di Azure come app Web, database e account di archiviazione. Ad esempio, si può scegliere in un secondo momento di eliminare l'intero gruppo di risorse in un unico semplice passaggio.
Per visualizzare gli attuali account di ancoraggi nello spazio per un gruppo di risorse, usare il cmdlet Get-AzSpatialAnchorsAccount:
git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples
Aprire Xamarin/SampleXamarin.sln in Visual Studio.
Configurare l'identificatore e la chiave dell'account
Il passaggio successivo consiste nel configurare l'app in modo da usare l'identificatore e la chiave dell'account. Questi dati sono stati copiati in un editor di testo durante la configurazione della risorsa Ancoraggi nello spazio.
Individuare il campo SpatialAnchorsAccountKey e sostituire Set me con la chiave dell'account.
Individuare il campo SpatialAnchorsAccountId e sostituire Set me con l'identificatore dell'account.
Individuare il campo SpatialAnchorsAccountDomain e sostituire Set me con il dominio dell'account.
Distribuire l'app nel dispositivo Android
Accendere il dispositivo Android, eseguire l'accesso e connetterlo al computer con un cavo USB.
Impostare il progetto di avvio su SampleXamarin.Android, modificare il valore di Configurazione soluzione in Rilascio e selezionare il dispositivo di destinazione della distribuzione nell'elenco a discesa di selezione del dispositivo.
Selezionare Debug>Avvia debug per distribuire e avviare l'app.
Selezionare Esegui>Avvia senza eseguire debug per distribuire e avviare l'app.
Nell'app selezionare Di base per eseguire la demo e seguire le istruzioni per inserire e richiamare un ancoraggio.
Pulire le risorse
Nei passaggi precedenti sono state create risorse di Azure in un gruppo di risorse. Se non si prevede di aver bisogno di queste risorse in futuro, è possibile eliminarle eliminando il gruppo di risorse.
Nel menu del portale di Azure o nella pagina Home selezionare Gruppi di risorse. Quindi, nella pagina Gruppi di risorse selezionare myResourceGroup.
Nella pagina myResourceGroup assicurarsi che le risorse elencate siano quelle da eliminare.
Selezionare Elimina gruppo di risorse, digitare myResourceGroup nella casella di testo per confermare e quindi selezionare Elimina.
Passaggi successivi
In questa guida di avvio rapido è stato creato un account di Ancoraggi nello spazio. È stata quindi configurata e distribuita un'app per salvare e richiamare gli ancoraggi nello spazio. Per altre informazioni su come migliorare l'app in modo da consentire la condivisione di ancoraggi nello spazio con altri dispositivi, continuare con l'esercitazione successiva.
