Pierwsze kroki z AR Foundation

Fundacja AR Unity to wieloplatformowa platforma, która pozwala raz pisać treści rzeczywistości rozszerzonej, a następnie tworzyć treści na urządzenia z Androidem lub iOS bez wprowadzania dodatkowych zmian. Platforma jest dostępna w pakiecie AR Foundation Unity.

Opcjonalny pakiet ARCore rozszerzeń ARCore dla AR Foundation zawiera dodatkowe funkcje, takie jak kotwice w chmurze, filtry konfiguracji aparatu oraz nagrywanie i odtwarzanie w aplikacji.

Migracja lub uaktualnianie istniejących projektów

  • Aby przenieść istniejący projekt z (wycofanego) pakietu SDK ARCore SDK dla Unity do AR Foundation na platformie Unity i opcjonalnie rozszerzeń ARCore, zapoznaj się z przewodnikiem po migracji.
  • Aby uaktualnić istniejący projekt ze starszej wersji AR Foundation, zapoznaj się z przewodnikami po uaktualnieniu i migracji w Unity.

Wymagania

W zależności od platformy docelowej pakiet AR Foundation wymaga tych elementów:

Android

Sprzęt

  • urządzenie z Androidem lub emulator obsługujące ARCore.
  • kabel USB do podłączenia urządzenia do komputera,

Oprogramowanie

iOS

Sprzęt

Oprogramowanie

Zainstaluj AR Foundation

Aby zainstalować pakiet Unity (AR Foundation), wykonaj te czynności.

  1. Otwórz istniejący projekt w Unity lub utwórz nowy projekt 3D.

  2. Wejdź na Window > Package Manager.

  3. Obok Packages wybierz Unity Registry.

  4. Na pasku wyszukiwania wpisz „AR Foundation”.

  5. Kliknij Install.

Instalowanie i włączanie pakietów wtyczek dla poszczególnych platform

Pakiet AR Foundation to interfejs dla programistów Unity, ale nie zawiera żadnych funkcji AR. Aby używać AR Foundation na urządzeniu docelowym, musisz też zainstalować oddzielne pakiety i włączyć odpowiednią wtyczkę na każdej platformie.

Android

Pakiet wtyczki ARCore XR umożliwia tworzenie aplikacji rzeczywistości rozszerzonej na urządzenia z Androidem. Jeśli Twoja aplikacja jest kierowana na urządzenia z Androidem, wykonaj te czynności, aby zainstalować ją w projekcie Unity. Aby uniknąć problemów ze zgodnością, użyj tej samej wersji co pakiet AR Foundation.

  1. W projekcie otwórz Window > Package Manager.

  2. Obok Packages wybierz Unity Registry.

  3. Na pasku wyszukiwania wpisz „ARCore XR wtyczka”.

  4. Kliknij Install.

  5. Wejdź na Edit > Project Settings. W aplikacji XR Plug-in Management otwórz kartę Android i włącz usługę ARCore.

iOS

Wtyczka ARKit XR umożliwia tworzenie aplikacji rzeczywistości rozszerzonej na urządzenia z iOS. Jeśli Twoja aplikacja jest kierowana na urządzenia z iOS, wykonaj te czynności, aby zainstalować ją w projekcie Unity. Aby uniknąć problemów ze zgodnością, użyj tej samej wersji co pakiet AR Foundation.

  1. W projekcie otwórz Window > Package Manager.

  2. Obok Packages wybierz Unity Registry.

  3. Na pasku wyszukiwania wpisz „ARKit XR wtyczka”.

  4. Kliknij Install.

  5. Wejdź na Edit > Project Settings. W aplikacji XR Plug-in Management otwórz kartę iOS i włącz usługę ARKit.

Skonfiguruj sesję AR i dodaj do sceny komponenty AR Foundation

Scena wymaga sesji AR, aby włączyć procesy AR, takie jak śledzenie ruchu, analiza środowiska i ocena oświetlenia. Do obsługi sesji AR potrzebne są te obiekty gry:

AR Foundation 4.x

  • AR Session: kontroluje cykl życia środowiska AR.

  • AR Session Origin: przekształca współrzędne AR we współrzędne świata Unity.

Zanim dodasz nowe obiekty gry, usuń domyślny Main Camera. Zastąpimy ją nowym AR Camera w AR Session Origin.

Dodaj do sceny nowe obiekty gry AR: kliknij prawym przyciskiem myszy panel Hierarchy i wybierz XR. Dodaj nowy AR Session i nowy obiekt gry AR Session Origin.

AR Foundation 5.x

  • AR Session: kontroluje cykl życia środowiska AR.

  • XR Origin: przekształca współrzędne AR we współrzędne świata Unity.

Zanim dodasz nowe obiekty gry, usuń domyślny Main Camera. Zastąpimy ją nowym AR Camera w XR Origin.

Dodaj do sceny nowe obiekty gry AR: kliknij prawym przyciskiem myszy panel Hierarchy i wybierz XR. Dodaj nowy AR Session i nowy obiekt gry XR Origin.

Skonfiguruj ustawienia odtwarzacza

Android

  1. Przejdź do File > Build Settings, aby otworzyć okno Build Settings.
  2. W sekcji Platform wybierz Android i kliknij Switch Platform.
  3. Kliknij Player Settings.
  4. Zastosuj te zmiany:

    Player Settings > … Wartość
    Other Settings > Rendering Odznacz Auto Graphics API.
    Jeśli domena Vulkan znajduje się na liście Graphics APIs, usuń ją, ponieważ ARCore nie obsługuje jeszcze interfejsu Vulkan.
    Other Settings > Package Name Utwórz unikalny identyfikator aplikacji, używając formatu nazwy pakietu Java.
    Na przykład użyj com.example.helloAR.
    Other Settings > Minimum API Level Jeśli tworzysz aplikację wymagającą AR, określ Android 7.0 'Nougat' (API Level 24) or higher.
    Jeśli tworzysz aplikację opcjonalną w AR, określ Android API Level 19 or higher.
    Other Settings > Scripting Backend Wybierz IL2CPP zamiast Mono, aby zezwolić na włączenie obsługi ARM64 w następnym kroku.

    Podczas tworzenia:

    • Użyj wersji Mono lub 32-bitowej (ARMv7)
    • Zainstaluj pakiet APK w systemie FAT (32- i 64-bitowy) ARCore

    Przy dostawie do Sklepu Play:

    • Użyj IL2CPP
    • Włącz systemy 32-bitowe (ARMv7) i 64-bitowe (ARM64), aby spełniały wymagania Sklepu Play dotyczące wersji 64-bitowej
    • Opcjonalnie (obsługiwane w wersji 2018.3 i nowszych): w Build Settings włącz usługę Android App Bundles
    Other Settings > Target Architectures Aby spełnić wymagania Google Play dotyczące kodu 64-bitowego, włącz tryb ARM64 (64-bitowy ARM). Pozostaw włączoną strategię ARMv7 (32-bitowa ARM), aby obsługiwać urządzenia 32-bitowe.

iOS

  1. Przejdź do File > Build Settings, aby otworzyć okno Build Settings.
  2. W sekcji Platform wybierz iOS i kliknij Switch Platform.
  3. Kliknij Player Settings.
  4. Skonfiguruj te ustawienia:

    Player Settings > … Wartość
    Other Settings > Bundle Identifier Dodaj nazwę aplikacji w odwrotnym formacie DNS.
    Na przykład użyj com.mycompany.myapp.
    Other Settings > Camera usage description Dodaj opis, aby wyjaśnić, jak używasz AR (np. ARKit).
    Other Settings > Target minimum iOS version 11.0 lub więcej
    Other Settings > Architecture ARM64

Co dalej