Android XR には、SceneCore API または Scene Viewer を使用してアプリにインタラクティブな 3D モデルを追加するためのさまざまなツールが用意されています。Compose for XR でビルドする場合は、ボリューム サブスペース コンポーザブルを使用して、3D モデルを UI に対して配置できます。
SceneCore API。回転、移動、スケーリングなど、独自のインタラクションを作成できます。これにより、ユーザーはアプリの空間パネルや環境とともに 3D モデルを操作できます。パネルと 3D モデルの間に親子関係を作成することもできます。SceneCore API について学習する。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-07-27 UTC。"],[],[],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."]]