Opcjonalny pakiet ARCore Extensions for AR Foundation wzbogaca pakiet Unity AR Foundation o funkcje takie jak kotwice w chmurze, filtry konfiguracji aparatu oraz nagrywanie i odtwarzanie w aplikacji.
Wymagania
Aby tworzyć rozszerzenia z wykorzystaniem ARCore Extensions for AR Foundation, potrzebne są:
Android
Sprzęt
- urządzenie z Androidem obsługujące ARCore,
- kabel USB do podłączenia urządzenia do komputera,
Oprogramowanie
- Unity 2019.4.3f1 lub nowszy z obsługą Androida Build,
- AR Foundation 4.1.5 lub nowsze (instalowane automatycznie za pomocą ARCore Extensions for AR Foundation SDK)
- Wtyczka ARCore XR 4.1.5 lub nowsza (zainstalowana automatycznie z rozszerzeniem ARCore Extensions for AR Foundation SDK)
iOS
Sprzęt
- urządzenia obsługującego ARKit,
- kabel USB do podłączenia urządzenia do komputera,
Oprogramowanie
- Unity 2019.4.3f1 lub nowsza wersja z obsługą kompilacji na iOS;
- AR Foundation 4.1.5 lub nowsze (instalowane automatycznie za pomocą ARCore Extensions for AR Foundation SDK)
- Wtyczka ARKit XR 4.1.5 lub nowsza (instalowana automatycznie z rozszerzeniem ARCore Extensions for AR Foundation SDK)
- Xcode 11.0 lub nowszy
Zainstaluj pakiet rozszerzeń ARCore
Wykonaj te czynności, aby zainstalować rozszerzenia ARCore Extensions for AR Foundation.
Zależności w pakiecie
- Upewnij się, że w środowisku programistycznym masz zainstalowaną i skonfigurowaną aplikację AR Foundation.
- Otwórz lub utwórz nowy projekt w Unity.
- Wybierz odpowiednią docelową platformę kompilacji:
- Z menu File wybierz Build Settings.
- Wybierz Android lub iOS, w zależności od wybranej platformy docelowej.
- Kliknij Switch Platform.
Zaimportuj najnowszy pakiet rozszerzeń ARCore:
- Wejdź na Window > Package Manager.
Kliknij przycisk i wybierz opcję Add package from git URL... z menu.
Wklej ten adres URL w polu tekstowym:
https://github.com/google-ar/arcore-unity-extensions.git
Kliknij Add.
Bez EDM4U
Domyślnie rozszerzenia ARCore są połączone z dodatkowymi zależnościami. Gdy używasz innych bibliotek (np. Firebase Analytics), które są zależne od innej wersji zewnętrznego menedżera zależności dla Unity, może wystąpić niezdefiniowane zachowanie i sposób, w jaki komponenty te przestaną działać prawidłowo.
Zainstaluj rozszerzenia ARCore bez pakietów zależności, aby uniknąć konfliktów wersji w bibliotece:
- Pobierz rozszerzenia ARCore bez wersji EDM4U oraz
com.google.external-dependency-manager
. - Wykonaj instrukcje importowania pakietów UPM z plikami
.tgz
(instalowanie pakietów w takiej kolejności):com.google.external-dependency-manager
,- Rozszerzenia ARCore (bez EDM4U).
Podczas instalacji ARCore Extensions Unity automatycznie instaluje też odpowiednią wersję wymaganych zależności:
- AR Foundation
- ARCore XR Plugin (używany do kierowania na Androida)
- ARKit XR Plugin (używany do kierowania reklam na iOS)
Te zależności mogą nie być widoczne w widoku Package Manager > Package: In project. Pakiety są jednak widoczne w oknie Project pod Packages
Konfigurowanie rozszerzeń ARCore
AR Foundation 4.x
W panelu Hierarchy kliknij prawym przyciskiem myszy i dodaj te obiekty gry (jeśli nie zostały jeszcze dodane):
- XR > AR Session
- XR > AR Session Origin
- XR > ARCore Extensions
W panelu Hierarchy wybierz pakiet ARCore Extensions.
W panelu Inspector w przypadku każdego z tych pól kliknij przycisk celu i połącz poszczególne pola z odpowiednimi obiektami gry w ten sposób:
- Session: użyj AR Session sceny.
- AR Session Origin: użyj AR Session Origin sceny.
- Camera Manager: użyj AR Camera sceny.
Opcjonalnie utwórz i połącz poniższe zasoby na potrzeby zakotwiczonych w chmurze i filtrów konfiguracji aparatu.
W panelu Project > Assets kliknij prawym przyciskiem myszy i wybierz Create > XR > ARCore Extensions Config.
W panelu Project > Assets kliknij prawym przyciskiem myszy i wybierz Create > XR > Camera Config Filter.
W panelu Hierarchy wybierz pakiet ARCore Extensions.
W polu ARCore Extensions Config panelu Inspector kliknij przycisk celu i połącz się z zasobem ARCoreExtensionsConfig.
W polu Camera Config Filter panelu Inspector kliknij przycisk celu i połącz się z zasobem ARCoreExtensionsCameraConfigFilter.
Więcej informacji znajdziesz w przewodniku dla programistów dotyczącym kotwic w chmurze oraz w przewodniku po konfigurowaniu kamery.
Jeśli korzystasz z Unity w wersji starszej niż 2020.3:
- Wybierz Szablon właściwości niestandardowych Gradle w sekcji Ustawienia projektu > Odtwarzacz > Android > Ustawienia publikowania > Kompilacja.
Po prawidłowym połączeniu wszystkich powyższych pól rozszerzeń ARCore panel Inspector rozszerzeń ARCore wygląda tak:
AR Foundation 5.x
W panelu Hierarchy kliknij prawym przyciskiem myszy i dodaj te obiekty gry (jeśli nie zostały jeszcze dodane):
- XR > AR Session
- XR > XR Origin (Mobile AR)
- XR > ARCore Extensions
W panelu Hierarchy wybierz pakiet ARCore Extensions.
W panelu Inspector w przypadku każdego z tych pól kliknij przycisk celu i połącz poszczególne pola z odpowiednimi obiektami gry w ten sposób:
- Session: użyj AR Session sceny.
- XR Origin: użyj XR Origin sceny.
- Camera Manager: użyj AR Camera sceny.
Opcjonalnie utwórz i połącz poniższe zasoby na potrzeby zakotwiczonych w chmurze i filtrów konfiguracji aparatu.
W panelu Project > Assets kliknij prawym przyciskiem myszy i wybierz Create > XR > ARCore Extensions Config.
W panelu Project > Assets kliknij prawym przyciskiem myszy i wybierz Create > XR > Camera Config Filter.
W panelu Hierarchy wybierz pakiet ARCore Extensions.
W polu ARCore Extensions Config panelu Inspector kliknij przycisk celu i połącz się z zasobem ARCoreExtensionsConfig.
W polu Camera Config Filter panelu Inspector kliknij przycisk celu i połącz się z zasobem ARCoreExtensionsCameraConfigFilter.
Więcej informacji znajdziesz w przewodniku dla programistów dotyczącym kotwic w chmurze oraz w przewodniku po konfigurowaniu kamery.
Jeśli korzystasz z Unity w wersji starszej niż 2020.3:
- Wybierz Szablon właściwości niestandardowych Gradle w sekcji Ustawienia projektu > Odtwarzacz > Android > Ustawienia publikowania > Kompilacja.
Po prawidłowym połączeniu wszystkich powyższych pól rozszerzeń ARCore panel Inspector rozszerzeń ARCore wygląda tak:
Więcej informacji o konfigurowaniu właściwości znajdziesz w przewodniku Unity na temat edytowania właściwości.
Przykładowe projekty
W pakiecie z rozszerzeniami ARCore Extensions for AR Foundation możesz korzystać z przykładowych projektów, których możesz użyć do tworzenia własnych projektów.
W menu Window otwórz Package Manager i wybierz pakiet ARCore Extensions.
W sekcji Samples kliknij Import obok przykładowego projektu opisanego poniżej.
Te przykładowe projekty są importowane z repozytorium GitHub:
Dane geoprzestrzenne (tylko na Androidzie) – twórz projekty AR w skali globalnej i zdalnie dołączaj treści do dowolnego obszaru objętego Google Street View. Więcej informacji znajdziesz we wprowadzeniu do interfejsu Geospatial API.
PersistentCloudAnchors (Android i iOS) – pozwala tworzyć trwałe doświadczenia AR w świecie rzeczywistym dzięki interaktywnym warstwom informacji cyfrowych zakotwiczonych w rzeczywistych lokalizacjach oraz w projektach, które mogą być udostępniane w czasie przez wiele osób na różnych urządzeniach. Więcej informacji znajdziesz we wprowadzeniu do kotwic w chmurze.
Co dalej
Dzięki rozszerzeniom ARCore for AR Foundation możesz teraz używać w swoich aplikacjach zakotwiczonych w chmurze i konfiguracji kamery.