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

Prostorové kotvy Azure jsou Vývojářské služby pro různé platformy, pomocí kterých můžete vytvářet hybridní realitu pomocí objektů, které v průběhu času uchovávají jejich umístění v rámci zařízení.

V tomto kurzu použijete prostorové kotvy Azure k vytvoření kotev během jedné relace a pak je vyhledáte na stejném zařízení nebo na jiném. Stejné kotvy mohou být také umístěny na více zařízeních na jednom místě a zároveň ve stejnou dobu.

Animace znázorňující prostorové kotvy, které jsou vytvořeny pomocí mobilního zařízení a v průběhu dnů používaly jiné zařízení.

V tomto kurzu se naučíte:

  • Nasaďte ASP.NET Core webovou aplikaci v Azure, kterou můžete použít ke sdílení kotev a ukládat kotvy do paměti po zadanou dobu.
  • Pomocí našich šablon rychlý Start můžete nakonfigurovat scénu AzureSpatialAnchorsLocalSharedDemo v rámci ukázky Unity a využít tak výhod webové aplikace sdílení kotev.
  • Nasaďte a spusťte kotvy do jednoho nebo více zařízení.

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

Předpoklady

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 prostorových kotev Azure.
  • Proveďte jedno z 5 minut rychlých startů.

    Poznámka

    Android/NDK a rychlé starty pro iOS/SWIFT momentálně neprezentují funkce vysvětlené v tomto kurzu.

  • Základní znalost z těchto součástí:
    • ARCore , pokud používáte Android.
    • ARKit , pokud používáte iOS.
  • Počítač se systémem Windows se sadou Visual Studio 2019 nebo novějším a úlohou vývoje ASP.NET a webu .
  • Sada .NET Core 3,1 SDK.
  • Jedno nebo několik z 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 ASP.NET Core webovou aplikaci, ale tento postup vám poskytne jenom příklad, jak sdílet identifikátory prostorových kotev Azure napříč ostatními zařízeními. Stejný cíl můžete dosáhnout pomocí dalších jazyků a back-endové technologie.

Vytvoření Spatial Anchors prostředků

Přejděte na Azure Portal.

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

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

Snímek obrazovky zobrazující výsledky hledání Spatial Anchors

Vyberte Spatial Anchors a pak vyberte Vytvořit.

V Spatial Anchors Účet proveďte následující:

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

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

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

    Skupina prostředků je logický kontejner, ve kterém 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 zahajte vytváření prostředku.

Snímek obrazovky Spatial Anchors pro vytvoření prostředku

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

Snímek obrazovky znázorňující dokončení nasazení prostředku

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í.

Snímek obrazovky s podoknem vlastností prostředku

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

Snímek obrazovky zobrazující hodnotu domény účtu prostředku

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

Snímek obrazovky s podoknem Klíče pro účet

Stažení ukázkového projektu

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

Nasazení služby pro sdílení kotev

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

Otevřít Průvodce publikováním

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

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

Vyberte App Service > publikovat a otevřete tak podokno vytvořit App Service .

Přihlášení k Azure

Přihlaste se k webu Azure Portal.

V podokně vytvořit App Service vyberte Přidat účet a přihlaste se ke svému předplatnému Azure. Pokud jste už přihlášení, v rozevíracím seznamu vyberte požadovaný účet.

Poznámka

Pokud už jste přihlášení, nevybírejte zatím možnost Vytvořit.

Vytvoření skupiny prostředků

Skupina prostředků je logický kontejner, ve kterém 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. Po hostování více aplikací můžete ušetřit peníze tím, že nakonfigurujete webové aplikace tak, aby sdílely jeden App Service plán.

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 App Service
Umístění USA – západ Datové centrum, ve kterém je webová aplikace hostovaná
Velikost Free Cenová úroveň , která určuje funkce hostování

Vyberte OK.

Vytvoření a publikování webové aplikace

Do název aplikace zadejte jedinečný název aplikace. Platné znaky jsou a-z, 0-9 a spojovníky (-), nebo přijměte automaticky generovaný jedinečný název. Adresa URL webové aplikace je https://<app_name>.azurewebsites.net, kde <app_name> je název vaší aplikace.

Výběrem možnosti Vytvořit spustíte vytváření prostředků Azure.

Po dokončení průvodce publikuje ASP.NET Core webovou aplikaci do Azure a pak aplikaci otevře ve výchozím prohlížeči.

Snímek obrazovky publikované webové aplikace v ASP.NET v Azure

Název aplikace, který jste použili v této části, se použije jako předpona adresy URL ve formátu https://<app_name>.azurewebsites.net . Zkopírujte tuto adresu URL do textového editoru pro pozdější použití.

Nasazení ukázkové aplikace

Ukázka Java Android podporuje sdílení přes zařízení.

V Android Studio otevřete soubor SharedActivity. Java ze složky Samples.

Zadejte adresu URL, kterou jste zkopírovali v předchozím kroku (z nasazení Azure Web App ASP.NET) jako hodnotu SharingAnchorsServiceUrl v souboru SharedActivity. Java .

Nahraďte index.html adresu v adrese URL api/anchors . Mělo by to vypadat takto: https://<app_name>.azurewebsites.net/api/anchors .

Nasaďte aplikaci do svého zařízení.

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

Postupujte podle pokynů v aplikaci. Můžete vybrat možnost vytvořit & sdílet kotvu nebo Vyhledat sdílené kotvy.

Pomocí příkazového kotvy shared & můžete vytvořit kotvu a uložit ji do služby pro sdílení. V části vrátit se vrátí identifikátor, který můžete použít k načtení ze služby sdílení. Pak můžete spustit druhý scénář, Vyhledat sdílené kotvy buď ze svého zařízení, nebo z jiného.

Při hledání sdíleného kotvy můžete vyhledat dříve sdílené kotvy zadáním výše zmíněné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í do složky pro shromáždění informací o prostředí. Později umístíte kotvu do světa, počkejte na její uložení, spusťte novou relaci a pak ji vyhledejte.

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 Azure Portal nebo na domovské stránce vyberte skupiny prostředků. Pak 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 a pak vyberte Odstranit.

Další kroky

V tomto kurzu jste nasadili ASP.NET Core webovou aplikaci v Azure a Vy jste nakonfigurovali a nasadili aplikaci Unity. Vytvořili jste prostorové kotvy s aplikací a sdílíte je s ostatními zařízeními pomocí ASP.NET Core webové aplikace.

Můžete vylepšit ASP.NET Core webové aplikace tak, aby používala Azure Cosmos DB k uchování úložiště vašich sdílených prostorových kotev identifikátorů. Přidáním podpory Azure Cosmos DB můžete mít ASP.NET Core webové aplikace vytvořit kotvu ještě dnes. Pak pomocí identifikátoru kotvy, který je uložený ve vaší webové aplikaci, můžete nechat aplikaci vrátit dny později, aby se kotva znovu našli.