用户可以将 3D 模型固定在现实世界中的特定位置。您可以选择将锚点添加到常规水平或垂直表面,也可以添加到地板或墙壁等特定表面。
Scene Viewer
借助场景查看器,用户可以查看 3D 模型并与之互动。用户可以打开受支持的 .glTF 3D 模型(例如 .glb 文件),并将对象放置在空间中。您可以在应用中集成 3D 查看器,让用户能够轻松直观地查看商品、探索教育内容和体验 3D 模型。Scene Viewer 提供了用于基本交互的内置界面,包括移动、旋转、缩放和锚定。
启动位置
3D 模型会在用户视线下方 1.5 米处、15 度角的视野中心启动。它们在展开时尺寸较小,每个轴为 1.5 米。
互动次数包括
界面和互动功能,让用户可以使用自然手势移动、旋转、固定和缩放 3D 模型。
互动菜单
您可以使用其他操作自定义 3D 模型菜单。如果 glTF 文件包含不同的尺寸(例如建议尺寸和实际尺寸),用户可以使用“1:1”按钮在它们之间快速切换。如需退出 3D 模型视图并返回应用,用户可以点击强制性关闭按钮。
[null,null,["最后更新时间 (UTC):2025-07-27。"],[],[],null,["# 3D model design\n\nIn Android XR, 3D models are digital objects rendered with depth and volume to\nadd a sense of realism and spatial understanding to your app. Users can\nnaturally interact with 3D models, creating a transformative and engaging\nexperience.\n| **Preview:** Currently, 3D models are only available in Full Space.\n\nAndroid XR supports 3D models with either a `.glTF` or `.glb` file extension.\n[GL Transmission Format (glTF)](https://www.khronos.org/glTF) is a standard 3D file format that\nminimizes asset size, loads fast, and is operable across platforms. You can\nexport these file formats from third-party digital content creation tools such\nas [Blender](https://www.blender.org/), [Maya](https://www.autodesk.com/products/maya), [Spline](https://spline.design/),\namong others.\n\nTo optimize performance, prioritize small file sizes. Avoid excessive polygon\ncounts or high-resolution textures that could impact rendering speed. \nAlas, your browser doesn't support HTML5 video. That's OK! You can still [download the video](/static/videos/design/ui/xr/3d-content-shark.mp4) and watch it with a video player.\n\nMethods to integrate 3D models\n------------------------------\n\nAndroid XR offers different tools to add interactive 3D models in your app: with\nSceneCore APIs or Scene Viewer. If you're building with Compose for XR, you can\nplace 3D models relative to your UI using the [volume subspace composable](/develop/xr/jetpack-xr-sdk/develop-ui#use-volume).\n\n- **SceneCore APIs** . You can create your own interactions including rotate, move, and scale. This allows users to interact with 3D models alongside your app's spatial panels and environment. You can also create parent relationships between panels and 3D models. [Learn about SceneCore APIs](/develop/xr/jetpack-xr-sdk/work-with-entities).\n- **Scene Viewer** can be used to load and display 3D models with interactions including rotate, move, and scale. However, Scene Viewer runs as a separate app. As a result, users won't be able to see your app's panels and environment while interacting with 3D models. [Learn about Scene Viewer](/develop/xr/jetpack-xr-sdk/add-3d-models#load-3d).\n\nSceneCore APIs\n--------------\n\nWith SceneCore APIs, you can develop rich interactions for 3D models while\nkeeping users in the context of your app. Since SceneCore lets you keep showing\npanels and environments alongside 3D models, you can create relationships\nbetween 3D models and panels, and use scene perception to anchor content to a\nuser's physical space.\n\nWith SceneCore, you can also add:\n\n- Annotations to the 3D models\n- Playback of [animations](/develop/xr/jetpack-xr-sdk/add-3d-models#animate-3d) embedded in 3D models\n- Multiple 3D models\n- A custom menu and launch positions\n\n### Relationships\n\n3D models can have parent relationships with panels or other 3D models, so that\nthe child element follows the parent's movement. \nAlas, your browser doesn't support HTML5 video. That's OK! You can still [download the video](/static/videos/design/ui/xr/3d-content-parent-child.mp4) and watch it with a video player.\n\n### Anchors\n\nUsers can fix 3D models to a specific point in the real world. You have the\noption to add anchors to general horizontal or vertical surfaces or specific\nsurfaces such as the floor or wall. \nAlas, your browser doesn't support HTML5 video. That's OK! You can still [download the video](/static/videos/design/ui/xr/3d-content-anchor.mp4) and watch it with a video player.\n\n### Scene Viewer\n\nScene Viewer allows users to see and interact with 3D models. Users can open\nsupported .glTF 3D models like a .glb file and place objects in space. You can\n[integrate the 3D viewer](/develop/xr/jetpack-xr-sdk/add-3d-models#load-3d) in your app to make it simple for users to\nvisualize products, explore educational content, and experience 3D models. Scene\nViewer provides built-in UI for basic interactions including moving, rotating,\nscaling, and anchoring. \nAlas, your browser doesn't support HTML5 video. That's OK! You can still [download the video](/static/videos/design/ui/xr/3d-content-spawn.mp4) and watch it with a video player.\n\n### Launch position\n\n3D models launch at 1.5 meters and 15 degrees below a user's line of sight, in\nthe center of their field of view. They open in the miniature size of 1.5 meters\nper axis.\n\n### Interactions Includes\n\nUI and interactions that allow users to move, rotate, anchor, and scale 3D\nmodels using natural gestures. \nAlas, your browser doesn't support HTML5 video. That's OK! You can still [download the video](/static/videos/design/ui/xr/3d-content-gestures.mp4) and watch it with a video player.\n\n### Interaction menu\n\nThe 3D model menu can be customized with additional actions. If the glTF file\ncontains different sizes such as a suggested size and an actual size, the 1:1\nbutton allows users to quickly switch between them. To exit the 3D model view\nand return to the app, users can click the mandatory close button."]]