Le SDK Android XR est désormais disponible en version Preview développeur. Votre avis nous intéresse. Pour nous contacter, consultez notre page d'assistance.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
À partir de la version alpha04 des bibliothèques Jetpack XR, des modifications importantes ont été apportées à la façon dont vous devez fournir des éléments d'environnement spatial pour des performances et une qualité visuelle optimales. Ces modifications ont un impact sur la compatibilité et nécessitent la mise à jour des applications existantes qui définissent des environnements spatiaux.
Pour fournir des environnements spatiaux, vous avez besoin de deux composants principaux:
Un fichier .glb ou .gltf pour la géométrie de l'environnement (par exemple, le plan d'un sol, les objets à proximité) et la texture de skybox visuelle principale que les utilisateurs voient.
Fichier ZIP distinct contenant des informations sur l'éclairage basé sur l'image (IBL, Image Based Lighting) générées à partir d'une image EXR haute dynamique à l'aide de l'outil cmgen. Le fichier ZIP est utilisé pour les calculs d'éclairage, tels que les reflets sur les objets, et non pour la texture visuelle de la skybox elle-même.
Pourquoi cette approche ?
Cette nouvelle structure d'assets présente les avantages suivants:
Tailles de fichier plus petites:par rapport aux méthodes précédentes, telles que l'utilisation d'un seul fichier de ciel HDR haute résolution pour l'affichage visuel et les informations d'éclairage, cette approche réduit les tailles de fichier.
Amélioration des performances:en séparant la texture de la skybox visuelle (intégrée au glb) des données IBL (dans le fichier ZIP), vous pouvez optimiser chaque composant indépendamment. Cela réduit la bande passante de lecture de la mémoire de texture et la consommation d'énergie.
Éclairage optimisé:l'utilisation d'une ressource de skybox de résolution inférieure spécifiquement pour la carte d'éclairage est bénéfique pour les performances sans avoir d'impact significatif sur les résultats visuels de l'éclairage sur les objets.
Votre fichier glb représente la géométrie autour de l'utilisateur et vous incluez la texture visuelle de votre skybox. Pour votre géométrie, essayez de maintenir la taille des fichiers à 80 Mo ou moins.
Pour ce faire, vous pouvez optimiser votre environnement tout en conservant une qualité élevée. Par exemple, la densité de votre maillage doit être la plus dense à proximité de l'utilisateur, et vous pouvez réduire la densité pour les maillages plus éloignés de l'utilisateur.
Distance de vue:la distance de vue des environnements dans Android XR est de 200 m du point de vue de l'utilisateur. Votre texture de ciel doit respecter cette contrainte. Cela offre une expérience optimale, car la parallaxe devient indiscernable à cette distance.
Hauteur de l'utilisateur:la géographie peut varier, mais placez l'utilisateur sur une butte d'environ 1,5 mètre de haut pour éviter que les éléments d'interface utilisateur plus grands ne soient tronqués dans les applications.
Nombre de polygones:soyez attentif au nombre de polygones dans vos fichiers glb, car un nombre élevé peut entraîner une consommation d'énergie inutile. Chaque patch de géométrie ne doit pas dépasser 10 000 sommets.
Compression KTX:optimisez les performances du GPU de votre fichier glb en vous assurant qu'il utilise des mipmaps et des textures ktx2.
Ce dont vous avez besoin pour optimiser votre IBL
Téléchargez l'utilitaire de ligne de commande cmgen:
Vous trouverez la dernière version dans le dépôt Filament.
Recherchez le fichier .tgz contenant la version précompilée de cmgen pour votre plate-forme, puis extrayez-le.
L'outil précompilé se trouve dans le répertoire /bin du fichier .tgz extrait.
Éléments à préparer pour générer le fichier .zip pour l'IBL:
Un fichier EXR basse résolution correspondant à la texture de votre skybox
Votre texture de ciel doit être un fichier EXR. Bien que cmgen soit compatible avec d'autres formats, les EXR sont recommandés, car ils fournissent les informations sur la plage dynamique élevée qui sont essentielles pour fournir une IBL de haute qualité.
L'utilisation d'autres formats, comme le PNG, entraîne un éclairage moins précis.
L'image source (EXR) doit avoir un format de 2:1 et des dimensions qui sont une puissance de 2. Utilisez un EXR de 1 024 x 512 pixels. Remarque: Il peut sembler que la résolution de 1 024 x 512 pixels soit trop faible, mais elle est bénéfique pour les performances. Pour l'IBL, les résultats visuels pour l'utilisateur sont très similaires aux éléments IBL de résolution beaucoup plus élevée.
Un fichier PNG noir uni
Cet élément doit également être au format 2:1. Utilisez une taille de 100 x 50 pixels.
Il s'agit d'une texture optimisée pour accompagner l'IBL. Les utilisateurs ne le verront pas, nous nous concentrons donc sur l'optimisation des performances de l'asset.
L'exemple suivant montre comment utiliser cmgen pour créer le fichier .zip de l'IBL.
Dans cet exemple, nous utilisons des fichiers d'entrée nommés my_360_skybox_1024_x_512.exr et black_skybox.png, et nous créons un fichier ZIP nommé 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..
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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 .."]]
