Migrace projektu Unity 2019 na Unity 2020 + OpenXR

Článek
07/12/2023

Pro zajištění co nejhladší migrace doporučujeme provést všechny kroky v tomto článku v uvedeném pořadí. Tady je přehled hlavních kroků:

Aktualizujte sadu MRTK na nejnovější stabilní verzi.
Přesuňte projekt do správy modulů plug-in Unity 2019 XR.
Zvolte "Windows Mixed Reality".
Upgradujte na Unity 2020.3 LTS.
K instalaci dalších balíčků použijte nástroj Mixed Reality Feature Tool.
Konfigurace správy modulů plug-in XR pro OpenXR

1. Aktualizace SADY MRTK na nejnovější stabilní verzi

Pokud už používáte SADU MRTK, doporučujeme, aby prvním krokem při migraci bylo spuštění nástroje Mixed Reality Feature Tool a aktualizace na nejnovější stabilní verzi sady MRTK.

Vyberte požadované funkce.

Poznámka

Popisy a obrázky v této části vycházejí z nejnovější verze nástroje. Pokud se pokyny neshodují s tím, co vidíte, zkontrolujte, jestli nepoužíváte starší verzi nástroje.

Otevřete nástroj Microsoft Mixed Reality Feature Tool a klikněte na tlačítko Start.
Vyberte tlačítko Procházet (je to tlačítko se třemi tečky na obrázku níže), přejděte na projekt a otevřete ho.
Vyberte Zjistit funkce.

Poznámka: Možná budete muset několik sekund počkat, než nástroj aktualizuje balíčky z informačních kanálů.
Na stránce Zjistit funkce si všimněte, že je k dispozici seznam šesti skupin balíčků.
Klikněte na tlačítko +nalevo od Mixed Reality Toolkit a vyberte nejnovější verzi sady Mixed Reality Toolkit Foundation.

Import funkcí

Po výběru klikněte na Získat funkce.
Na stránce Importovat funkce se v levém sloupci Funkce zobrazují balíčky, které jste právě vybrali. V pravém sloupci Požadované závislosti se zobrazí všechny závislosti. Další informace o těchto položkách získáte kliknutím na odkaz Podrobnosti .
Až budete chtít pokračovat, vyberte Importovat. Na stránce Zkontrolovat a schválit můžete zkontrolovat informace o balíčcích.
Vyberte Schválit. Nástroj funkce zobrazí zprávu, že váš projekt byl aktualizován.
Vraťte se do Editoru Unity a klikněte na prázdnou oblast v uživatelském rozhraní. Zobrazí se zpráva, že se balíčky importují.

Když tento upgrade provedete při používání Unity 2019, můžete zobrazit konfigurátor projektu MRTK a zobrazit všechna upozornění "zastaralého rozhraní API" o tom, jak získat aktuální. Upozornění vám řeknou, co změnit. Pokud tento upgrade MRTK neprovedete jako první, může být staré rozhraní API pryč a nebudete mít tato upozornění.

Přečtěte si další informace o nástroji Mixed Reality Feature Tool.

2. Přesuňte projekt do správy modulů plug-in Unity 2019 XR

Po aktualizaci MRTK můžete unity 2019 dát pokyn, aby používala správu modulů plug-in XR.

V editoru Unity na řádku nabídek vyberte Upravit>nastavení projektu.
V levém sloupci okna Nastavení projektu vyberte Správa modulů plug-in XR.

V tomto okamžiku se může zobrazit tlačítko s názvem Install XR Plugin Management button (Nainstalovat správu modulů plug-in XR ). Pokud ano, pokračujte následujícím postupem. Pokud už máte systém pro správu XR nainstalovaný, můžete přeskočit zbývající kroky v této části a pokračovat k další části Zvolte Windows Mixed Reality.

Klikněte na tlačítko Nainstalovat správu modulů plug-in XR .
Zobrazí se dialogové okno s názvem Zjištění integrované virtuální reality s dotazem, jestli chcete odebrat integrovaný balíček VR. Klikněte na OK.
Zobrazí se dialogové okno Integrované virtuální realita s povolenou virtuální realitou. Klikněte na OK. Tím se zakáže integrovaná virtuální realita.
Zobrazí se okno Konfigurátor projektu MRTK a požádá vás o povolení kanálu XR. Vyberte druhou možnost, XR SDK/SR Management.
Na další stránce v konfigurátoru klikněte na Zobrazit nastavení.

3. Zvolte "Windows Mixed Reality"

Ještě ještě nejsme připravení nainstalovat OpenXR, ale tato další sada kroků vám pomůže vyčistit všechna rozhraní API, která byla dostupná a podporovaná pouze v integrované cestě XR. (Pokud používáte SADU MRTK, většina z nich je pro vás abstraktovaná.)

V okně Nastavení projektu Unity Editoru se ujistěte, že jste na stránce Správa modulů plug-in XR .
Proveďte některou z následujících akcí:
- Pokud cílíte na HoloLens 2:
  Ujistěte se, že jste na kartě Univerzální platforma Windows (je to druhá karta s logem Windows) a pak v části Poskytovatelé modulů plug-in vyberte Windows Mixed Reality.
- Pokud cílíte na Desktop VR:
  Ujistěte se, že jste na kartě Plocha (je to první karta a zobrazuje obrázek monitoru) a pak v části Poskytovatelé modulů plug-in vyberte Windows Mixed Reality.
Znovu se zobrazí okno Konfigurátoru projektu MRTK . Klikněte na tlačítko Další a potom znovu klikněte na Další . (Než budete postupovat dál, možná si budete chtít chvíli přečíst vysvětlení na těchto stránkách.)
Vyberte Importovat TMP Essentials.
Vyberte Hotovo. Tím se konfigurátor zavře.
Zavřete okno Nastavení projektu , uložte projekt a ukončete Unity.

Poznámka

Pokud v Unity 2019 používáte správu modulů plug-in XR, azure Spatial Anchors (ASA) se nepodporuje. Pokud má váš projekt kód ASA, nebudete ho moct otestovat, dokud nenainstalujete Unity 2020. Jinak byste měli být schopni aplikaci ověřit v této fázi.

4. Upgrade na Unity 2020.3 LTS

Nainstalujte nejnovější verzi opravy LTS pro Unity 2020.3.
Otevřete projekt Unity 2019 v Unity 2020.3.

Zobrazí se dialogové okno s dotazem, jestli chcete projekt upgradovat na novější verzi Unity. Klikněte na POTVRDIT.

Pokud jste dříve používali AR Foundation 2.0, projekt vás automaticky přesune na AR Foundation 4.0.

5. Pomocí nástroje Mixed Reality Feature Tool nainstalujte další balíčky.

Pomocí nástroje Mixed Reality Feature Tool naimportujte níže uvedené balíčky.

Pokud používáte ASA, otevřete rozevírací seznam Azure Mixed Reality Services a vyberte nejnovější verzi sady Azure Spatial Anchors SDK Core a Azure Spatial Anchors SDK pro Windows.
Otevřete rozevírací seznam Podpora platformy a vyberte nejnovější verzi modulu plug-in Mixed Reality OpenXR.
Po načtení balíčků se zobrazí dialogové okno Upozornění s dotazem, jestli chcete restartovat editor Unity, aby se povolily back-endy. Vyberte Ano.
Při opětovném otevření Unity se zobrazí konfigurátor projektu MRTK . Chvíli si přečtěte vysvětlení v okně a pak vyberte Použít.
Zobrazí se dialogové okno s oznámením, že aby se vstupní systém projevil, je nutné restartovat Unity. Vyberte Použít.

6. Konfigurace správy modulů plug-in XR pro OpenXR

Po opětovném otevření Unity můžete jako modul runtime nastavit OpenXR:

Na řádku nabídek vyberte Upravit>nastavení projektu.

Podívejte se do levého sloupce a ujistěte se, že jste na stránce Správa modulů plug-in XR a na kartě Univerzální platforma Windows (na kartě je obrázek loga Windows).
V seznamu Poskytovatelé modulů plug-in vyberte OpenXR.
Ve stejné části vyberte Microsoft HoloLens skupinu funkcí.
Všimněte si, že vedle OpenXR je teď žlutý trojúhelník s upozorněním. Najeďte kurzorem na trojúhelník, přečtěte si zprávu v automaticky otevírané nabídce a pak trojúhelník vyberte.
V okně Ověření projektu OpenXR je uvedeno několik problémů. Vyberte tlačítko Opravit vše .
Jeden problém přetrvává a říká vám, že musíte přidat aspoň jeden profil interakce. Uděláte to tak, že kliknete na Upravit. Tím přejdete na nastavení modulu plug-in OpenXR v okně Nastavení projektu .
Třikrát vyberte tlačítko se znaménkem plus (+), pokaždé zvolíte jiný profil:

Profil interakce očního pohledu

Microsoft Hand Interaction Profile

Microsoft Motion Controller Profile

Pokud se profil interakce očního pohledu nebo jakýkoli jiný profil zobrazí se žlutým trojúhelníkem vedle něj, vyberte ho a potom v okně Ověření projektu OpenXR klikněte na tlačítko Opravit .
V části Skupiny funkcí OpenXR vyberte Microsoft HoloLens a pak vyberte Sledování rukou a Model ovladače pohybu,pokud ještě nejsou vybrané.
Klikněte na rozevírací seznam Režim odeslání hloubky a vyberte Hloubka 16 bitů.
Zavřete okno Nastavení projektu a všechna další okna, která jsou stále otevřená.