A mintaalkalmazás futtatása: Android – Unity (C#)
Ez a rövid útmutató bemutatja, hogyan futtatható az Azure Spatial Anchors mintaalkalmazás Android-eszközökhöz a Unity (C#) használatával. Az Azure Spatial Anchors egy platformfüggetlen fejlesztői szolgáltatás, amely lehetővé teszi vegyes valósági élmények létrehozását olyan objektumok használatával, amelyek folyamatosan megőrzik helyüket az eszközökön. Ha végzett, egy Unityvel készült ARCore Android-alkalmazással fog rendelkezni, amely menthet és visszahívhat egy térbeli horgonyt.
A következőket fogja megtanulni:
- Térbeli horgonyfiók létrehozása
- A Unity buildbeállításainak előkészítése
- A Térbeli horgonyok fiókazonosítójának és fiókkulcsának konfigurálása
- Az Android Studio-projekt exportálása
- Üzembe helyezés és futtatás Android-eszközön
Ha nem rendelkezik Azure-előfizetéssel, első lépésként hozzon létre egy ingyenes Azure-fiókot.
Előfeltételek
A rövid útmutató elvégzéséhez győződjön meg arról, hogy rendelkezik az alábbiakkal:
- Egy fejlesztő által engedélyezett és ARCore-kompatibilis Android-eszköz.
- Előfordulhat, hogy további eszközillesztőkre van szükség ahhoz, hogy a számítógép kommunikáljon az Android-eszközével. További információkért és utasításokért lásd itt.
- Windows vagy macOS rendszerű gép.
- Ha Windows rendszeren fut, akkor a Windowshoz és a Git LFS-hez is szüksége lesz a Gitre.
- Ha macOS rendszeren fut, telepítse a Gitet a HomeBrew használatával. Adja meg a következő parancsot a terminál egyetlen sorába:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)". Ezután futtassabrew install gitésbrew install git-lfs.
- Unity-telepítés, beleértve az Android buildtámogatást az Android SDK > NDK Tools és OpenJDK modulokkal. A támogatott verziókért és a szükséges képességekért látogasson el a Unity projekt beállítási oldalára.
Térbeli horgonyerőforrás létrehozása
Nyissa meg az Azure Portalt.
A bal oldali panelen válassza az Erőforrás létrehozása lehetőséget.
A keresőmezővel keresse meg a térbeli horgonyokat.
Válassza a Térbeli horgonyok, majd a Létrehozás lehetőséget.
A Térbeli horgonyok fiók panelen tegye a következőket:
Adjon meg egy egyedi erőforrásnevet normál alfanumerikus karakterek használatával.
Válassza ki azt az előfizetést, amelyhez csatolni szeretné az erőforrást.
Hozzon létre egy erőforráscsoportot az Új létrehozása gombra kattintva. Nevezze el a myResourceGroup nevet, majd kattintson az OK gombra.
Az erőforráscsoport egy logikai tároló, amelybe az Azure-erőforrásokat, például webalkalmazásokat, adatbázisokat és tárfiókokat helyezik üzembe és felügyelik. Dönthet úgy is például, hogy később egyetlen egyszerű lépésben törli a teljes erőforráscsoportot.
Válassza ki azt a helyet (régiót), ahol az erőforrást el szeretné helyezni.
Válassza a Létrehozás lehetőséget az erőforrás létrehozásának megkezdéséhez.
Az erőforrás létrehozása után az Azure Portalon látható, hogy az üzembe helyezés befejeződött.
Válassza az Erőforrás megnyitása lehetőséget. Most már megtekintheti az erőforrás tulajdonságait.
Másolja az erőforrás Fiókazonosító értékét egy szövegszerkesztőbe későbbi használatra.
Az erőforrás Fióktartomány értékét is másolja egy szövegszerkesztőbe későbbi használatra.
A Beállítások területen válassza az Access-kulcsot. Másolja az elsődleges kulcs értékét ( Fiókkulcs) egy szövegszerkesztőbe későbbi használatra.
Mintaprojekt letöltése és SDK importálása
Minták klónozása adattár
Klónozza a mintaadattárat az alábbi parancsok futtatásával:
git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples
ASA SDK importálása
Kövesse az itt található utasításokat az Android-platformhoz szükséges ASA SDK-csomagok letöltéséhez és importálásához.
A Unity konfigurálása
A Unityben nyissa meg a projektet a Unity mappában. Előfordulhat, hogy a Unity megkérdezi, hogy mi a különbség a projekt verziója és a számítógépre telepített verzió között. Ez a figyelmeztetés rendben van, ha a Unity Editor verziója újabb, mint az, amellyel a projektet létrehozták. Ha a verzió újabb, válassza a Folytatás lehetőséget. Ha a verzió régebbi, mint amire a projektnek szüksége van, válassza a Kilépés lehetőséget, és frissítse a Unity-szerkesztőt.
Nyissa meg a Buildbeállításokat a Fájl>összeállítási beállításai lehetőség kiválasztásával.
A Platform szakaszban válassza az Android lehetőséget, majd a Platformváltás lehetőséget a platform Androidra való módosításához. A Unity megkérheti, hogy telepítse az Android támogatási összetevőit, ha hiányoznak.
Zárja be a Build Settings ablakot.
A fiókadatok konfigurálása
A következő lépés az alkalmazás konfigurálása a fiókadatok használatára. A fiókkulcs, a fiókazonosító és a fióktartomány értékeit korábban egy szövegszerkesztőbe másolta a "Térbeli horgonyerőforrás létrehozása" szakaszban.
A Projekt panelen nyissa meg a következőtAssets\AzureSpatialAnchors.SDK\Resources:
Válassza a SpatialAnchorConfig lehetőséget. A Felügyelő panelen adja meg a Account Key Térbeli horgonyok fiókkulcs értékét, a Account ID Térbeli horgonyok fiókazonosító értékét, Account Domain a Térbeli horgonyok fióktartomány értékét.
Az Android Studio-projekt exportálása
Nyissa meg a Buildbeállításokat a Fájl>összeállítási beállításai lehetőség kiválasztásával.
A Buildben lévő jelenetek területen győződjön meg arról, hogy az összes jelenet mellett pipa látható.
Válassza ki az eszközt a Futtató eszközön , majd válassza a Build and Run (Build and Run) lehetőséget. A rendszer megkéri, hogy mentsen egy .apk fájlt, amelynek tetszőleges nevet választhat.
Az alkalmazásban válassza a BasicDemo lehetőséget a nyilakkal, majd nyomja le a Go! gombot a bemutató futtatásához. Kövesse az utasításokat a horgony elhelyezéséhez és visszahívásához.
Kövesse az alkalmazás utasításait egy horgony elhelyezéséhez és visszahívásához.
Hibaelhárítás
Megjelenítési problémák
Az alkalmazás futtatásakor, ha nem látja a kamerát háttérként (például üres, kék vagy egyéb textúrát lát), akkor valószínűleg újra kell importálnia az objektumokat a Unityben. Állítsa le az alkalmazást. A Unity felső menüjében válassza az Eszközök –> Az összes újraimportálása lehetőséget. Ezután futtassa újra az alkalmazást.
Az erőforrások eltávolítása
Az előző lépésekben Azure-erőforrásokat hozott létre egy erőforráscsoportban. Ha várhatóan nincs szüksége ezekre az erőforrásokra a későbbiekben, az erőforráscsoport eltávolításával törölheti őket.
Az Azure Portal menüjében vagy kezdőlapján válassza az Erőforráscsoportok lehetőséget. Ezután az Erőforráscsoportok lapon válassza a myResourceGroup lehetőséget.
A myResourceGroup lapon győződjön meg arról, hogy a felsorolt erőforrásokat törölni szeretné.
Válassza az Erőforráscsoport törlése lehetőséget, írja be a myResourceGroup kifejezést a szövegmezőbe a megerősítéshez, majd válassza a Törlés lehetőséget.
Következő lépések
Ebben a rövid útmutatóban létrehozott egy Térbeli horgonyfiókot. Ezután konfigurált és üzembe helyezett egy alkalmazást a térbeli horgonyok mentéséhez és visszahívásához. Ha többet szeretne megtudni arról, hogyan fejlesztheti az alkalmazást, hogy más eszközökkel is megosztható legyen a térbeli horgonyok, folytassa a következő oktatóanyaggal.