Pierwsze kroki z AR Foundation

Jedności Podstawy AR to wieloplatformowa platforma umożliwiająca pisanie treści w rzeczywistości rozszerzonej. raz, a następnie utworzyć aplikację na urządzenia z Androidem lub iOS bez dodawania zmian. Platforma jest dostępna w pakiecie AR Foundation Unity.

Opcjonalna ARCore ARCore Extensions for AR Foundation pakiet zawiera dodatkowe funkcje, dzięki którym można korzystać z takich funkcji, jak Elementy zakotwiczone w chmurze, filtry konfiguracji kamery oraz funkcje nagrywania i odtwarzania .

Przeprowadź migrację lub uaktualnianie istniejących projektów

Wymagania

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

Android

Sprzęt

  • urządzenie z Androidem z obsługą ARCore lub emulator
  • Kabel USB do podłączenia urządzenia do komputera, z którego korzystasz

Oprogramowanie

iOS

Sprzęt

Oprogramowanie

Zainstaluj podstawę AR

Wykonaj te czynności, aby zainstalować pakiet Unity AR Foundation.

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

  2. Wejdź na Window > Package Manager.

  3. Obok pola Packages wybierz Unity Registry.

  4. Na pasku wyszukiwania wpisz „Podstawy AR”.

  5. Kliknij Install.

Instalowanie i włączanie pakietów wtyczek na poziomie platformy

Pakiet AR Foundation przedstawia interfejs dla programistów Unity, ale nie implementuje żadnych funkcji AR. Aby użyć funkcji AR Foundation na potrzeby celu musisz też zainstalować oddzielne pakiety i włączyć wtyczki dla każdej platformy.

Android

Wtyczka ARCore XR pozwala tworzyć aplikacje rzeczywistości rozszerzonej na urządzenia z Androidem. Wykonaj te czynności, aby zainstalować ją w projekcie Unity, jeśli Twoja aplikacja jest kierowana na urządzenia z Androidem. Użyj tej samej wersji co w pakiecie AR Foundation , by uniknąć problemów ze zgodnością.

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

  2. Obok pola Packages wybierz Unity Registry.

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

  4. Kliknij Install.

  5. Wejdź na Edit > Project Settings. W usłudze 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. Wykonaj te czynności, aby zainstalować ją w projekcie Unity, jeśli Twoja aplikacja jest kierowana na urządzenia z iOS. Użyj tej samej wersji co w pakiecie AR Foundation, aby uniknąć problemów ze zgodnością.

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

  2. Obok pola Packages wybierz Unity Registry.

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

  4. Kliknij Install.

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

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

Aby można było włączyć procesy AR, scena wymaga sesji AR, takich jak śledzenie ruchu, rozpoznawanie środowiska i szacowanie oświetlenia. Do obsługi sesji AR potrzebujesz tych obiektów gry:

AR Foundation 4.x

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

  • AR Session Origin: przekształca współrzędne AR w Unity współrzędnych na świecie.

Zanim dodasz nowe obiekty gry, usuń domyślny obiekt Main Camera. Zostanie ona zastąpiona nowym elementem AR Camera w AR Session Origin

Dodaj do sceny nowe obiekty gry AR: kliknij prawym przyciskiem myszy Hierarchy i kliknij XR. Dodaj nowe: AR Session i nowe AR Session Origin obiekt w grze.

AR Foundation 5.x

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

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

Zanim dodasz nowe obiekty gry, usuń domyślny obiekt Main Camera. Zostanie ona zastąpiona nowym elementem AR Camera w XR Origin

Dodaj do sceny nowe obiekty gry AR: kliknij prawym przyciskiem myszy Hierarchy i kliknij XR. Dodaj nowe: AR Session i nowe XR Origin obiekt w grze.

Skonfiguruj ustawienia odtwarzacza

Android

  1. Przejdź do File > Build Settings, aby otworzyć Build Settings okno.
  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 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 w formacie nazwy pakietu Java.
    Na przykład użyj com.example.helloAR.
    Other Settings > Minimum API Level Jeśli tworzysz aplikację wymaganą AR, podaj Android 7.0 'Nougat' (API Level 24) or higher.
    Jeśli tworzysz aplikację opcjonalnie AR, wpisz Android API Level 19 or higher.
    Other Settings > Scripting Backend Wybierz IL2CPP zamiast Mono, aby w następnym kroku zezwolić na włączenie obsługi ARM64.

    W trakcie tworzenia aplikacji:

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

    W przypadku wysyłki do Sklepu Play:

    • Użyj konta IL2CPP
    • Włącz obsługę wersji 32-bitowej (ARMv7) i 64-bitowej (ARM64), aby spełnić wymagania Sklepu Play o architekturze 64-bitowej
    • Opcjonalnie (funkcja obsługiwana w wersji 2018.3 i nowszych): w usłudze Build Settings włącz Android App Bundles
    Other Settings > Target Architectures Aby spełnić wymagania Google Play dotyczące wersji 64-bitowej, włącz ARM64 (64-bitową architekturę ARM). Aby obsługiwać urządzenia 32-bitowe, pozostaw włączoną funkcję ARMv7 (32-bitową architekturę ARM).

iOS

  1. Przejdź do File > Build Settings, aby otworzyć Build Settings okno.
  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 wpisz com.mycompany.myapp.
    Other Settings > Camera usage description Podaj opis, w którym wyjaśniasz, jak korzystasz z AR (na przykład ARKit).
    Other Settings > Target minimum iOS version 11.0 lub więcej
    Other Settings > Architecture ARM64

Co dalej?