使用者可以將 3D 模型固定在現實世界中的特定位置。你可以選擇在一般水平或垂直表面,或地板或牆壁等特定表面上新增錨點。
Scene Viewer
Scene Viewer 可讓使用者查看及與 3D 模型互動。使用者可以開啟支援的 .glTF 3D 模型 (例如 .glb 檔案),並將物件放置在空間中。您可以在應用程式中整合 3D 檢視器,讓使用者輕鬆查看產品、探索教育內容,以及體驗 3D 模型。Scene Viewer 提供內建 UI,可用於基本互動,包括移動、旋轉、縮放和錨定。
發射位置
3D 模型會在使用者視線下方 1.5 公尺和 15 度處啟動,位於視野中心。開啟時,每個軸的縮小尺寸為 1.5 公尺。
互動內容
使用者可透過自然手勢移動、旋轉、固定和縮放 3D 模型的 UI 和互動功能。
互動選單
您可以透過其他動作自訂 3D 模型選單。如果 glTF 檔案包含不同大小 (例如建議大小和實際大小),使用者可以透過 1:1 按鈕快速切換大小。如要退出 3D 模型檢視畫面並返回應用程式,使用者可以點選強制關閉按鈕。
[null,null,["上次更新時間: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."]]