Pakiet SDK XR na Androida jest teraz dostępny w wersji dla programistów. Chcemy poznać Twoją opinię. Aby się z nami skontaktować, odwiedź naszą stronę pomocy.
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Począwszy od wersji alpha04 bibliotek Jetpack XR wprowadzono ważne zmiany dotyczące sposobu udostępniania zasobów środowiska przestrzennego, które mają na celu zapewnienie optymalnej wydajności i jakości wizualnej. Te zmiany mają wpływ na zgodność i wymagają zaktualizowania dotychczasowych aplikacji, które ustawiają środowisko przestrzenne.
Aby zapewnić środowisko przestrzenne, potrzebujesz 2 głównych komponentów:
Plik .glb lub .gltf zawierający geometrię środowiska (np. grunt, poziomy teren, pobliskie obiekty) oraz główną teksturę nieba, którą widzą użytkownicy.
oddzielny plik ZIP zawierający informacje o oświetleniu opartym na obrazie (IBL) wygenerowane z obrazu EXR o wysokim zakresie dynamicznym za pomocą narzędzia cmgen; Plik ZIP służy do obliczeń oświetlenia, takich jak odbicia na obiektach, a nie do samej tekstury nieba.
Dlaczego to podejście?
Ta zaktualizowana struktura komponentów daje następujące korzyści:
Mniejsze rozmiary plików: w porównaniu z poprzednimi metodami, takimi jak używanie pojedynczego pliku obrazu nieba w wysokiej rozdzielczości HDR do wyświetlania wizualnego i informacji o oświetleniu, to podejście zmniejsza rozmiary plików.
Zwiększona wydajność: oddzielenie wizualnej tekstury nieba (wbudowanej w plik glb) od danych IBL (w pliku ZIP) umożliwia optymalizację każdego komponentu z osobna. Przekłada się to na mniejszą przepustowość pamięci tekstur i mniejsze zużycie energii.
Zoptymalizowane oświetlenie: korzystanie z zasosobu nieba w niższej rozdzielczości, który służy do mapy oświetlenia, korzystnie wpływa na wydajność, nie wpływając znacząco na jakość oświetlenia obiektów.
Plik glb reprezentuje geometrię wokół użytkownika i zawiera wizualną teksturę nieba. W przypadku geometrii należy dążyć do tego, aby rozmiary plików nie przekraczały 80 MB.
Aby to osiągnąć, możesz zwiększyć wydajność środowiska przy jednoczesnym zachowaniu wysokiej jakości. Na przykład gęstość siatki powinna być największa w pobliżu użytkownika, a gęstość siatek, które są dalej od użytkownika, możesz zmniejszyć.
Odległość widoczności: odległość widoczności dla środowisk w Android XR wynosi 200 m od punktu użytkownika, a tekstura nieba powinna być zgodna z tym ograniczeniem. Zapewnia to optymalne wrażenia, ponieważ paralaksa staje się nierozróżnialna z tej odległości.
Wzrost użytkownika: geografia może się różnić, ale umieść użytkownika na wzniesieniu o wysokości około 1,5 metra, aby uniknąć przycięcia większych elementów interfejsu w aplikacjach.
Liczba wielokątów: zwróć uwagę na liczbę wielokątów w plikach glb, ponieważ duża liczba wielokątów może spowodować niepotrzebne zużycie energii. Każdy fragment geometrii nie może zawierać więcej niż 10 tys. wierzchołków.
Kompresja KTX: zoptymalizuj wydajność GPU pliku glb, upewniając się, że używa on map MIP i tekstur KTX2.
Znajdź plik .tgz zawierający wstępnie skompilowaną wersję cmgen dla Twojej platformy i go wyodrębnij.
Wstępnie utworzone narzędzie znajduje się w katalogu /bin wyodrębnionego pliku .tgz.
Zasoby, które należy przygotować, aby wygenerować plik .zip dla IBL:
plik EXR o niskiej rozdzielczości, który pasuje do tekstury nieba.
Tekstura nieba powinna być plikiem EXR. Chociaż cmgen obsługuje inne formaty, zalecamy używanie plików EXR, ponieważ zawierają one informacje o dużym zakresie dynamicznym, które są niezbędne do zapewnienia wysokiej jakości IBL.
Korzystanie z innych formatów, takich jak PNG, powoduje mniej precyzyjne oświetlenie.
Obraz źródłowy (EXR) musi mieć format 2:1 i wymiary będące wielokrotnością 2. Użyj pliku EXR o wymiarach 1024 × 512 pikseli. Uwaga: może się wydawać, że rozdzielczość 1024 x 512 jest zbyt niska, ale ma to pozytywny wpływ na wydajność. W przypadku IBL wizualne wyniki dla użytkownika są bardzo podobne do zasobów o znacznie wyższej rozdzielczości IBL.
czarny obraz w formacie png,
Ten zasób musi mieć też proporcje 2:1. Użyj rozmiaru 100 x 50 pikseli.
Jest to zoptymalizowana tekstura towarzysząca IBL. Użytkownicy nie będą tego widzieć, więc skupiamy się na optymalizacji komponentu pod kątem skuteczności.
Poniżej przedstawiamy przykład użycia narzędzia cmgen do utworzenia pliku ZIP dla IBL.
W tym przykładzie używamy plików wejściowych o nazwach my_360_skybox_1024_x_512.exr i black_skybox.png oraz tworzymy plik ZIP o nazwie my_ibl .zip.
# Produce black cubemaps for the texture of the IBL asset.
./cmgen--format=rgb32f--size=128--extract=./skybox_ibl./black_skybox.png
# Produce lighting cubemaps and a Spherical Harmonics from EXR
./cmgen--format=rgb32f--size=128--deploy=./skybox_ibl--ibl-ld=.--ibl-samples=1024--extract-blur=0.0--sh-irradiance--sh-shader--sh-output=./skybox_ibl/sh.txt./my_360_skybox_1024_x_512.exr
# Copy all of the black cubemaps into the other folder.
cp-rf./skybox_ibl/black_skybox/*./skybox_ibl/my_360_skybox_1024_x_512
# Rename the directory to reflect that these are old assets.
mv./skybox_ibl/black_skybox./skybox_ibl/black_skybox_old
# Rename the directory to reflect that these are your cubemap assets.
mv./skybox_ibl/my_360_skybox_1024_x_512./skybox_ibl/black_skybox
# Change into the child directory.cd./skybox_ibl
# Zip all of the cubemap and the Spherical Harmonics assets together.
zip-qmy_ibl.zipblack_skybox/*
# Return to the directory you started in.cd..
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-27 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-07-27 UTC."],[],[],null,["# Optimize environment assets\n\nBeginning with the alpha04 release of the Jetpack XR libraries, there are\nimportant updates to how you should provide spatial environment assets for\noptimal performance and visual quality. These changes are a compatibility impact\nand require updating existing apps that set spatial environments.\n\nTo provide spatial environments, you need two main components:\n\n- A .glb or .gltf file for the environment's geometry (for example, the ground plane, nearby objects) and the primary visual skybox texture that users see.\n- A separate ZIP file containing Image Based Lighting (IBL) information generated from a high dynamic range EXR image using the cmgen tool. The ZIP file is used for lighting calculations, such as reflections on objects, and not for the visual skybox texture itself.\n\nWhy this approach?\n------------------\n\nThis updated asset structure provides these advantages:\n\n- **Smaller file sizes:** Compared to previous methods, such as using a single high-resolution HDR skybox file for both visual display and lighting information, this approach reduces file sizes.\n- **Improved performance:** Separating the visual skybox texture (built into the glb) from the IBL data (in the ZIP file) lets you optimize each component independently. This results in lower texture memory read bandwidth and lower power consumption.\n- **Optimized lighting:** Using a lower resolution skybox resource specifically for the lighting map is beneficial for performance without significantly impacting the visual results of the lighting on objects.\n\nTo learn more about adding a spatial Environment in your app, see our guide on\n[adding environments to your app](/develop/xr/jetpack-xr-sdk/add-environment).\n| **Note:** It's important to provide an IBL asset if your app sets a custom environment, especially if your app has any 3D objects. This is because, if your app provides a glb/glTF but no IBL ZIP file, the 3D objects in the user's environment appear with incorrect lighting (for example, too bright or dim, reflecting objects that the user can't otherwise see).\n\nOptimize your glb\n-----------------\n\nYour glb represents the geometry around the user, and you include the visual\ntexture of your skybox. For your geometry, you should try to maintain file sizes\nat or smaller than 80MB.\n\nTo do this, there are a number of opportunities to make your environment more\nefficient while maintaining high quality. For example, the density of your mesh\nshould be the most dense near the user, and you can decrease the density for\nmeshes that are farther from the user.\n\n- **View distance:** The view distance for environments in Android XR is 200m from the point of the user, and your skybox texture should adhere to this constraint. This provides an optimal experience because parallax becomes indiscernible at that distance.\n- **User height:** Geography can vary, but position the user on a mound at\n around 1.5 meters of height to avoid clipping with larger UI elements in\n apps.\n\n- **Polycount:** Be sensitive to the polycount in your glb files, as a high\n polycount can lead to unnecessary power consumption. Each patch of geometry\n shouldn't exceed 10,000 vertices.\n\n- **KTX compression:** Optimize the GPU performance of your glb file by\n ensuring that your glb uses mipmaps and ktx2 textures.\n\nWhat you'll need to optimize your IBL\n-------------------------------------\n\nDownload the cmgen command line utility:\n\n- You can find the latest release in [the Filament repository](https://github.com/google/filament/releases/).\n- Find the .tgz containing the prebuilt version of cmgen for your platform and extract it.\n- The prebuilt tool is under the /bin directory of the extracted .tgz file.\n\nAssets to prepare to generate the .zip file for IBL:\n\n- A low-resolution EXR that matches your skybox texture\n - Your skybox texture input should be an EXR file. Although cmgen supports other formats, EXRs are recommended because they provide the high dynamic range information that's critical to provide high quality IBL. Using other formats like PNG results in less precise lighting.\n - The source image (EXR) needs to have a 2:1 ratio and dimensions that are a power of 2. Use an EXR that's 1024 x 512 pixels. Note: It may seem that 1024 x 512 is too low of a resolution, but this is beneficial for performance. For IBL, the visual results for the user are very similar to much higher IBL resolution assets.\n- A solid black png\n - This asset must also be a 2:1 ratio. Use a size of 100 x 50 pixels.\n - This serves as an optimized texture to accompany the IBL. Users won't look at this, so we focus the asset on optimizing for performance.\n\nThe following shows an example of using cmgen to create the .zip file for IBL.\nIn this example we use input files named my_360_skybox_1024_x_512.exr and\nblack_skybox.png, and we create a .zip file named my_ibl.zip \n\n # Produce black cubemaps for the texture of the IBL asset.\n ./cmgen --format=rgb32f --size=128 --extract=./skybox_ibl ./black_skybox.png\n\n # Produce lighting cubemaps and a Spherical Harmonics from EXR\n ./cmgen --format=rgb32f --size=128 --deploy=./skybox_ibl --ibl-ld=. --ibl-samples=1024 --extract-blur=0.0 --sh-irradiance --sh-shader --sh-output=./skybox_ibl/sh.txt ./my_360_skybox_1024_x_512.exr\n\n # Copy all of the black cubemaps into the other folder.\n cp -rf ./skybox_ibl/black_skybox/* ./skybox_ibl/my_360_skybox_1024_x_512\n\n # Rename the directory to reflect that these are old assets.\n mv ./skybox_ibl/black_skybox ./skybox_ibl/black_skybox_old\n\n # Rename the directory to reflect that these are your cubemap assets.\n mv ./skybox_ibl/my_360_skybox_1024_x_512 ./skybox_ibl/black_skybox\n\n # Change into the child directory.\n cd ./skybox_ibl\n\n # Zip all of the cubemap and the Spherical Harmonics assets together.\n zip -q my_ibl.zip black_skybox/*\n\n # Return to the directory you started in.\n cd .."]]
