访问会话以创建空间化界面和实体

适用的 XR 设备
本指南可帮助您为这些类型的 XR 设备打造体验。
了解 XR 设备类型 →
XR 头戴设备
有线 XR 眼镜
了解 XR 设备类型 →

Session 为应用提供空间化功能的主要接口。每个空间化 Activity 都必须创建并持有 Session 的实例。应用创建会话后，可以使用 Session 接口创建空间化内容实体（例如面板或 3D 模型），还可以设置空间环境、识别用户位置以及将内容锚定到现实世界。

从 Jetpack Compose for XR 访问会话

使用 Jetpack Compose for XR 时，系统会为您创建会话，您可以使用 LocalSession.current 访问该会话。请参阅以下示例：

@Composable
fun ComposableUsingSession() {
    val session = LocalSession.current
}
Session.kt

从 Jetpack XR 运行时访问会话

如果您要使用 Jetpack SceneCore 库创建空间化实体，则需要创建会话。

如需创建会话，请将 activity 传递给 create() 方法，如以下示例所示：

when (val result = Session.create(this)) {
    is SessionCreateSuccess -> {
        val xrSession = result.session
        // ...
    }
    else ->
        TODO(/* A different unhandled exception was thrown. */)
}
Session.kt

当会话的 activity 被销毁时，与该会话关联的所有空间界面和 3D 内容都会被销毁，并且该会话不再有效。

另请参阅