Jetpack XR SDK 包含为 Android XR 设备打造沉浸式体验和增强现实体验所需的所有工具和库。
打造完全沉浸式体验
面向专用高保真设备，例如扩展现实头戴设备和有线扩展现实眼镜。使用 Kotlin 和 Compose 等现代 Android 开发工具， 以及 Java 和 Views 等上一代工具。您可以 对界面进行空间化处理，加载和渲染 3D 模型，并从语义上 理解现实世界。
如果您已在 Android 上拥有移动应用或大屏应用，Jetpack XR SDK 可通过对现有布局进行空间化处理，并使用 3D 模型和沉浸式环境增强体验，将您的应用带入新的维度。如需了解有关对现有 Android 应用进行空间化处理的建议，请参阅我们的 质量指南。
打造增强现实体验和实用体验
面向轻巧时尚的无屏眼镜和带屏眼镜。使用现代 Android 开发工具，例如 Kotlin 和 Jetpack Compose Glimmer。使用有助于将手机上的应用体验投射到眼镜上的 API。
使用 Jetpack 库
Jetpack XR SDK 库提供了一个全面的工具包，用于打造 丰富、 沉浸式体验、轻巧增强现实体验以及 介于两者之间的所有体验。以下库是 Jetpack XR SDK 的一部分：
- Jetpack Compose for XR：以声明方式构建空间界面布局 利用 Android XR 的空间功能。
- Material Design for XR：使用适用于 XR 的 Material 组件和布局 进行构建。
- **Jetpack SceneCore**：使用 3D 内容构建和操控 Android XR 场景图。
- ARCore for Jetpack XR：借助感知功能将数字内容带入现实世界。
- Jetpack Compose Glimmer：一个用于构建增强现实 Android XR 体验的界面工具包，针对带屏眼镜进行了优化。
- **Jetpack Projected**：有助于将手机上的应用体验投射到无屏眼镜或带屏眼镜上的 API。
开发者预览版期间的 API 开发
Jetpack XR SDK 库是 Android XR 开发者预览版的一部分，这些 API 仍在开发中。如需了解已知问题，请参阅库版本说明：
- Jetpack Compose for XR 版本说明
- ARCore for Jetpack XR 版本说明
- Jetpack SceneCore 版本说明
- XR 运行时版本说明
- Jetpack Compose Glimmer 版本说明
- Jetpack Projected 版本说明
如果您遇到未列在其中任何列表中的问题，请报告 bug 或提交反馈。
Jetpack Compose for XR
适用的 XR 设备：扩展现实头戴设备、有线 XR 眼镜
借助 Jetpack Compose for XR，您可以使用熟悉的 Compose 概念（例如 行和 列）在 XR 中创建空间界面布局，无论您是 将现有 2D 应用移植到 XR，还是从头开始创建新的 XR 应用。
此库提供 子空间可组合项，例如 空间面板 和 轨道器，可让您将现有的 2D Compose 或基于视图的 界面放置在空间布局中。
如需详细指南，请参阅使用 Jetpack Compose for XR 开发界面。
Compose for XR 引入了 SceneCoreEntity 子空间可组合项，它
可让您 放置实体（例如 3D 模型），相对于您的界面。
了解如何对现有 Android 应用进行空间化处理，或查看 API 参考文档 以了解更多详细信息。
Material Design for XR
适用的 XR 设备：扩展现实头戴设备、有线 XR 眼镜
Material Design 提供适用于 XR 的组件和布局。如果您使用自适应布局进行构建。详细了解如何实现 Material Design for XR。
Jetpack SceneCore
适用的 XR 设备：扩展现实头戴设备、有线 XR 眼镜
借助 Jetpack SceneCore 库，您可以相对于彼此和环境放置和排列由 实体定义的 3D 内容。借助 SceneCore，您可以：
Jetpack SceneCore 库还支持对使用 Views 构建的应用进行空间化处理。如需了解详情，请参阅我们的视图使用指南。
查看 API 参考文档 以了解更多详细信息。
ARCore for Jetpack XR
适用的 XR 设备：扩展现实头戴设备、有线 XR 眼镜、无屏眼镜、带屏眼镜
ARCore for Jetpack XR 库受现有 ARCore 库的启发，提供了将数字内容与 现实世界融合的功能。此库包括动作追踪、持久锚点、命中测试和平面识别，并带有语义标签（例如地板、墙壁和桌面）。此库利用由 OpenXR 提供支持的底层感知堆栈 ，确保与各种 设备兼容，并有助于确保应用在未来也能正常运行。
如需了解更多详细信息，请参阅使用 ARCore for Jetpack XR。
Jetpack Compose Glimmer
适用的 XR 设备：带屏眼镜
Jetpack Compose Glimmer 是一个用于构建增强现实 Android XR 体验的界面工具包，针对带屏眼镜进行了优化。为全天佩戴的设备打造美观、简洁且舒适的界面。
- 专为一瞥即得和清晰易读而打造：与手机不同，主要 画布是光学透视显示屏，它是透明的。Jetpack Compose Glimmer 提供 眼镜专用主题、简化的调色板和排版，让您的内容清晰易读、处理速度快且绝不会分散注意力。
- 针对可穿戴设备专用互动进行了优化：我们针对用户使用眼镜的方式优化了 互动模型。Jetpack Compose Glimmer 组件具有清晰的焦点状态（例如优化的轮廓 而不是分散注意力的涟漪效果），并且可以处理常见的 物理输入，例如点按、在镜框上滑动，当然还有语音。
- 使用熟悉的声明性界面模式：由于 Jetpack Compose Glimmer 完全基于 Jetpack Compose 构建，因此您可以使用已了解的所有关于在 Android 中构建声明性界面的知识。我们提供了一整套 核心预构建的可组合函数，例如 Text、Icon、 Button 和 TitleChip 等专用组件，所有这些都针对眼镜环境进行了优化 。
Jetpack Projected
适用的 XR 设备：无屏眼镜、带屏眼镜
为音频眼镜和带屏眼镜构建应用时，您的应用会在配套的宿主设备（例如 Android 手机）上运行，该设备会投射您应用的 XR 体验。如果 Android 宿主设备具有 XR 投射功能，Jetpack Projected 可让这些设备与音频眼镜或带屏眼镜通信。
- 访问投射的设备硬件：与投射的 设备（无屏眼镜或带屏眼镜）关联的设备上下文。此 投射的上下文 提供对投射的设备硬件（例如摄像头）的访问权限。专门为在音频眼镜或带屏眼镜上显示而创建的专用 activity 已充当投射的上下文。如果应用的另一部分 （例如手机 activity 或服务）需要访问眼镜的 硬件，则可以获取投射的上下文。
- 简化权限请求：音频眼镜和带屏眼镜遵循 标准 Android 权限模型，其中包含眼镜专用 权限，必须在运行时请求这些权限，应用才能 访问设备硬件（例如摄像头）。权限帮助程序简化了手机和眼镜界面中的这些权限请求机制，以提供一致的请求体验。
- 检查设备和显示功能：检查投射的设备是否具有 显示屏以及显示屏的状态，以呈现视觉内容。根据设备的功能调整应用。例如，如果设备没有显示屏或显示屏处于关闭状态，您可能需要提供更多音频上下文。
- 访问应用摄像头操作：您的应用可以访问用户摄像头操作，例如在在线影音应用中开启或关闭摄像头。
OpenXR™ 和 OpenXR 徽标是 The Khronos Group Inc. 的商标，已在中国、欧盟、日本和英国注册为商标。