- Konfigurowanie środowiska programistycznego interfejsu API głębi
- Wypróbuj przesłanianie i wizualizuj mapę głębi w przykładowej aplikacji
Wymagania wstępne
- Android Studio w wersji 3.1 lub nowszej z Android SDK Platform w wersji 7.0 (poziom interfejsu API 24) lub nowszym.
- Urządzenie z Androidem, które obsługuje głębię. Szczegóły znajdziesz na liście obsługiwanych urządzeń.
- Podstawowe informacje o programowaniu Androida. Jeśli dopiero zaczynasz korzystać z Androida, przeczytaj artykuł Tworzenie pierwszej aplikacji na Androida dla początkujących.
- Podstawowe informacje o interfejsie Depth API. Jeśli dopiero zaczynasz korzystać z funkcji głębi, przeczytaj omówienie tego interfejsu.
Otwieranie przykładowego projektu
W tym krótkim wprowadzeniu wykorzystano interfejs programowy OpenGL do renderowania grafiki wektorowej 2D i 3D. Zanim zaczniesz wykonywać te czynności, zapoznaj się z artykułem Włączanie ARCore.
Pobierz przykładowy projekt, kopiując repozytorium za pomocą tego polecenia:
git clone https://github.com/google-ar/arcore-android-sdk.git
W Android Studio otwórz przykładowy projekt hello_ar_java znajdujący się w podkatalogu samples w katalogu arcore-android-sdk.
Uruchamianie przykładu
Przykładowa aplikacja interfejsu Depth API umożliwia umieszczanie wirtualnych modeli Androida w Twoim środowisku i przełączanie przesłonięcia, by zobaczyć różnicę. Możesz w nim też włączyć wizualizację mapy głębi.
Upewnij się, że Twoje urządzenie z Androidem jest połączone z urządzeniem dla deweloperów, i kliknij Run 
w Android Studio.
W razie potrzeby możesz zainstalować lub zaktualizować Usługi Google Play dla AR. Kliknij CONTINUE, aby zainstalować aplikację ze Sklepu Google Play.
Włącz głębię
Przy pierwszym uruchomieniu aplikacji i umieszczeniu danych na urządzeniu z Androidem pojawi się okno z prośbą o włączenie głębi. Jest widoczna tylko przy pierwszym uruchomieniu aplikacji i w pierwszym umieszczonym Androidzie. Kliknij Enable, aby dodać przesłanianie.
Przełączanie przesłaniania i wizualizacja mapy głębi
Kliknij ikonę koła zębatego, aby przełączyć przesłanianie i wizualizację mapy głębi. Aby włączyć przesłanianie, wybierz Enable depth. Wybierz Show depth map, aby wyświetlić wizualizację mapy głębi na urządzeniu.
Na przykład te obrazy przedstawiają wirtualną postać Androida na zewnątrz, która zawiera bagaż pod drzwiami. Na pierwszym obrazie wirtualny Android niebezpiecznie pokrywa się z krawędzią połączenia. Na drugim zdjęciu widać, że Android jest prawidłowo zasłaniany, przez co otaczający go obszar jest bardziej realistyczny.
Poniższe obrazy przedstawiają aparat w holu z rowerem na ścianie oraz wizualizację mapy głębi utworzonej na potrzeby tego aparatu.
Dalsze kroki
Zacznij korzystać z interfejsu Depth API w swoich aplikacjach. Więcej informacji: