Dziękujemy za udział w konferencji Google I/O. Sprawdź sesje.

Pierwsze kroki z AR Foundation

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

Opcjonalny pakiet ARCore Extensions for AR Foundation obejmuje dodatkowe funkcje, które pozwalają korzystać w aplikacji z takich funkcji jak kotwicy w chmurze, filtry konfiguracji aparatu oraz nagrywanie i odtwarzanie.

Przeprowadź migrację lub uaktualnij istniejące projekty

  • Aby przenieść istniejący projekt z (wycofanego) pakietu ARCore SDK dla Unity na platformę AR (opcjonalnie) rozszerzeń ARCore, przeczytaj przewodnik po migracji.
  • Aby przenieść istniejący projekt z wcześniejszej wersji AR Foundation, zapoznaj się z przewodnikami po migracji i migracji w Unity.

Wymagania

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

Android

Sprzęt

Oprogramowanie

iOS

Sprzęt

Oprogramowanie

Zainstaluj AR Foundation

Aby zainstalować pakiet AR Foundation Unity, 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 pozycji Packages wybierz Unity Registry.

  4. Na pasku wyszukiwania wpisz „AR Foundation”.

  5. Kliknij Install.

Instalowanie i włączanie pakietów wtyczek związanych z daną platformą

Pakiet AR Foundation ma interfejs używany przez programistów Unity, ale nie implementuje żadnych funkcji AR. Aby korzystać z AR Foundation na urządzeniu docelowym, musisz też zainstalować oddzielne pakiety i włączyć odpowiednią wtyczkę na każdej z tych platform.

Android

Pakiet ARCore XR Plugin pozwala tworzyć aplikacje rzeczywistości rozszerzonej na urządzenia z Androidem. Jeśli aplikacja jest kierowana na urządzenia z Androidem, wykonaj te czynności, aby ją zainstalować w projekcie Unity. Aby uniknąć problemów ze zgodnością, użyj tej samej wersji co w pakiecie AR Foundation.

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

  2. Obok pozycji Packages wybierz 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.

iOS

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

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

  2. Obok pozycji Packages wybierz 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

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

  • AR Session: kontroluje cykl życia AR.

  • AR Session Origin: przekształca współrzędne AR na współrzędne Świat Unity.

Zanim dodasz nowe obiekty gry, usuń Main Camera. Zastąpi ją nowy element AR Camera w AR Session Origin.

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

Skonfiguruj ustawienia odtwarzacza

Android

  1. Otwórz File > Build Settings, aby otworzyć okno Build Settings.
  2. Pod 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 Vulkan znajduje się na liście Graphics APIs, usuń go, ponieważ Vulkan nie jest jeszcze obsługiwany przez ARCore.
    Other Settings > Package Name Utwórz unikalny identyfikator aplikacji w formacie nazwy pakietu Java.
    Użyj np. com.example.helloAR.
    Other Settings > Minimum API Level Jeśli tworzysz aplikację wymaganą do odzyskiwania konta, podaj wartość Android 7.0 'Nougat' (API Level 24) or higher.
    Jeśli tworzysz aplikację opcjonalnej aplikacji AR, wpisz Android API Level 19 or higher.
    Other Settings > Scripting Backend Wybierz IL2CPP zamiast Mono, aby włączyć obsługę ARM64 w następnym kroku.

    Podczas programowania:

    • Użyj Mono + 32-bit (ARMv7)
    • Zainstaluj plik APK ARCore FAT (32- i 64-bitowy)

    Podczas wysyłki do Sklepu Play:

    • Stosuj rekomendacje typu IL2CPP
    • Aby spełnić wymagania dotyczące plików 64-bitowych, włącz zarówno 32-bitowy (ARMv7), jak i 64-bitowy (ARM64)
    • Opcjonalnie (opcja obsługiwana w wersji 2018.3 i nowszych): w Build Settings włącz Android App Bundles
    Other Settings > Target Architectures Aby spełnić wymagania dotyczące Google Play w zakresie 64 bitów, włącz ARM64 (64-bitowy procesor ARM). Aby obsługiwać urządzenia 32-bitowe, pozostaw włączoną (ARMv7) 32-bitową wersję ARM.

iOS

  1. Otwórz File > Build Settings, aby otworzyć okno Build Settings.
  2. Pod 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 Podaj opis działania AR (np. ARKit).
    Other Settings > Target minimum iOS version 11.0 lub więcej
    Other Settings > Architecture ARM64

Co dalej?