Pierwsze kroki z AR Foundation

AR Foundation to platforma wieloplatformowa, która umożliwia tworzenie aplikacji rzeczywistości rozszerzonej, a następnie kompilowanie ich na urządzenia z Androidem lub iOS bez wprowadzania dodatkowych zmian. Platforma jest dostępna w pakiecie AR Foundation Unity.

Opcjonalny pakiet ARCore Extensions for AR Foundation do ARCore dodaje dodatkowe funkcje, które umożliwiają korzystanie w aplikacji z takich funkcji jak m.in. uchwyty w chmurze, filtry konfiguracji aparatu oraz nagrywanie i odtwarzanie.

Migracja lub uaktualnianie dotychczasowych projektów

Wymagania

W zależności od platformy docelowej pakiet AR Foundation wymaga:

AndroidiOS

Sprzęt

  • Obsługujące ARCore urządzenie z Androidem lub emulator
  • Kabel USB do podłączania urządzenia do komputera programistycznego

Oprogramowanie

Sprzęt

Oprogramowanie

Instalowanie AR Foundation

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

  1. Otwórz istniejący projekt Unity lub utwórz nowy projekt 3D.
  2. Wejdź na Window > Package Manager.

  3. Obok Packages kliknij Unity Registry.

  4. Na pasku wyszukiwania wpisz „AR Foundation”.

  5. Kliknij Install.

  6. Konfigurowanie potoku renderowania

    AR Foundation 4.xAR Foundation 5.xAR Foundation 6.x

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

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

AndroidiOS

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

  1. W projekcie przejdź do Window > Package Manager.

  2. Obok Packages kliknij Unity Registry.

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

  4. Kliknij Install.

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

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

  1. W projekcie przejdź do Window > Package Manager.

  2. Obok Packages kliknij Unity Registry.

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

  4. Kliknij Install.

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

Konfigurowanie sesji AR i dodawanie komponentów AR Foundation do sceny

Aby włączyć procesy AR, takie jak śledzenie ruchu, rozpoznawanie środowiska i szacowanie oświetlenia, scena potrzebuje sesji AR. Aby obsługiwać sesję AR, potrzebujesz tych obiektów w grze:

AR Foundation 4.xAR Foundation 5.xAR Foundation 6.x

  • AR Session: kontroluje cykl życia funkcji AR.

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

Zanim dodasz nowe obiekty gry, usuń domyślne Main Camera. Zostanie on zastąpiony nowym AR Camera w polu XR Origin.

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

  • AR Session: kontroluje cykl życia funkcji AR.

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

Zanim dodasz nowe obiekty gry, usuń domyślne Main Camera. Zostanie on zastąpiony nowym AR Camera w polu XR Origin.

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

Konfigurowanie ustawień odtwarzacza

AndroidiOS
  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. Wprowadź te zmiany:

    Player Settings > … Wartość
    Other Settings > Rendering Odznacz Auto Graphics API.
    Jeśli w sekcji Graphics APIs widnieje opcja Vulkan, usuń ją, ponieważ interfejs Vulkan nie jest jeszcze obsługiwany przez ARCore.
    Other Settings > Package Name Utwórz unikalny identyfikator aplikacji, używając formatu nazwy pakietu Java.
    Na przykład com.example.helloAR.
    Other Settings > Minimum API Level Jeśli tworzysz aplikację AR wymagany, określ Android 7.0 'Nougat' (API Level 24) or higher.
    Jeśli tworzysz aplikację z opcjonalną obsługą AR, określ Android API Level 19 or higher.
    Other Settings > Scripting Backend Aby w następnym kroku włączyć obsługę ARM64, wybierz IL2CPP zamiast Mono.

    W trakcie tworzenia:

    • Użyj Mono + 32-bit (ARMv7)
    • Instalowanie pliku APK ARCore (32- i 64-bitowego) typu FAT

    Przy wysyłce do Sklepu Play:

    • Użyj konta IL2CPP
    • Włącz wersje 32-bitową (ARMv7) i 64-bitową (ARM64), aby spełnić wymagania Sklepu Play dotyczące wersji 64-bitowej
    • Opcjonalnie (obsługiwane w wersji 2018.3 i nowszych): w sekcji Build Settings włącz Android App Bundles.
    Other Settings > Target Architectures Aby spełnić wymagania Google Play dotyczące kodu 64-bitowego, włącz ARM64 (64-bitowy ARM). Pozostaw włączoną opcję ARMv7 (32-bitowy ARM), aby obsługiwać urządzenia 32-bitowe.
  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 com.mycompany.myapp.
    Other Settings > Camera usage description Wpisz 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?