工作階段

Session 為應用程式提供空間化功能的主要介面。每個空間化活動都必須建立並保留 Session 的例項。建立完成後，應用程式可以使用 Session 介面建立空間化內容實體，例如面板或 3D 模型，以及設定空間環境、識別使用者位置，以及將內容錨定至實際世界。

透過 Jetpack Compose for XR 存取工作階段

使用 Jetpack Compose for XR 時，系統會為您建立工作階段，並可使用 LocalSession.current 存取。請參閱以下範例：

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

從 Jetpack SceneCore 存取工作階段

如果您要透過 SceneCore 程式庫建立空間化實體，就必須建立工作階段。

您只能在 Android XR 裝置上建立工作階段。如果嘗試在相容性不佳的裝置上建立工作階段，結果會失敗。如要建立工作階段，請將活動傳遞至 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. */)
}
Session.kt

當工作階段的活動遭到刪除時，所有與該工作階段相關聯的空間 UI 和 3D 內容都會遭到刪除，且該工作階段將不再有效。

另請參閱