Kurz: Sdílení prostorových ukotvení napříč relacemi a zařízeními

Azure Spatial Anchors je multiplatformní vývojářská služba, se kterou můžete vytvářet prostředí hybridní reality pomocí objektů, které v průběhu času uchovávají jejich umístění na různých zařízeních.

V tomto kurzu pomocí Azure Spatial Anchors vytvoříte kotvy během jedné relace a pak je vyhledáte na stejném zařízení nebo jiném. Stejné kotvy mohou být umístěny také několika zařízeními na stejném místě a ve stejnou dobu.

V tomto kurzu se naučíte:

• Nasaďte webovou aplikaci ASP.NET Core v Azure, kterou můžete použít ke sdílení ukotvení a uložení ukotvení do paměti po určitou dobu.
• Nakonfigurujte scénu AzureSpatialAnchorsLocalSharedDemo v rámci ukázky Unity z našich rychlých startů, abyste využili výhod webové aplikace Sharing Anchors.
• Nasaďte a spusťte ukotvení na jedno nebo více zařízeních.

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure před tím, než začnete.

Požadavky

Než začnete s tímto kurzem, ujistěte se, že splňujete následující požadavky:

• Přečtěte si přehled Azure Spatial Anchors.
• Dokončete jeden z 5minutových rychlých startů.

  Poznámka:

  Rychlé starty pro Android/NDK a iOS/Swift v současné době nezobrazují funkce popsané v tomto kurzu.

• Základní znalost:
  • ArCore , pokud používáte Android.
  • ARKit , pokud používáte iOS.
• Počítač s Windows se sadou Visual Studio 2019 nebo novějšími a úlohami vývoje pro ASP.NET a web.
• Sada .NET Core 3.1 SDK.
• Jedno nebo několik následujících zařízení, na kterých se má nasadit a spustit aplikace: HoloLens, HoloLens 2, iOS nebo Android.

Poznámka:

V tomto kurzu budete používat Unity a webovou aplikaci ASP.NET Core, ale tady je jen příklad sdílení identifikátorů Azure Spatial Anchors napříč jinými zařízeními. K dosažení stejného cíle můžete použít jiné jazyky a back-endové technologie.

Vytvoření prostředku Spatial Anchors

Azure Portal

Přejděte na Azure Portal.

V levém podokně vyberte Vytvořit prostředek.

Pomocí vyhledávacího pole vyhledejte Spatial Anchors.

Vyberte Spatial Anchors a pak vyberte Vytvořit.

V podokně Účet prostorových ukotvení postupujte takto:

• Zadejte jedinečný název prostředku pomocí běžných alfanumerických znaků.

• Vyberte předplatné, ke kterému chcete prostředek připojit.

• Výběrem možnosti Vytvořit novou vytvořte skupinu prostředků. Pojmenujte ji myResourceGroup a pak vyberte OK.

  Skupina prostředků je logický kontejner, do kterého se nasazují a spravují prostředky Azure, jako jsou webové aplikace, databáze a účty úložiště. Později se například můžete rozhodnout odstranit celou skupinu prostředků v jednom jednoduchém kroku.

• Vyberte umístění (oblast), do kterého chcete prostředek umístit.

• Výběrem možnosti Vytvořit zahájíte vytváření prostředku.

Po vytvoření prostředku se na webu Azure Portal zobrazí, že je vaše nasazení dokončené.

Vyberte Přejít k prostředku. Teď můžete zobrazit vlastnosti prostředku.

Zkopírujte hodnotu ID účtu prostředku do textového editoru pro pozdější použití.

Zkopírujte také hodnotu domény účtu prostředku do textového editoru pro pozdější použití.

V části Nastavení vyberte Přístupový klíč. Zkopírujte hodnotu primárního klíče Account Key (Klíč účtu) do textového editoru pro pozdější použití.

Azure CLI

Začněte přípravou prostředí pro rozhraní příkazového řádku Azure:

• Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Rychlý start pro Bash v Azure Cloud Shellu.

  

• Pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Další informace najdete v tématu Jak spustit Azure CLI v kontejneru Dockeru.

  • Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení najdete v tématu Přihlášení pomocí Azure CLI.

  • Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Využití rozšíření v Azure CLI.

  • Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

1. Po přihlášení pomocí příkazu az account set vyberte předplatné, ve kterém chcete nastavit účet prostorových ukotvení:

   az account set --subscription 00000000-0000-0000-0000-000000000000
   

2. Spuštěním příkazu az group create vytvořte skupinu prostředků nebo použijte existující skupinu prostředků:

   az group create --name myResourceGroup --location eastus2
   

   Skupina prostředků je logický kontejner, do kterého se nasazují a spravují prostředky Azure, jako jsou webové aplikace, databáze a účty úložiště. Později se například můžete rozhodnout odstranit celou skupinu prostředků v jednom jednoduchém kroku.

   Aktuální účty prostorových ukotvení pro skupinu prostředků můžete zobrazit pomocí příkazu az spatial-anchors-account list :

   az spatial-anchors-account list --resource-group myResourceGroup
   

   Můžete také zobrazit účty prostorových ukotvení pro vaše předplatné:

   az spatial-anchors-account list
   

3. Spuštěním příkazu az spatial-anchors-account create vytvořte účet spatial anchors:

   az spatial-anchors-account create --resource-group myResourceGroup --name MySpatialAnchorsQuickStart --location eastus2
   

4. Pomocí příkazu az spatial-anchors-account show zobrazte vlastnosti prostředku:

   az spatial-anchors-account show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
   

   Zkopírujte hodnotu ID účtu prostředku a hodnotu domény účtu prostředku do textového editoru pro pozdější použití.

5. Spuštěním příkazu az spatial-anchors-account key show získejte primární a sekundární klíče:

   az spatial-anchors-account key show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
   

   Zkopírujte hodnoty klíče do textového editoru pro pozdější použití.

   Pokud potřebujete znovu vygenerovat klíče, použijte příkaz az spatial-anchors-account key renew :

   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
   

Účet můžete odstranit pomocí příkazu az spatial-anchors-account delete :

az spatial-anchors-account delete --resource-group myResourceGroup --name MySpatialAnchorsQuickStart

Azure PowerShell

Začněte přípravou vašeho prostředí pro Azure PowerShell:

• Pokud se rozhodnete používat Azure PowerShell místně:
  • Nainstalujte nejnovější verzi modulu Az PowerShell.
  • Připojte se ke svému účtu Azure pomocí rutiny Connect-AzAccount .
• Pokud se rozhodnete použít Azure Cloud Shell:
  • Další informace najdete v přehledu služby Azure Cloud Shell .

Důležité

Modul Az.MixedReality PowerShell je ve verzi Preview, musíte ho nainstalovat samostatně pomocí rutinyInstall-Module. Jakmile bude tento powershellový modul obecně dostupný, stane se součástí budoucích verzí modulu Az PowerShellu a bude ve výchozím nastavení dostupný v rámci Azure Cloud Shellu.

Install-Module -Name Az.MixedReality

1. Po přihlášení pomocí rutiny Set-AzContext vyberte předplatné, ve kterém chcete nastavit účet prostorových ukotvení:

   Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
   

2. Spuštěním rutiny New-AzResourceGroup vytvořte skupinu prostředků nebo použijte existující skupinu prostředků:

   New-AzResourceGroup -Name myResourceGroup -Location eastus2
   

   Skupina prostředků je logický kontejner, do kterého se nasazují a spravují prostředky Azure, jako jsou webové aplikace, databáze a účty úložiště. Později se například můžete rozhodnout odstranit celou skupinu prostředků v jednom jednoduchém kroku.

   Aktuální účty prostorových ukotvení pro skupinu prostředků můžete zobrazit pomocí rutiny Get-AzSpatialAnchorsAccount :

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
   

   Můžete také zobrazit účty prostorových ukotvení pro vaše předplatné:

   Get-AzSpatialAnchorsAccount
   

3. Spuštěním rutiny New-AzSpatialAnchorsAccount vytvořte účet prostorových ukotvení:

   New-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart -Location eastus2
   

4. Pomocí rutiny Get-AzSpatialAnchorsAccount zobrazte vlastnosti prostředku:

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Zkopírujte hodnotu accountId vlastnosti a hodnotu accountDomain vlastnosti do textového editoru pro pozdější použití.

5. Spuštěním rutiny Get-AzSpatialAnchorsAccountKey získejte primární a sekundární klíče:

   Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Zkopírujte hodnoty klíče do textového editoru pro pozdější použití.

   Pokud potřebujete znovu vygenerovat klíče, použijte rutinu New-AzSpatialAnchorsAccountKey :

   New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Primary
   New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Secondary
   

Účet můžete odstranit pomocí rutiny Remove-AzSpatialAnchorsAccount :

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Stažení ukázkového projektu a import sady SDK

Úložiště klonování ukázek

Naklonujte úložiště ukázek spuštěním následujících příkazů:

git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples

Import ASA SDK

Podle zde uvedených pokynů stáhněte a naimportujte balíčky ASA SDK vyžadované pro platformu HoloLens.

Nasazení služby Sdílení ukotvení

Poznámka:

V tomto kurzu budeme používat úroveň Free služby Aplikace Azure Service. Úroveň Free vyprší po 20 minutách nečinnosti a resetuje mezipaměť paměti.

Visual Studio

Otevřete Visual Studio a otevřete projekt ve složce Sharing\SharingServiceSample .

Otevření průvodce publikováním

V Průzkumník řešení klikněte pravým tlačítkem myši na projekt SharingService a pak vyberte Publikovat....

Spustí se Průvodce publikováním.

1. Vyberte Další cíl Azure>.
2. Výběr konkrétní cílové služby Aplikace Azure (Windows)>Next
3. Přihlaste se k portálu Azure.
4. Vyberte zelenou "+" a vytvořte službu Aplikace Azure.

Nastavení služby App Service

Nastavení	Navrhovaná hodnota	Description
Name	myASASharingService	Zadejte jedinečný název vaší služby.
Název předplatného		Vyberte upřednostňované předplatné Azure.
Skupina prostředků	myResourceGroup nebo vyberte existující	Skupina prostředků je logický kontejner, do kterého se nasazují a spravují prostředky Azure, jako jsou webové aplikace, databáze a účty úložiště. Později se například můžete rozhodnout odstranit celou skupinu prostředků v jednom jednoduchém kroku.
Hosting Plan (Plán hostování)	Vyberte Nový... a podívejte se na tabulku níže.	Plán služby App Service určuje umístění, velikost a funkce farmy webových serverů, která je hostitelem vaší aplikace. Když hostujete více aplikací, můžete ušetřit tím, že nakonfigurujete webové aplikace tak, aby sdílely jeden plán služby App Service. Plány služby App Service definují: Oblast (například Severní Evropa, USA – východ nebo Jihovýchodní Asie) Velikost instance (Malá, Střední, Velká) Počet škálování (1 až 20 instancí) SKU (Free, Shared, Basic, Standard, Premium)

Nastavení plánu hostování

Nastavení	Navrhovaná hodnota	Popis
Hosting Plan (Plán hostování)	MySharingServicePlan	Zadejte jedinečný název plánu hostování.
Umístění	USA – západ	Datacentrum, které je hostitelem webové aplikace. Zvolte umístění nejblíže fyzickému umístění, které bude vaše aplikace používat.
Velikost	Bezplatný	Cenová úroveň , která určuje funkce hostování

5. Výběrem možnosti Vytvořit vytvořte službu App Service.
6. Jakmile se služba App Service vytvoří, vyberte ji v seznamu Instance služby App Service a vyberte Dokončit.
7. On the SharingService: Publish tab select Publish

Po publikování webové aplikace ASP.NET Core do Azure můžete přejít nebo https://<your_app_name>.azurewebsites.net kliknout na odkaz vedle webu: na kartě SharingService: Publikovat . Zkopírujte tuto adresu URL do textového editoru pro pozdější použití.

Visual Studio Code

Před nasazením služby v editoru Visual Studio Code musíte vytvořit skupinu prostředků a plán služby App Service.

Přihlášení k Azure

Přejděte na web Azure Portal a přihlaste se ke svému předplatnému Azure.

Vytvoření skupiny zdrojů

Skupina prostředků je logický kontejner, do kterého se nasazují a spravují prostředky Azure, jako jsou webové aplikace, databáze a účty úložiště. Později se například můžete rozhodnout odstranit celou skupinu prostředků v jednom jednoduchém kroku.

Vedle pole Skupina prostředků vyberte Nová.

Pojmenujte skupinu prostředků myResourceGroup a pak vyberte OK.

Vytvoření plánu služby App Service

Plán služby App Service určuje umístění, velikost a funkce farmy webových serverů, která je hostitelem vaší aplikace. Když hostujete více aplikací, můžete ušetřit tím, že nakonfigurujete webové aplikace tak, aby sdílely jeden plán služby App Service.

Plány služby App Service definují:

• Oblast (například Severní Evropa, USA – východ nebo Jihovýchodní Asie)
• Velikost instance (Malá, Střední, Velká)
• Počet škálování (1 až 20 instancí)
• SKU (Free, Shared, Basic, Standard, Premium)

Vedle položky Plán hostování vyberte Nový.

V podokně Konfigurovat plán hostování použijte tato nastavení:

Nastavení	Navrhovaná hodnota	Popis
Plán služby App Service	MySharingServicePlan	Název plánu služby App Service
Umístění	USA – západ	Datacentrum, kde je webová aplikace hostovaná
Velikost	Bezplatný	Cenová úroveň , která určuje funkce hostování

Vyberte OK.

Otevřete Visual Studio Code a otevřete projekt ve složce Sharing\SharingServiceSample .

Pokud chcete nasadit službu sdílení prostřednictvím editoru Visual Studio Code, postupujte podle pokynů v tématu Publikování aplikace ASP.NET Core do Azure pomocí editoru Visual Studio Code. Začněte v části Otevřít v editoru Visual Studio Code. Nevytvořte další ASP.NET projekt, jak je vysvětleno v předchozím kroku, protože již máte projekt, který chcete nasadit a publikovat: SharingServiceSample.

Konfigurace a nasazení ukázkové aplikace

Unity – HoloLens

Otevřít projekt

V Unity otevřete projekt ve složce Unity . Unity vás může vyzvat k rozdílu mezi verzí v projektu a verzí nainstalovanou na vašem počítači. Toto upozornění je v pořádku, pokud je vaše verze Unity Editoru novější než verze, se kterou byl projekt vytvořen. Pokud je vaše verze novější, vyberte Pokračovat. Pokud je vaše verze starší než ta, která projekt potřebuje, vyberte Ukončit a upgradovat Unity Editor.

Nastavení sestavení

Výběrem možnosti Nastavení sestavení souboru>otevřete nastavení sestavení.

V části Platforma vyberte Univerzální platforma Windows. Změňte cílové zařízení na HoloLens.

Vyberte Přepnout platformu a změňte platformu na Univerzální platforma Windows. Unity vás může vyzvat k instalaci komponent podpory UPW, pokud chybí.

Zavřete okno Nastavení sestavení.

Konfigurace informací o účtu

Dalším krokem je konfigurace aplikace tak, aby používala informace o vašem účtu. V části Vytvoření prostředku Spatial Anchors jste zkopírovali hodnoty klíče účtu, ID účtu a domény účtu do textového editoru.

V podokně Projekt přejděte na Assets\AzureSpatialAnchors.SDK\Resources.

Vyberte SpatialAnchorConfig. V podokně inspektoruAccount Key zadejte jako hodnotu pro klíč účtu Spatial Anchors, Account ID jako hodnotu PRO ID účtu Spatial Anchors a Account Domain jako hodnotu pro doménu účtu Spatial Anchors.

Otevřete scénu s názvem AzureSpatialAnchorsLocalSharedDemo nalezenou Assets/AzureSpatialAnchors.Examples/Scenes/AzureSpatialAnchorsLocalSharedDemo poklikáním na ni v podokně projektu.

V podokně Projekt přejděte na Assets\AzureSpatialAnchors.Examples\Resources.

Vyberte SpatialAnchorSamplesConfig. V podokně inspektoru Sharing Anchors Service pak jako hodnotu Base Sharing Urlzadejte adresu URL (z vašeho nasazení ASP.NET webové aplikace Azure). Připojte adresu URL pomocí /swagger/api/anchors. Měl by vypadat takto: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

Scénu uložte výběrem možnosti Uložit soubor>.

Export a nasazení aplikace HoloLens

Výběrem možnosti Nastavení sestavení souboru>otevřete nastavení sestavení.

V části Scény v sestavení se ujistěte, že všechny scény mají vedle nich značku zaškrtnutí.

Vyberte Sestavit. V dialogovém okně vyberte složku, ve které chcete exportovat projekt HoloLens Visual Studio.

Po dokončení exportu se zobrazí složka obsahující exportovaný projekt HoloLens.

Ve složce poklikejte na HelloAR U3D.sln otevřete projekt v sadě Visual Studio.

Změňte konfiguraci řešení na Vydání, změňte platformuřešení na x86 a v možnostech cíle nasazení vyberte zařízení.

Pokud používáte HoloLens 2, místo x86 použijte ARM64 jako platformu řešení.

Zapněte zařízení HoloLens, přihlaste se a připojte zařízení k počítači pomocí kabelu USB.

>Vyberte Spustit ladění a nasaďte aplikaci a spusťte ladění.

Spuštění aplikace

V aplikaci vyberte localSharedDemo pomocí šipek a pak stisknutím tlačítka Přejít! spusťte ukázku. Postupujte podle pokynů k umístění a odvolání ukotvení.

Pomocí funkce Vytvořit a sdílet ukotvení můžete vytvořit kotvu a uložit ji do služby pro sdílení. Vrátí se vám zpět identifikátor, pomocí kterého ho můžete načíst ze služby sdílení. Pak můžete spustit druhý scénář, vyhledat sdílené ukotvení z vašeho zařízení nebo jiného.

Pomocí funkce Najít sdílené ukotvení můžete dříve sdílené kotvy vyhledat zadáním dříve uvedeného identifikátoru. Po výběru scénáře vás aplikace provede dalšími pokyny. Budete například požádáni o přesunutí zařízení, abyste shromáždili informace o prostředí. Později umístíte ukotvení do světa, počkáte na uložení, spustíte novou relaci a pak ji vyhledáte.

Unity – Android

Otevřít projekt

V Unity otevřete projekt ve složce Unity . Unity vás může vyzvat k rozdílu mezi verzí v projektu a verzí nainstalovanou na vašem počítači. Toto upozornění je v pořádku, pokud je vaše verze Unity Editoru novější než verze, se kterou byl projekt vytvořen. Pokud je vaše verze novější, vyberte Pokračovat. Pokud je vaše verze starší než ta, která projekt potřebuje, vyberte Ukončit a upgradovat Unity Editor.

Nastavení sestavení

Výběrem možnosti Nastavení sestavení souboru>otevřete nastavení sestavení.

V části Platforma vyberte Android a pak vyberte Přepnout platformu a změňte platformu na Android. Unity vás může vyzvat k instalaci komponent podpory Pro Android, pokud chybí.

Zavřete okno Nastavení sestavení.

Konfigurace informací o účtu

Dalším krokem je konfigurace aplikace tak, aby používala informace o vašem účtu. V části Vytvoření prostředku Spatial Anchors jste zkopírovali hodnoty klíče účtu, ID účtu a domény účtu do textového editoru.

V podokně Projekt přejděte na Assets\AzureSpatialAnchors.SDK\Resources.

Vyberte SpatialAnchorConfig. V podokně inspektoruAccount Key zadejte jako hodnotu pro klíč účtu Spatial Anchors, Account ID jako hodnotu PRO ID účtu Spatial Anchors a Account Domain jako hodnotu pro doménu účtu Spatial Anchors.

Otevřete scénu s názvem AzureSpatialAnchorsLocalSharedDemo nalezenou Assets/AzureSpatialAnchors.Examples/Scenes/AzureSpatialAnchorsLocalSharedDemo poklikáním na ni v podokně projektu.

V podokně Projekt přejděte na Assets\AzureSpatialAnchors.Examples\Resources.

Vyberte SpatialAnchorSamplesConfig. V podokně inspektoru Sharing Anchors Service pak jako hodnotu Base Sharing Urlzadejte adresu URL (z vašeho nasazení ASP.NET webové aplikace Azure). Připojte adresu URL pomocí /swagger/api/anchors. Měl by vypadat takto: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

Scénu uložte výběrem možnosti Uložit soubor>.

Nasadit

Přihlaste se k zařízení s Androidem a připojte ho k počítači pomocí kabelu USB.

Výběrem možnosti Nastavení sestavení souboru>otevřete nastavení sestavení.

V části Scény v sestavení se ujistěte, že každá scéna má vedle ní značku zaškrtnutí.

Ujistěte se, že projekt exportu nemá značku zaškrtnutí. Vyberte Sestavit a spustit. Zobrazí se výzva k uložení souboru .apk . Můžete vybrat libovolný název.

Spuštění aplikace

V aplikaci vyberte ukázku LocalShare pomocí šipek a pak stisknutím tlačítka Přejít! spusťte ukázku. Postupujte podle pokynů k umístění a odvolání ukotvení.

Pomocí funkce Vytvořit a sdílet ukotvení můžete vytvořit kotvu a uložit ji do služby pro sdílení. Vrátí se vám zpět identifikátor, pomocí kterého ho můžete načíst ze služby sdílení. Pak můžete spustit druhý scénář, vyhledat sdílené ukotvení z vašeho zařízení nebo jiného.

Pomocí funkce Najít sdílené ukotvení můžete dříve sdílené kotvy vyhledat zadáním dříve uvedeného identifikátoru. Po výběru scénáře vás aplikace provede dalšími pokyny. Budete například požádáni o přesunutí zařízení, abyste shromáždili informace o prostředí. Později umístíte ukotvení do světa, počkáte na uložení, spustíte novou relaci a pak ji vyhledáte.

Unity – iOS

Otevřít projekt

V Unity otevřete projekt ve složce Unity . Unity vás může vyzvat k rozdílu mezi verzí v projektu a verzí nainstalovanou na vašem počítači. Toto upozornění je v pořádku, pokud je vaše verze Unity Editoru novější než verze, se kterou byl projekt vytvořen. Pokud je vaše verze novější, vyberte Pokračovat. Pokud je vaše verze starší než ta, která projekt potřebuje, vyberte Ukončit a upgradovat Unity Editor.

Nastavení sestavení

Výběrem možnosti Nastavení sestavení souboru>otevřete nastavení sestavení.

V části Platforma vyberte iOS.

Vyberte Přepnout platformu a změňte platformu na iOS. Unity vás může vyzvat k instalaci komponent podpory pro iOS, pokud chybí.

Zavřete okno Nastavení sestavení.

Konfigurace informací o účtu

Dalším krokem je konfigurace aplikace tak, aby používala informace o vašem účtu. V části Vytvoření prostředku Spatial Anchors jste zkopírovali hodnoty klíče účtu, ID účtu a domény účtu do textového editoru.

V podokně Projekt přejděte na Assets\AzureSpatialAnchors.SDK\Resources.

Vyberte SpatialAnchorConfig. V podokně inspektoruAccount Key zadejte jako hodnotu pro klíč účtu Spatial Anchors, Account ID jako hodnotu PRO ID účtu Spatial Anchors a Account Domain jako hodnotu pro doménu účtu Spatial Anchors.

Otevřete scénu s názvem AzureSpatialAnchorsLocalSharedDemo nalezenou Assets/AzureSpatialAnchors.Examples/Scenes/AzureSpatialAnchorsLocalSharedDemo poklikáním na ni v podokně projektu.

V podokně Projekt přejděte na Assets\AzureSpatialAnchors.Examples\Resources.

Vyberte SpatialAnchorSamplesConfig. V podokně inspektoru Sharing Anchors Service pak jako hodnotu Base Sharing Urlzadejte adresu URL (z vašeho nasazení ASP.NET webové aplikace Azure). Připojte adresu URL pomocí /swagger/api/anchors. Měl by vypadat takto: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

Scénu uložte výběrem možnosti Uložit soubor>.

Nasazení na zařízení s iOSem

Výběrem možnosti Nastavení sestavení souboru>otevřete nastavení sestavení.

V části Scény v sestavení se ujistěte, že každá scéna má vedle ní značku zaškrtnutí.

Vyberte Sestavit. V podokně, které se otevře, vyberte složku, do které chcete exportovat projekt Xcode.

Po dokončení exportu se zobrazí složka, která obsahuje exportovaný projekt Xcode.

Poznámka:

Pokud se zobrazí okno se zprávou s dotazem, jestli chcete nahradit nebo připojit, doporučujeme vybrat možnost Připojit, protože je rychlejší. Nahrazení odebere všechny soubory z cílové složky a vygeneruje nový obsah.

Otevření projektu Xcode

Teď můžete projekt otevřít Unity-iPhone.xcodeproj v Xcode.

Můžete spustit Xcode a otevřít exportovaný Unity-iPhone.xcodeproj projekt nebo spustit projekt v Xcode spuštěním následujícího příkazu z umístění, kam jste projekt exportovali:

open ./Unity-iPhone.xcodeproj

Výběrem kořenového uzlu Unity-iPhone zobrazte nastavení projektu a pak vyberte kartu Obecné .

V části Informace o nasazení se ujistěte, že je cíl nasazení nastavený na iOS 11.0.

Vyberte kartu Podepisování a možnosti a ujistěte se, že je povolené automatické řízení podepisování. Pokud není, povolte ho a potom obnovte nastavení sestavení výběrem možnosti Povolit automaticky v podokně, které se zobrazí.

Nasazení aplikace do zařízení s iOSem

Připojte zařízení s iOSem k Macu a nastavte aktivní schéma na zařízení s iOSem.

Vyberte Sestavit a spusťte aktuální schéma.

Spuštění aplikace

V aplikaci vyberte ukázku LocalShare pomocí šipek a pak stisknutím tlačítka Přejít! spusťte ukázku. Postupujte podle pokynů k umístění a odvolání ukotvení.

Pomocí funkce Vytvořit a sdílet ukotvení můžete vytvořit kotvu a uložit ji do služby pro sdílení. Vrátí se vám zpět identifikátor, pomocí kterého ho můžete načíst ze služby sdílení. Pak můžete spustit druhý scénář, vyhledat sdílené ukotvení z vašeho zařízení nebo jiného.

Pomocí funkce Najít sdílené ukotvení můžete dříve sdílené kotvy vyhledat zadáním dříve uvedeného identifikátoru. Po výběru scénáře vás aplikace provede dalšími pokyny. Budete například požádáni o přesunutí zařízení, abyste shromáždili informace o prostředí. Později umístíte ukotvení do světa, počkáte na uložení, spustíte novou relaci a pak ji vyhledáte.

V Xcode aplikaci zastavte tak , že vyberete Zastavit.

Android

Ukázka Pro Android v Javě podporuje sdílení mezi zařízeními.

V Android Studiu otevřete soubor SharedActivity.java ze složky samples.

Jako hodnotu SharingAnchorsServiceUrl v souboru SharedActivity.java zadejte adresu URL, kterou jste zkopírovali v předchozím kroku (z nasazení Azure ASP.NET webové aplikace).

index.html Nahraďte adresu URL textem api/anchors. Měl by vypadat takto: https://<app_name>.azurewebsites.net/api/anchors.

Nasaďte aplikaci do zařízení.

Po spuštění aplikace vyberte v podokně Zvolit ukázku a šipky vlevo a vpravo možnost LocalShare . Potom klepněte na Přejít!.

Postupujte podle pokynů v aplikaci. Můžete vybrat Vytvořit a sdílet ukotvení nebo Najít sdílené ukotvení.

Pomocí funkce Vytvořit a sdílet ukotvení můžete vytvořit kotvu a uložit ji do služby pro sdílení. Vrátí se vám zpět identifikátor, pomocí kterého ho můžete načíst ze služby sdílení. Pak můžete spustit druhý scénář, vyhledat sdílené ukotvení z vašeho zařízení nebo jiného.

Pomocí funkce Najít sdílené ukotvení můžete dříve sdílené kotvy vyhledat zadáním dříve uvedeného identifikátoru. Po výběru scénáře vás aplikace provede dalšími pokyny. Budete například požádáni o přesunutí zařízení, abyste shromáždili informace o prostředí. Později umístíte ukotvení do světa, počkáte na uložení, spustíte novou relaci a pak ji vyhledáte.

iOS

Ukázka Objective-C pro iOS podporuje sdílení napříč zařízeními.

Otevřete soubor SharedDemoViewController.m ve složce samples.

Jako hodnotu SharingAnchorsServiceUrl v souboru SharedDemoViewController.m zadejte adresu URL, kterou jste získali v předchozím kroku (z nasazení webové aplikace ASP.NET Azure).

index.html Nahraďte adresu URL textem api/anchors. Měl by vypadat takto: https://<app_name>.azurewebsites.net/api/anchors.

Nasaďte aplikaci do zařízení.

Po spuštění aplikace vyberte klepnutím možnost Spustit sdílenou ukázku a pak postupujte podle pokynů v aplikaci. Klepnutím můžete najít ukotvení podle čísla ukotvení nebo klepnutím vytvořit ukotvení a uložit ji do služby.

Pomocí funkce Vytvořit a sdílet ukotvení můžete vytvořit kotvu a uložit ji do služby pro sdílení. Vrátí se vám zpět identifikátor, pomocí kterého ho můžete načíst ze služby sdílení. Pak můžete spustit druhý scénář, vyhledat sdílené ukotvení z vašeho zařízení nebo jiného.

Pomocí funkce Najít sdílené ukotvení můžete dříve sdílené kotvy vyhledat zadáním dříve uvedeného identifikátoru. Po výběru scénáře vás aplikace provede dalšími pokyny. Budete například požádáni o přesunutí zařízení, abyste shromáždili informace o prostředí. Později umístíte ukotvení do světa, počkáte na uložení, spustíte novou relaci a pak ji vyhledáte.

Xamarin

Ukázky Xamarin Androidu i iOS podporují sdílení napříč zařízeními.

Otevřete soubor AccountDetails.cs ve složce samples.

Jako hodnotu AnchorSharingServiceUrl v souboru AccountDetails.cs zadejte adresu URL, kterou jste získali v předchozím kroku (z nasazení Azure ASP.NET webové aplikace).

index.html Nahraďte adresu URL textem api/anchors. Měl by vypadat takto: https://<app_name>.azurewebsites.net/api/anchors.

Nasaďte aplikaci do zařízení.

Po spuštění aplikace vyberte v podokně Zvolit ukázku a šipky vlevo a vpravo možnost LocalShare . Potom klepněte na Přejít!.

Postupujte podle pokynů v aplikaci. Můžete vybrat Vytvořit a sdílet ukotvení nebo Najít sdílené ukotvení.

Pomocí funkce Vytvořit a sdílet ukotvení můžete vytvořit kotvu a uložit ji do služby pro sdílení. Vrátí se vám zpět identifikátor, pomocí kterého ho můžete načíst ze služby sdílení. Pak můžete spustit druhý scénář, vyhledat sdílené ukotvení z vašeho zařízení nebo jiného.

Pomocí funkce Najít sdílené ukotvení můžete dříve sdílené kotvy vyhledat zadáním dříve uvedeného identifikátoru. Po výběru scénáře vás aplikace provede dalšími pokyny. Budete například požádáni o přesunutí zařízení, abyste shromáždili informace o prostředí. Později umístíte ukotvení do světa, počkáte na uložení, spustíte novou relaci a pak ji vyhledáte.

Vyčištění prostředků

V předchozích krocích jste vytvořili prostředky Azure ve skupině prostředků. Pokud předpokládáte, že už tyto prostředky nebudete potřebovat, můžete je odstranit tak, že odstraníte skupinu prostředků.

V nabídce webu Azure Portal nebo na domovské stránce vyberte skupiny prostředků. Potom na stránce Skupiny prostředků vyberte myResourceGroup.

Na stránce myResourceGroup se ujistěte, že uvedené prostředky jsou ty, které chcete odstranit.

Vyberte Odstranit skupinu prostředků, do textového pole zadejte myResourceGroup , abyste ji potvrdili, a pak vyberte Odstranit.

Další kroky

V tomto kurzu jste nasadili webovou aplikaci ASP.NET Core v Azure a nakonfigurovali a nasadili aplikaci Unity. Vytvořili jste prostorové ukotvení s aplikací a sdíleli jste je s jinými zařízeními pomocí webové aplikace ASP.NET Core.

Webovou aplikaci ASP.NET Core můžete vylepšit tak, aby používala službu Azure Cosmos DB k zachování úložiště identifikátorů sdílených prostorových ukotvení. Přidáním podpory služby Azure Cosmos DB můžete mít webovou aplikaci ASP.NET Core, která dnes vytvoří ukotvení. Potom pomocí identifikátoru ukotvení uloženého ve webové aplikaci můžete aplikaci vrátit dny později, abyste ukotvení znovu našli.

Ukládání ukotvení pomocí služby Azure Cosmos DB