Google jest zaangażowany w promowanie równości rasowej dla społeczności czarnych. Zobacz jak.
Ta strona została przetłumaczona przez Cloud Translation API.
Switch to English

Korzystanie z natychmiastowego podglądu

Użyj funkcji Instant Preview, aby pominąć proces kompilacji i natychmiast przetestować aplikacje ARCore na telefonie. Kliknij opcję Graj w Unity, aby wyświetlić podgląd aplikacji przy użyciu rzeczywistych danych wejściowych i wyjściowych z telefonu.

Przegląd

Instant Preview składa się z aplikacji na Androida dla Twojego telefonu obsługującego ARCore oraz wtyczki dla Unity.

Ograniczenia

Podgląd natychmiastowy ma następujące ograniczenia:

Zdarzenia wstrzymania / wznowienia aktywności nie są obsługiwane
Zdarzenia wstrzymujące aktywność w aplikacji, które wstrzymują i wznawiają sesję ARCore, nie są obsługiwane w przypadku korzystania z natychmiastowego podglądu.

Zmiany konfiguracji sesji ARCore nie są obsługiwane
Zmiany konfiguracji sesji, takie jak wyłączenie szacowania oświetlenia i znajdowania płaszczyzny, nie są obsługiwane w przypadku korzystania z funkcji Instant Preview.

Ograniczona obsługa wprowadzania dotykowego
InstantPreviewInput nie obsługuje:

  • Zdarzenia systemowe zdarzeń interfejsu użytkownika Unity: Użyj myszy lub klawiatury do interakcji z tymi elementami bezpośrednio w edytorze Unity.

Ustawienia orientacji ekranu
Natychmiastowy podgląd określa, której orientacji użyć na podstawie współczynnika proporcji okna podglądu. Jeśli współczynnik proporcji zostanie zmieniony, natychmiastowy podgląd zostanie uruchomiony ponownie, aby odpowiednio dopasować orientację.

Wymagania

Instant Preview jest obsługiwany w systemie Windows (tylko oddzielne procesory graficzne) i komputerach programistycznych z systemem macOS .
Na komputerach z systemem Windows ze zintegrowanym procesorem graficznym źródło wideo Unity Editor nie jest odzwierciedlane z powrotem na telefonie.

Aby korzystać z natychmiastowego podglądu, będziesz potrzebować:

Sprzęt komputerowy

  • Telefon obsługujący ARCore

  • Kabel USB do podłączenia telefonu do maszyny deweloperskiej

Oprogramowanie

Zobacz przewodnik szybkiego startu ARCore SDK dla Unity, aby uzyskać szczegółowe informacje dotyczące wymagań dotyczących wersji oprogramowania i instalacji.

Użyj natychmiastowego podglądu w Unity

Ten przewodnik zakłada, że ​​masz już utworzony projekt ARCore w Unity. Jeśli dopiero zaczynasz pracę z ARCore, zapoznaj się z przewodnikiem szybkiego startu ARCore SDK dla Unity , aby zapoznać się z krokami instalacji i konfiguracji.

Skonfiguruj natychmiastowy podgląd

  1. Otwórz swoją scenę ARCore w edytorze Unity.

  2. Podłącz telefon do maszyny deweloperskiej przez USB. Upewnij się, że opcje programisty i debugowanie są włączone w telefonie.

  3. Kliknij opcję Odtwórz w edytorze Unity. Zostanie uruchomiona aplikacja Instant Preview, a Twoja scena ARCore rozpocznie przesyłanie strumieniowe.

    • Jeśli na komputerze lub telefonie pojawi się okno dialogowe z pytaniem, czy chcesz zainstalować aplikację Instant Preview na Androida, kliknij lub dotknij OK, aby potwierdzić.

    • Jeśli nie masz wystarczająco aktualnej wersji Usług Google Play dla AR zainstalowanej w telefonie, możesz zostać wysłany do Sklepu Google Play w celu pobrania i zainstalowania przed kontynuowaniem.

  4. Poruszaj telefonem, aby wykrywać samoloty, umieszczać obiekty lub używać innych funkcji ARCore, które testujesz w swojej aplikacji.

    Aby uzyskać szczegółowe informacje na temat podglądu wprowadzania dotykowego w podglądzie błyskawicznym, zobacz Obsługa wprowadzania danych z telefonu .

  5. Kliknij Wstrzymaj w edytorze Unity lub dotknij przycisku systemowego Wstecz na telefonie, aby zatrzymać przesyłanie strumieniowe i wyjść z podglądu.

  6. (Opcjonalnie) Możesz zmienić konfigurację przesyłania strumieniowego na Wi-Fi, gdy aplikacja jest wstrzymana.

Obsługuj dane wejściowe z telefonu

W Instant Preview, dotykowe wejście na scenie AR Twojej aplikacji nie przenosi automatycznie zdarzeń wejściowych do Twojej implementacji Unity.

Aby skonfigurować propagację wprowadzania dotykowego, użyj klasy InstantPreviewInput w dowolnym skrypcie kontrolera, który odwołuje się do klasy Unity Input . Dodaj następujący kod na początku skryptu kontrolera:

#if UNITY_EDITOR
     // NOTE:
     // - InstantPreviewInput does not support `deltaPosition`.
     // - InstantPreviewInput does not support input from
     //   multiple simultaneous screen touches.
     // - InstantPreviewInput might miss frames. A steady stream
     //   of touch events across frames while holding your finger
     //   on the screen is not guaranteed.
     // - InstantPreviewInput does not generate Unity UI event system
     //   events from device touches. Use mouse/keyboard in the editor
     //   instead.
     using Input = InstantPreviewInput;
#endif

Na przykład skrypt kontrolera HelloAR sceny demonstracyjnej używa funkcji InstantPreviewInput do wykrywania i propagowania zdarzeń wprowadzania dotykowego.

Klasa InstantPreviewInput jest podobna do klasy Input w Unity .

Przesyłaj strumieniowo przez połączenie Wi-Fi

Natychmiastowy podgląd działa w ten sam sposób podczas przesyłania strumieniowego przez USB lub Wi-Fi.

Domyślnie Instant Preview korzysta z USB. Przesyłanie strumieniowe przez USB jest najlepsze w przypadku dłuższych sesji programistycznych.

Użyj Wi-Fi do krótszych sesji testowych lub gdy kabel USB ograniczy ruch telefonu, którego potrzebujesz.

Aby przesyłać strumieniowo przez Wi-Fi:

  1. Upewnij się, że telefon i komputer deweloperski są podłączone do tej samej sieci Wi-Fi.

  2. Upewnij się, że Twoja sieć jest skonfigurowana do natychmiastowego podglądu:

    • Każde oprogramowanie zapory w systemie deweloperskim musi być skonfigurowane tak, aby umożliwić Unity akceptowanie połączeń TCP na porcie 49838 .
    • Router i / lub zapora sieciowa muszą wyłączać izolację klientów , aby telefon i maszyna deweloperska mogły komunikować się bezpośrednio ze sobą w sieci.
    • Router i / lub zapora sieciowa muszą zezwalać na ruch rozgłoszeniowy z komputera deweloperskiego na adres multiemisji 239.170.165.207 na porcie 49838 .
  3. Upewnij się, że jest włączony podgląd natychmiastowy. W Unity sprawdź, czy opcja Instant Preview Enabled jest zaznaczona w Edycja> Ustawienia projektu> ARCore .

  4. Kliknij opcję Odtwórz w edytorze Unity. Dzięki temu Twoja maszyna programistyczna jest wykrywalna w aplikacji Instant Preview na telefonie.

  5. W telefonie otwórz aplikację ARCore Instant Preview . Postępuj zgodnie z instrukcjami konfiguracji natychmiastowego podglądu, aby zainstalować tę aplikację, jeśli nie jest obecnie zainstalowana.

  6. Na telefonie kliknij menu „Wyświetl podgląd przez…” w aplikacji.

    • Twój komputer programistyczny powinien być wymieniony jako jedno z dostępnych urządzeń pod nazwą sieci Wi-Fi, z której korzysta Twój telefon. Zobacz Rozwiązywanie problemów, jeśli Twojego telefonu nie ma na liście.
    • Wybierz swój komputer deweloperski, aby rozpocząć przesyłanie strumieniowe.
    • Użyj funkcji Play and Stop w edytorze Unity, aby rozpocząć i zatrzymać transmisję strumieniową.

Wyłącz podgląd natychmiastowy

Podgląd natychmiastowy jest domyślnie włączony. Aby wyłączyć natychmiastowy podgląd w edytorze Unity, przejdź do
Edycja > Ustawienia projektu > ARCore i odznacz Natychmiastowy podgląd włączony .

Wskazówki dotyczące wydajności

Współczynnik proporcji
Natychmiastowy podgląd odzwierciedla okno gry w telefonie. Ustaw współczynnik proporcji okna, aby pasował do telefonu, którego używasz do testowania. Jeśli współczynnik proporcji nie pasuje, Twoja aplikacja może wyglądać na rozciągniętą w oknie gry lub na telefonie.

Użyj Metal w macOS
Jeśli pracujesz w systemie macOS, użyj opcji Metal do renderowania zamiast OpenGL. Wybierz kolejno opcje Ustawienia odtwarzacza> Ustawienia samodzielnego komputera PC, Mac i Linux> Inne ustawienia> Obsługa edytora metalu, aby włączyć renderowanie metalu.

Rozwiązywanie problemów

  • Sprawdź, czy w Konsoli Unity nie ma błędów Instant Preview.

Dodatkowo upewnij się, że:

  • Inna instancja Unity korzystająca z Instant Preview nie jest uruchomiona. W tym samym czasie może działać tylko jedna instancja.

  • W Twoim projekcie włączony jest natychmiastowy podgląd. Upewnij się, że opcja Instant Preview Enabled jest zaznaczona w Edytuj > Ustawienia projektu > ARCore .

  • Telefon jest podłączony do komputera przez USB lub Wi-Fi.

  • Twój telefon jest odblokowany, z włączonymi opcjami programisty i debugowaniem .

  • W ustawieniach kompilacji Unity platforma kompilacji jest ustawiona na Androida i masz włączone ustawienia odtwarzacza dla ARCore. Jeśli nie, zapoznaj się z przewodnikiem Szybki start dotyczący aparatu Unity, aby uzyskać szczegółowe informacje na temat konfiguracji.

  • Po kliknięciu przycisku Odtwórz w Unity konsola wyświetla wersję Instant Preview < numer_wersji > .

Jeśli przesyłasz strumieniowo przez Wi-Fi:

  • Sprawdź ustawienia sieci i zapory.

  • Na komputerach programistycznych z systemem Windows :

    1. Otwórz zaporę systemu Windows z panelem zarządzania zaawansowanymi zabezpieczeniami i usuń wszelkie odniesienia do Unity w regułach przychodzących lub wychodzących .

    2. Uruchom ponownie Unity i zezwól na połączenia po wyświetleniu monitu przez system Windows.

  • Jeśli nie masz odpowiedniej sieci Wi-Fi, możesz użyć telefonu jako hotspotu:

    1. W telefonie wyłącz dane mobilne, aby maszyna deweloperska nie korzystała z danych mobilnych przez hotspot.

    2. Skonfiguruj i włącz bezpieczny punkt dostępu Wi-Fi w telefonie.

    3. Na komputerze deweloperskim połącz się z hotspotem Wi-Fi w telefonie.

      Nawet bez połączenia z Internetem komputer deweloperski i telefon powinny być w stanie ustanowić połączenie z funkcją Instant Preview.