Android XR SDK 现已推出开发者预览版。我们期望收到您的反馈!请访问我们的
支持页面 与我们联系。
会话级
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
Session
为应用提供空间化功能的主要接口。每个空间化 activity 都必须创建并保留 Session
的实例。创建后,应用可以使用 Session
接口创建空间化内容实体(例如面板或 3D 模型),以及设置空间环境 、识别用户位置 ,并将内容锚定 到现实世界。
注意 : 由于将会话与 activity 生命周期相关联的已知问题 ,在自动重新创建 activity 的各种情况下,会话都可能会失效。包括但不限于调整主面板大小、连接外围设备以及在浅色和深色主题之间切换。如果您遇到会话失效问题,则可能需要使主面板不可调整大小、使用动态面板实体、为特定配置更改 停用 activity 重新创建,或停用浅色或深色主题更改。
从 Jetpack Compose for XR 访问会话
使用 Jetpack Compose for XR 时,系统会为您创建会话,您可以使用 LocalSession.current
访问该会话。请参阅以下示例:
@Composable
fun ComposableUsingSession () {
val session = LocalSession . current
}
从 Jetpack SceneCore 访问会话
如果您要从 SceneCore 库创建空间化实体,则需要创建会话。
仅 Android XR 设备支持创建会话。尝试在不兼容的设备上创建会话将导致失败。如需创建时段,请将 activity 传递给 create
方法,如以下示例所示。
when ( val result = Session . create ( this )) {
is SessionCreateSuccess - > {
val xrSession = result . session
// ...
}
is SessionCreatePermissionsNotGranted - >
TODO ( /* The required permissions in result.permissions have not been granted. */ )
}
注意 :某些功能(例如手部跟踪 和平面跟踪 )需要额外的运行时权限,才能成功完成会话配置。
当会话的 activity 被销毁时,与该会话关联的所有空间界面和 3D 内容都会被销毁,并且该会话将失效。
另请参阅
本页面上的内容和代码示例受内容许可 部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-05-16。
[[["易于理解","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"]],["最后更新时间 (UTC):2025-05-16。"],[],[]]