Uruchamianie przykładowej aplikacji: iOS — Unity (C#)
W tym przewodniku Szybki start opisano sposób uruchamiania przykładowej aplikacji usługi Azure Spatial Anchors dla urządzeń z systemem iOS przy użyciu aparatu Unity (C#). Azure Spatial Anchors to usługa dla deweloperów programujących dla wielu platform, która pozwala kreować rozwiązania z rzeczywistością mieszaną z użyciem obiektów, których lokalizacja jest taka sama na różnych urządzeniach mimo upływu czasu. Gdy skończysz, będziesz mieć aplikację ARKit dla systemu iOS utworzoną za pomocą aparatu Unity, która może zapisywać i przywoływać kotwicę przestrzenną.
Dowiesz się, jak:
- Tworzenie konta usługi Spatial Anchors
- Przygotowywanie ustawień kompilacji aparatu Unity
- Konfigurowanie identyfikatora i klucza konta usługi Spatial Anchors
- Eksportowanie projektu Xcode
- Wdrażanie i uruchamianie na urządzeniu z systemem iOS
Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure.
Wymagania wstępne
Aby ukończyć ten przewodnik Szybki start, upewnij się, że dysponujesz następującymi elementami:
- Deweloperskie urządzenie z systemem iOS, zgodne z zestawem ARKit.
- Maszyna z systemem macOS z zainstalowaną najnowszą wersją programu Xcode .
- Instalacja aparatu Unity. Aby zapoznać się z obsługiwanymi wersjami i wymaganymi możliwościami, odwiedź stronę konfiguracji projektu aparatu Unity.
- Narzędzie Git zainstalowane za pośrednictwem oprogramowania HomeBrew. Wprowadź następujące polecenie w jednym wierszu terminalu:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)". Następnie uruchom poleceniebrew install gitibrew install git-lfs.
Tworzenie zasobu usługi Spatial Anchors
Przejdź do portalu Azure Portal.
W okienku po lewej stronie wybierz pozycję Utwórz zasób.
Użyj pola wyszukiwania, aby wyszukać usługi Spatial Anchors.
Wybierz pozycję Zakotwiczenia przestrzenne, a następnie wybierz pozycję Utwórz.
W okienku Konto usługi Spatial Anchors wykonaj następujące czynności:
Wprowadź unikatową nazwę zasobu przy użyciu zwykłych znaków alfanumerycznych.
Wybierz subskrypcję, do której chcesz dołączyć zasób.
Utwórz grupę zasobów, wybierając pozycję Utwórz nową. Nadaj jej nazwę myResourceGroup, a następnie wybierz przycisk OK.
Grupa zasobów to logiczny kontener, w którym są wdrażane i zarządzane zasoby platformy Azure, takie jak aplikacje internetowe, bazy danych i konta magazynu. Na przykład można później usunąć całą grupę zasobów w jednym prostym kroku.
Wybierz lokalizację (region), w której ma być umieszczany zasób.
Wybierz pozycję Utwórz , aby rozpocząć tworzenie zasobu.
Po utworzeniu zasobu witryna Azure Portal pokazuje, że wdrożenie zostało ukończone.
Wybierz pozycję Przejdź do zasobu. Teraz możesz wyświetlić właściwości zasobu.
Skopiuj wartość identyfikatora konta zasobu do edytora tekstów do późniejszego użycia.
Skopiuj również wartość domeny konta zasobu do edytora tekstów do późniejszego użycia.
W obszarze Ustawienia wybierz pozycję Klucz dostępu. Skopiuj wartość Klucza podstawowego, Klucz konta, do edytora tekstów do późniejszego użycia.
Pobieranie przykładowego projektu i importowanie zestawu SDK
Klonowanie repozytorium przykładów
Sklonuj repozytorium przykładów, uruchamiając następujące polecenia:
git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples
Importowanie zestawu ASA SDK
Postępuj zgodnie z instrukcjami dostępnymi tutaj , aby pobrać i zaimportować pakiety zestawu SDK usługi ASA wymagane dla platformy iOS.
Konfigurowanie aparatu Unity
W środowisku Unity otwórz projekt w folderze Unity . Aparat Unity może wyświetlić monit o różnicę między wersją projektu a wersją zainstalowaną na maszynie. To ostrzeżenie jest w porządku, o ile wersja edytora aparatu Unity jest nowsza niż ta, z którą projekt został utworzony. Jeśli wersja jest nowsza, wybierz pozycję Kontynuuj. Jeśli wersja jest starsza niż ta, której potrzebuje projekt, wybierz pozycję Zamknij i uaktualnij edytor aparatu Unity.
Otwórz obszar Build Settings (Ustawienia kompilacji), wybierając pozycje File (Plik)>Build Settings (Ustawienia kompilacji).
W sekcji Platform (Platforma) wybierz pozycję iOS.
Wybierz pozycję Switch Platform (Przełącz platformę), aby zmienić platformę na iOS. Aparat Unity może monitować o zainstalowanie składników obsługi systemu iOS, jeśli ich brakuje.
Zamknij okno Build Settings (Ustawienia kompilacji).
Konfigurowanie informacji o koncie
Następnym krokiem jest skonfigurowanie aplikacji do korzystania z informacji o koncie. Wartości Klucz konta, Identyfikator konta i Domena konta skopiowano wcześniej do edytora tekstów w sekcji "Tworzenie zasobu usługi Spatial Anchors".
W okienku Projekt przejdź do strony Assets\AzureSpatialAnchors.SDK\Resources.
Wybierz pozycję SpatialAnchorConfig. W okienku Inspektor wprowadź jako wartość klucz konta usługi Spatial Anchors, Account ID wartość jako wartość identyfikatora konta usługi Spatial Anchors i Account Domain jako wartość domeny konta usługi Spatial Anchors.Account Key
Eksportowanie projektu Xcode
Otwórz obszar Build Settings (Ustawienia kompilacji), wybierając pozycje File (Plik)>Build Settings (Ustawienia kompilacji).
W obszarze Sceny w kompilacji upewnij się, że obok wszystkich scen jest znacznik wyboru.
Wybierz pozycję Kompilacja. W otwartym okienku wybierz folder, do którego chcesz wyeksportować projekt Xcode.
Po zakończeniu eksportowania zostanie wyświetlony folder zawierający wyeksportowany projekt Xcode.
Uwaga
Jeśli zostanie wyświetlone okno z pytaniem, czy chcesz zamienić lub dołączyć, zalecamy wybranie opcji Dołącz, ponieważ jest to szybsze. Zastąp spowoduje usunięcie wszystkich plików z folderu docelowego i wygenerowanie nowej zawartości.
Otwieranie projektu Xcode
Teraz możesz otworzyć Unity-iPhone.xcodeproj projekt w środowisku Xcode.
Możesz uruchomić program Xcode i otworzyć wyeksportowany projekt lub uruchomić projekt w środowisku Xcode, uruchamiając następujące polecenie z lokalizacji, Unity-iPhone.xcodeproj w której wyeksportowano projekt:
open ./Unity-iPhone.xcodeproj
Wybierz główny węzeł Unity-i Telefon, aby wyświetlić ustawienia projektu, a następnie wybierz kartę Ogólne.
W obszarze Informacje o wdrożeniu upewnij się, że element docelowy wdrożenia jest ustawiony na system iOS 11.0.
Wybierz kartę Podpisywanie i możliwości i upewnij się, że opcja Automatyczne zarządzanie podpisywaniem jest włączona. Jeśli tak nie jest, włącz je, a następnie zresetuj ustawienia kompilacji, wybierając pozycję Włącz automatycznie w wyświetlonym okienku.
Wdrażanie aplikacji na urządzeniu z systemem iOS
Połączenie urządzenia z systemem iOS na komputer Mac i ustaw aktywny schemat na urządzenie z systemem iOS.
Wybierz pozycję Build and then run the current scheme (Skompiluj i uruchom bieżący schemat).
W aplikacji wybierz pozycję BasicDemo za pomocą strzałek, a następnie naciśnij przycisk Przejdź! , aby uruchomić pokaz. Postępuj zgodnie z instrukcjami, aby umieścić i odwołać kotwicę.
Po zakończeniu zatrzymaj aplikację, naciskając pozycję Zatrzymaj w środowisku Xcode.
Rozwiązywanie problemów
Problemy z renderowaniem
Jeśli podczas uruchamiania aplikacji nie widzisz aparatu jako tła (np. widzisz puste miejsce, niebieski kolor lub inne tekstury), prawdopodobnie musisz ponownie zaimportować zasoby w aparacie Unity. Zatrzymaj aplikację. W górnym menu w amencie Unity wybierz pozycję Zasoby —> ponownie zaimportuj wszystko. Następnie ponownie uruchom aplikację.
Czyszczenie zasobów
W poprzednich krokach utworzono zasoby platformy Azure w grupie zasobów. Jeśli nie będziesz już potrzebować tych zasobów w przyszłości, możesz je usunąć przez usunięcie grupy zasobów.
W menu witryny Azure Portal lub na stronie głównej wybierz pozycję Grupy zasobów. Następnie na stronie Grupy zasobów wybierz pozycję myResourceGroup.
Na stronie myResourceGroup upewnij się, że wymienione zasoby są tymi, które chcesz usunąć.
Wybierz pozycję Usuń grupę zasobów, wpisz myResourceGroup w polu tekstowym, aby potwierdzić, a następnie wybierz pozycję Usuń.
Następne kroki
W tym przewodniku Szybki start utworzono konto usługi Spatial Anchors. Następnie skonfigurowano i wdrożono aplikację do zapisywania i odwoływania kotwic przestrzennych. Aby dowiedzieć się więcej na temat ulepszania aplikacji w celu udostępniania kotwic przestrzennych innym urządzeniom, przejdź do następnego samouczka.