Pierwsze kroki z AR Foundation

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Platforma Unity Platforma jest dostępna w pakiecie AR Foundation typu Unity.

Pakiet ARCore' jest opcjonalny. Pakiet ARCore Extensions for AR Foundation Pakiet zawiera dodatkowe funkcje, takie jak kotwicy Cloud, filtry konfiguracji kamery oraz nagrywanie i odtwarzanie w Twojej aplikacji.

Migracja istniejących projektów i uaktualnianie ich

  • Aby przenieść istniejący projekt z wycofanego, ARCore SDK dla Unity za pomocą AR Foundation i opcjonalnie ARCore Extensions, zapoznaj się z przewodnikiem po migracji.
  • Aby uaktualnić istniejący projekt ze starszej 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

Instalowanie AR Foundation

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 pozycji Packages wybierz Unity Registry.

  4. W 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 dla programistów Unity, ale nie wdraża żadnych funkcji AR. Aby korzystać z AR AR na urządzeniu docelowym, musisz też zainstalować oddzielne pakiety i włączyć odpowiednią wtyczkę do każdej platformy.

Android

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

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

  2. Obok pozycji 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 opcję ARCore.

iOS

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

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

  2. Obok pozycji 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 opcję ARKit.

Skonfiguruj sesję AR i dodaj do sceny komponenty AR Foundation

Scena wymaga sesji AR, aby włączyć procesy AR, takie jak śledzenie ruchu, zrozumienie środowiska czy szacowanie oświetlenia. Aby obsługiwać sesję AR, potrzebujesz tych obiektów gry:

  • AR Session: kontroluje cykl życia doświadczenia w rzeczywistości rozszerzonej.

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

Zanim dodasz nowe obiekty gry, usuń Main Camera. W AR Session Origin pojawi się nowa kolumna AR Camera.

Dodaj do swojej sceny nowe obiekty gier 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 okno 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 pole Auto Graphics API.
    Jeśli pole Vulkan znajduje się na liście Graphics APIs, usuń je, ponieważ narzędzie Vulkan nie jest jeszcze obsługiwane przez ARCore.
    Other Settings > Package Name Utwórz unikalny identyfikator aplikacji w formacie nazwy pakietu Java.
    Użyj na przykład com.example.helloAR.
    Other Settings > Minimum API Level Jeśli tworzysz aplikację wymagana AR, wpisz Android 7.0 'Nougat' (API Level 24) or higher.
    Jeśli tworzysz aplikację opcjonalnej aplikacji, określ wartość 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 interfejsu Mono + 32-bitowy (ARMv7)
    • Zainstaluj plik APK ARF (FAT (32- i 64-bitowy))

    Podczas dostawy do Sklepu Play:

    • Użyj formatu: IL2CPP
    • Włącz 32-bitowe (ARMv7) i 64-bitowe (ARM64) wymagania Google Play dotyczące kodu 64-bitowego.
    • Opcjonalnie (obsługiwana w wersji 2018.3 lub nowszej): w wersji Build Settings włącz Android App Bundles
    Other Settings > Target Architectures Aby spełnić wymagania Google Play dotyczące systemu 64-bitowego, włącz ustawienie ARM64 (ARM 64-bitowego). Pozostaw interfejs ARMv7 (32-bitowy ARM) włączony, aby obsługiwać urządzenia 32-bitowe.

iOS

  1. Otwórz okno 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 Podaj opis, aby wyjaśnić, w jaki sposób korzystasz z AR (np. ARKit).
    Other Settings > Target minimum iOS version 11.0 lub więcej
    Other Settings > Architecture ARM64

Co dalej